Skip to main content

Test and Live Instances

Every project has separate Test and Live Instances. They are independent trust boundaries, not labels on the same user directory.

BoundaryTestLive
PurposeDevelopment and automated testingReal production traffic
CredentialsTest Client IDs and secretsLive Client IDs and secrets
UsersTest-only identitiesReal end users
Managed test usersAvailableNever available
Callback URLsLocal and test deploymentsProduction HTTPS URLs
Providers and emailTest configurationProduction configuration

What is not copied automatically

Creating or updating Test configuration does not promote applications, credentials, users, provider secrets, email settings, or sessions to Live. Configure Live deliberately after validating the full Test flow.

Never copy a Test Client ID into a production deployment. Credential prefixes help humans notice mistakes, but applications must still load the correct secret for their deployment.

  1. Create the application in Test.
  2. Register the local callback and post-logout URLs.
  3. Configure authentication and create managed test users.
  4. Verify sign-in, callback validation, session creation, refresh, revocation, and logout.
  5. Exercise error states and waitlist behavior.
  6. Create or configure the matching application in Live.
  7. Register only production URLs.
  8. Configure production email and external providers.
  9. Deploy Live credentials through the application's secret manager.
  10. Run a controlled Live smoke test with a real identity.

Data and support safety

Do not use real customer identity documents, provider credentials, or personal production data in Test. Do not copy Live users into Test to reproduce a bug. Use managed test users and sanitized diagnostic information.

When contacting support, provide the public Instance ID, application ID, request time, and correlation ID when available. Do not send passwords, OTPs, authorization codes, tokens, Client Secrets, or raw identity documents.

Continue with the production launch checklist.