TL;DR: SSO tenant migration approaches that use DNS redirection and existing SAML or OIDC parameters can move tenants without customer-side reconfiguration, which reduces coordination overhead during provider changes, according to Descope. The operational lesson is that tenant portability is a governance problem as much as an engineering one, especially where identity workflows span multiple organisations.
At a glance
What this is: This is an SSO migration guide showing how tenant cutover can happen without customer reconfiguration by using DNS redirection, preserved SAML or OIDC settings, and proxy handling.
Why it matters: It matters because IAM teams need migration patterns that reduce tenant-by-tenant coordination, preserve authentication continuity, and avoid breaking customer SSO during provider changes.
Context
SSO tenant migration becomes difficult when each tenant is tied to its own service provider and customer-managed configuration. In practice, the problem is not just authentication continuity but preserving the tenant-specific SAML or OIDC relationships that many IAM programmes treat as fixed once deployed.
This article argues that a DNS redirection layer can preserve those relationships while shifting the service provider behind the scenes. For IAM teams, that changes migration from a customer-by-customer reconfiguration exercise into a controlled cutover problem with clearer ownership and less tenant disruption.
Key questions
Q: What breaks when SSO tenant migration still depends on customer reconfiguration?
A: The migration becomes a coordination exercise instead of a controlled cutover. Each tenant has to update its own SAML or OIDC settings, which increases delay, raises the chance of mismatch, and makes the provider change harder to complete consistently across customers.
Q: Why do DNS redirects help during SSO tenant migration?
A: They preserve the existing identity contract while changing where the response is processed. That lets the new service provider receive the same ACS traffic and protocol parameters the tenant already trusts, so the customer does not need to reconfigure their side of the federation.
A: Teams should bind each SCIM connection to a specific customer context and derive tenant scope from the authenticated connection, not from an untrusted request field. They should validate schemas, normalize identifiers, keep group to role mapping explicit, and separate disabling access from deleting identities. The goal is to make provisioning safe, repeatable, and confined to the correct tenant.
Q: How do IAM teams reduce risk during tenant cutover?
A: They should validate redirect behaviour, tenant mapping, and rollback before broad rollout, then migrate a small internal or customer subset first. That approach limits the blast radius if routing, metadata, or provisioning assumptions are wrong.
Technical breakdown
How DNS redirection preserves the SSO exchange
The migration pattern keeps the existing IdP and SP relationship intact while redirecting the ACS response path to a new backend. The user starts an SSO flow, the IdP authenticates as usual, and the response is routed back through the previously configured ACS URL before DNS sends it to the new service. That means the migration depends on preserving the original protocol contract rather than rebuilding tenant trust from scratch. For SAML, the SP entity ID, ACS URL, and IdP metadata remain the key anchors. For OIDC, the equivalent parameters must continue to match exactly.
Practical implication: Treat the ACS path and tenant metadata as migration-critical dependencies, not disposable implementation details.
Why SCIM proxying matters during tenant cutover
When an IdP provisions users through SCIM, authentication cutover alone is not enough. The guide shows SCIM requests can be proxied through the same DNS redirect layer so user lifecycle traffic follows the tenant migration alongside SSO. That matters because provisioning mismatches can create gaps between who can sign in and who is actually managed in the target tenant. A clean migration therefore has to account for both authentication and provisioning paths, especially when tenant mappings, tokens, and per-project configuration are involved.
Practical implication: Validate SCIM routing and tenant mappings in the same change window as SSO so identity state does not split across systems.
What changes when migration becomes a routing problem
The technical shift is from reconfiguration at the customer edge to request handling at the provider edge. Cloudflare Workers or AWS Lambda can intercept the old auth hostname, rewrite traffic, and forward it to the new platform while preserving the expected parameters. That moves the operational burden from external tenant admins to the team controlling DNS and proxy logic. It also introduces new failure points, such as route scope, log-only validation, cookie-based branching, and rollback behaviour. The mechanism is less about federation theory than about safely preserving state across an indirection layer.
Practical implication: Test routing, rollback, and tenant scope before cutover so the proxy layer does not become a hidden outage point.
NHI Mgmt Group analysis
SSO tenant migration is an identity governance problem, not just a cutover task. The article shows that the hardest part is preserving tenant-specific trust relationships while moving the service provider behind the scenes. That puts ownership, configuration continuity, and customer coordination at the centre of the migration, not the UI or authentication prompt. The practitioner implication is that migration planning belongs in IAM governance, not only platform engineering.
Tenant portability is the real control objective. The guide demonstrates that DNS redirection and preserved protocol parameters can decouple tenant migration from per-customer reconfiguration. That is a useful pattern because it reduces dependency on stretched customer IT teams and lowers the operational friction of provider change. The practitioner implication is to treat portability as a lifecycle requirement for federated identity estates.
SCIM and SSO must be migrated as one identity path. Authentication can succeed while provisioning remains fragmented if SCIM is left behind or routed differently. That creates a split-brain identity state where sign-in continuity no longer guarantees identity governance continuity. The practitioner implication is to align authentication, provisioning, and tenant mapping in the same migration design.
DNS redirection shifts risk from tenant admins to routing integrity. The control plane changes, but the trust requirement does not disappear. Instead, teams inherit new operational dependencies around redirect scope, cookie handling, validation mode, and rollback behaviour. The practitioner implication is to govern the proxy layer with the same discipline used for any other identity ingress path.
Ephemeral routing does not remove identity accountability. The migration works because the existing SAML or OIDC contract remains recognisable long enough for the new backend to assume the SP role. That creates a temporary abstraction layer, but accountability for the cutover still sits with the team managing the redirect, the tenant configuration, and the provisioning path. The practitioner implication is to document ownership before the redirect goes live.
From our research library:
- AI-related credential leaks surged 81.5% year-over-year in 2025, with the surrounding AI infrastructure leaking 5x faster than core LLM providers, according to the State of Secrets Sprawl 2026.
- Across one million observed logins, 1 in 4 were password-based rather than SSO, 2 in 5 were not protected by MFA and 1 in 5 used a weak, breached or reused password.
- Read next: AI Agent Identity Security Buyer's Guide
What this signals
Tenant migration should be treated as a governance change, not only an integration change. When a provider switch can happen without customer reconfiguration, the decisive question becomes whether ownership, rollback, and lifecycle visibility are documented well enough to keep authentication and provisioning aligned.
Tenant portability: identity programmes that can move SSO tenants without forcing every customer to reconfigure their side are less brittle, but only if the redirect layer, SCIM path, and rollback process are governed as a single operational control plane.
For IAM teams, the practical signal is that federation design now has to include migration readiness. The more tenants and protocols you support, the more important it becomes to know which values must stay stable, which paths can be proxied, and who owns the change when something goes wrong.
For practitioners
- Map every tenant-specific SSO dependency Inventory the ACS URL, SP entity ID, IdP metadata, tenant domains, and any SCIM touchpoints before attempting migration so you know which values must remain stable.
- Validate routing in log-only mode first Use the worker or proxy log-only option to confirm rewrites, hostnames, and tenant mappings before sending live authentication traffic through the new path.
- Migrate SCIM and SSO together Treat provisioning and sign-in as one lifecycle change by testing SCIM proxying, tenant token handling, and user creation before expanding tenant cutover.
- Keep rollback ownership explicit Document who can disable the redirect, restore the legacy route, and verify the fallback state so tenant migration can be reversed without guessing.
Key takeaways
- The article shows that SSO migration can be executed without customer-side reconfiguration when DNS redirection preserves the expected federation parameters.
- The main operational risk is not the login prompt itself but the possibility of splitting authentication, provisioning, and tenant ownership across different paths.
- IAM teams should design tenant portability and rollback into the migration plan so provider changes do not become customer coordination problems.
Standards & Framework Alignment
This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.
OWASP Non-Human Identity Top 10 addresses the attack and risk surface, while NIST CSF 2.0, NIST SP 800-63 and CIS Controls v8 set the governance and control requirements practitioners need to meet.
| Framework | Control / Reference | Relevance |
|---|---|---|
| NIST CSF 2.0 | PR.AA-05 — Access Permissions, Entitlements and Authorizations | Tenant migration depends on preserving and reapplying federation authorizations cleanly. |
| Recommendation — Map tenant cutover changes to PR.AA-05 so authorisation state stays consistent across migration paths. | ||
| NIST SP 800-63 | SP 800-63C — Federation | The article centres on preserving SAML and OIDC federation relationships during tenant migration. |
| Recommendation — Use SP 800-63C to govern federation continuity when moving tenants between identity providers. | ||
| OWASP Non-Human Identity Top 10 | NHI-01 — Improper Offboarding | Tenant migration and cutover require clean decommissioning of the legacy provider path. |
| Recommendation — Apply NHI-01 to ensure legacy tenant routes, tokens, and provisioning paths are retired after cutover. | ||
| CIS Controls v8 | CIS-5 — Account Management | The guide covers tenant and user lifecycle handling through SCIM and SSO transition. |
| Recommendation — Use CIS-5 to keep tenant account mappings and lifecycle changes aligned during migration. | ||
Key terms
- SSO Tenant: A tenant is the customer-specific identity boundary inside a federated SSO deployment. It usually carries its own domains, configuration, and trust relationships, so migration has to preserve tenant state rather than treating all customers as interchangeable.
- ACS URL: An Assertion Consumer Service URL is the endpoint where a service provider receives the SAML response after authentication succeeds. It must match the application configuration exactly, because the identity provider posts the assertion to that location and the application uses it to complete the sign in flow.
- SCIM Proxying: Forwarding SCIM provisioning requests through an intermediate routing layer so user lifecycle updates continue while systems are being migrated. It is useful when sign-in can move first, but it still requires careful validation so provisioning state does not drift from authentication state.
- Federation Continuity: Federation continuity is the ability to move identity infrastructure without breaking the trust contract already established with external identity providers. It matters because the protocol relationship must remain stable even when the underlying service provider changes.
Deepen your knowledge
NHI governance, agentic AI identity, and machine identity lifecycle are core topics in our NHI Foundation Level course, the industry's only accredited NHI security programme. If you are responsible for identity security strategy or NHI governance in your organisation, it is worth exploring.
Published by the NHIMG editorial team on July 5, 2026.
Updated on October 6, 2026.
NHI Mgmt Group, the independent authority on Non-Human Identity, IAM, and Agentic AI security. nhimg.org