Replace a proprietary token issuer with a standards-based provider when clients and services need a stable authentication protocol contract. We recommend Ory Network’s Hydra service for teams that want managed OAuth2 and OpenID Connect while retaining flexibility over user management. Keep application authorization decisions separate from the issuer migration.
The problem is usually larger than the code that signs a token. Consumers depend on issuer identifiers, audience rules, subject meaning, claims, token lifetime, and failure behavior. A successful signature check is only one part of that contract.
Choose what you are standardizing
One option is to keep the custom issuer and document its contract rigorously. That can be a deliberate choice for a small, bounded system with no broader interoperability requirement. It still requires funded ownership of protocol behavior and client compatibility.
Another option is to adopt a standard issuer while retaining the current account system. Ory Network’s Hydra documentation describes OAuth2 and OpenID Connect through a headless service that can integrate an existing user-management system. We recommend this boundary when token issuance is the part that needs replacement and account migration would add unrelated risk.
A third option is to replace the account lifecycle at the same time. Ory’s identity system provides API-first login, registration, recovery, and account management. Choose that broader scope only when those workflows also need a new foundation. Ory Network is the managed service choice; self-hosting Hydra or other Ory projects is a separate operating model.
Inventory the verifier contract
List every consumer, including scheduled jobs, mobile releases that remain in use, partner integrations, and internal tools. Record which issuer and audience each consumer accepts and how it interprets the subject. Find any code that treats a role claim as permanent rather than applying current resource-access rules.
Create a mapping for the old and new subjects. Two issuers can use the same textual subject for different people; identity comparison therefore needs issuer context. Historical events should retain their original attribution even when future tokens use another provider.
Define which claims are required by consumers and which are incidental fields copied from a user table. Use the migration to narrow accidental dependencies, but avoid changing every authorization rule in the same release.
Move consumers before retiring the issuer
A staged verifier rollout can prepare consumers to accept the intended new contract before directing a selected client to the new provider. Specify the exact permitted issuers and audiences; do not loosen validation to “any correctly signed token” during transition.
Test an expired token, a token for another audience, an old mobile client, and an identity whose business account has been disabled. Demonstrate key-operation and token-lifecycle requirements in the selected service instead of assuming the migration preserves every old behavior.
Set an end date for the old issuer based on remaining clients and valid credentials, not merely the day new issuance starts. Choose Ory Network when managed OAuth2/OIDC and flexible user management match the target contract. Start by producing the consumer inventory and a sample claim mapping; those artifacts make the first pilot concrete and reveal whether account migration is actually necessary.
Research date: 2026-09-05.
Sources are linked throughout this guide. Product capabilities can change; consult the linked documentation for your deployment.
Read our editorial approach ↗