← All docs

SailPoint ISC Greenfield Implementation Field Guide

SailPoint ISC Greenfield Implementation Field Guide

This guide is the document I wished existed on day one of a greenfield SailPoint Identity Security Cloud (ISC, formerly IdentityNow) program. It is written from a real enterprise rollout: a global professional-services firm with roughly 13,000 people, a legacy identity manager being retired, an HR system as the single authoritative source, and a plan to bring well over a hundred applications under governance in two phases.

It is not a tour of the product. SailPoint's own documentation does that. This guide covers what the documentation does not: the decisions you will be forced to make, the places the platform fails silently, the limits you only find by hitting them, and the workaround that finally worked.

The operating model at a glanceHR data flows through aggregation, the identity profile and rules to a lifecycle state; events start the joiner, mover, leaver, request and certification processes, which reach targets through appliance clusters.FOUNDATIONHR systemauthoritativeAggregate andcorrelatehourly,attribute matchIdentityprofilemappings andtransformsCloud rulesstate, dates,namesLifecyclestatepre joiner toinactiveEvent busattributechanged,post-provisioning,form, cronPROCESSES, EACH A SET OF WORKFLOWSJoiner and rehireaccounts, mails, ITformMoverlocation and jobchangesLeaverdisable, notify,recover assetsAccess requestprofiles, forms,approvalsCertificationcampaigns,source-owner reviewsREACHVirtual appliance clustersHR clusterDirectory clustersApplication clusterApplication clusterTargetsdirectories, REST applications, SQL databases, SaaS finance and workflow products, an ITSM mailbox, and flat files forreview-only applications
One model, five processes. Redrawn from the tenant's own overview: everything downstream depends on the HR feed and on the rules that compute the lifecycle state.

How to use this guide

Read the Rules that would have saved us weeks below once, then jump to the page for whatever phase you are in. Every page ends in concrete actions, and the last pages collect checklists, a limits table and a symptom lookup so the guide works as a reference during build and support.

If you are...Start here
Scoping or staffing the programProgram Setup, Scope and Governance
Designing the platformPlatform Architecture, VAs and Networking
Connecting the HR systemThe HR Authoritative Source and Identity Model
Automating joiner, mover, leaverLifecycle States and Joiner Mover Leaver Automation, then Active Directory and Mailbox Provisioning
Integrating applicationsChoosing and Building Application Connectors, then Web Services and JDBC Connector Field Notes
Designing what people can requestAccess Model, Request Center and Approvals, then Forms, Launchers and Workflows
Running access reviewsAccess Reviews and Campaigns at Scale
Preparing for go-liveTesting, Migration and Go-Live
Operating the platformHypercare, Operations and Handover
Looking for a specific limit or errorLimits, Caveats and Workarounds Reference, API Recipes and Symptom Lookup
Building a hard application (dependent entitlements, form data into a rule)Complex Applications: Cascading Entitlements and Form-to-Rule Data
Writing rulesCloud Rule and Connector Rule Templates and Snippets
Standing up infrastructureSetting Up an SFTP Server for Flat-File Sources, Setting Up Virtual Appliances and Clusters
A connectivity problemNetwork Problems and How to Resolve Them
Needing a snippet for a workflow, a search or an API callWorkflow, Form and API Snippets
Planning for the implementation team to leaveImplementation Team Offboarding and Ownership Risk

The program in numbers

All figures are rounded and the client is deliberately not named. They are here so you can calibrate the scale of what follows.

ItemScale
Workforce in scopeabout 13,000 people, contractors included
Identities in the tenantabout 43,000, because the HR feed carried years of historical leavers
Tenants2 (sandbox and production), same cloud region
Phase 1an HR source, three Active Directory domains and about ten crown-jewel applications
Phase 2 target120 to 135 further applications over five to six quarters
Sources at the end146, of which roughly 120 were flat-file sources, mostly feeding access reviews for applications with no live connector
Virtual appliance clusters5 clusters, 9 appliances
Access profiles / rolesabout 3,300 / about 280
Campaigns / templatesabout 500 / about 520
Workflows28, of which 21 enabled
Connector rules / cloud rules41 / 13
Elapsed timeabout 9 months from tenant creation to production cutover, close to 6 months from approved design to cutover

Rules that would have saved us weeks

These are the lessons that cost the most when we learned them late. Each is expanded on its own page.

  1. The HR feed is the product. Every automation downstream is only as good as the authoritative data. Budget real time for data quality, mandatory-field enforcement and an HR change process before you build a single workflow.
  2. Pick one immutable join key and never key on anything else. An employee ID that is never reused, even across rehires, is worth more than any clever correlation rule. Names, emails and login names all change.
  3. Provisioning logic lives in rules, not in source configuration. On a Web Services or JDBC source the endpoint or SQL fields can be empty or dead while a connector rule does all the real work. Review and document rules as first-class deliverables.
  4. The dangerous failures are the quiet ones. A status comparison that stops matching makes every account look enabled. A page-size ceiling silently drops accounts. A swallowed exception sends a request with blank fields. Design monitors for counts and freshness, not just for errors.
  5. Set the delete threshold deliberately on every source, and verify it. It is the only thing between an empty API response and a mass account deletion.
  6. Every source needs an aggregation schedule. Two production sources ran for months with none, so reviews and reports showed a stale view that nobody noticed.
  7. Aggregate groups before accounts. Entitlement objects should exist before accounts reference them.
  8. Lifecycle actions target an explicit list of sources. Adding a source later does not add it to your leaver disable action. Make "update the lifecycle state source list" a line in your onboarding checklist.
  9. Forms cannot cascade the way you expect. Dependent dropdowns driven by a search over entitlement attributes do not work. Plan the request experience around this, not against it.
  10. The workflow engine has sharp edges. Secrets can only be created in the UI, an unresolved template path renders as literal text, tier limits count loop bodies, and some approval actions are not licensed. Read the workflow limits before designing a flow.
  11. Entitlement value formats are contracts. If a rule parses an identifier out of an entitlement name, changing that format detaches every grant. Treat it like a public API.
  12. Never put credentials, or a debug webhook, in a production rule. Both ended up in ours. One makes provisioning fail whenever a diagnostic listener is down.
  13. Revocation approval is a decision, not a default. Granting needed manager approval while revoking needed none, on thousands of profiles. Decide that on purpose.
  14. Concentrated ownership becomes an outage. Thousands of access profiles owned by one person route every review and escalation through them. Use governance groups.
  15. Automate campaign creation, then verify it. Hundreds of campaigns by hand is not credible. A script that creates them staged and compares them to the source data caught real discrepancies before launch.
  16. Plan notifications and ITSM routing as carefully as provisioning. Most hypercare tickets were about who did or did not receive an email, not about accounts.
  17. Switch attribute sync on a couple of attributes at a time. A staged switch-on with validation between steps is the cheapest rollback you will ever get.
  18. Hand over with a documentation pack per integration. Five files per application (reference, tenant context, edge cases, runbook, config evidence) made knowledge transfer routine.

Conventions used in this guide

  • Most pages end with a section titled "What SailPoint's documentation adds". Those sections were checked against SailPoint's public documentation and community in October 2026 and link to their sources.
  • Observed means it happened on the program. Anything described as a platform limit was measured on a 2026 tenant. SailPoint changes ISC continuously, so re-check a limit before you design around it, especially anything tied to licensing or release level.
  • Names of internal applications, hosts, accounts, people and identifiers are removed. Commercial products such as Sage People, OneStream, Enate, Dynamics 365 and BMC Helix are named where the integration pattern matters.
  • Code samples are trimmed and generalised. They show the shape of a solution, not a drop-in implementation.
  • Dates are expressed as durations. The shape of the timeline matters more than the calendar.

The platform terms you will see throughout: VA is the virtual appliance that sits in your network and talks to your applications. A cluster is a group of VAs. Aggregation is reading accounts or groups from a source into ISC. Correlation is matching an account to an identity. A connector rule runs on the VA around a connector operation; a cloud rule runs inside ISC and has no network access. An entitlement is a single permission on a source, an access profile bundles entitlements for requesting, and a role bundles access profiles or assigns them by criteria.

  • SailPoint ISC vs IIQ for the product-level comparison.
  • AI in IAM for where AI fits into an ISC implementation, including why cloud rules cannot call out to a model.