Documentation

Integrate apps with tenant-scoped OIDC.

OpenIssuer exposes a standard OAuth2 and OpenID Connect issuer per tenant host. Applications use normal OIDC client settings while OpenIssuer handles tenant resolution, users, roles, organizations, and OAuth client management.

NextAuth callback format

Register the callback URL that matches the app host, base path, and provider id.

https://your-app.example.com/api/auth/callback/myauth

Demo tenant

Issuer URL for the public OpenIssuer demo and OAuth clients.

https://demo.openissuer.com/issuer

Demo admin

Admin portal for creating and inspecting demo OAuth clients.

https://demo.admin.openissuer.com

Scopes

The demo client requests the standard OpenID Connect scopes.

openid profile

Integration flow

  1. Choose the tenant issuer URL for the customer or environment.
  2. Register an OAuth client in that tenant admin portal.
  3. Add the application callback URL to the client registration.
  4. Configure the app with issuer, client id, client secret, and scopes.
  5. Start the authorization code flow with openid and profile scopes.

NextAuth quickstart

Use the maintained example client to validate an OpenIssuer tenant from OAuth client registration through token and session inspection.

  1. Create an OAuth client in the tenant admin portal.
  2. Register the callback URL ending in /api/auth/callback/myauth.
  3. Configure the issuer, client id, client secret, and NextAuth secret.
  4. Deploy the app and verify the issuer and tenant claims in the session.

Admin portals

Tenant admins use the admin portal to manage OAuth clients, users, organizations, roles, and default organization access.

Deployment model

OpenIssuer is deployed as Spring services behind Kubernetes Gateway API routes, with PostgreSQL databases and tenant-aware routing. Demo apps are deployed as separate NextAuth releases for each tenant host.