Skip to main content
Version: v0.25.0 (Latest)

Configure the authorization server

The authorization server grants every token outside the anonymous public surface. This journey reads the servers provisioning created, adds or corrects a hosted server, and registers the confidential client that tenant automation uses.

Complete first: Onboard a tenant.

Steps and why they come in this order​

StepWhy here
1. Review the tenant authorization serversProvisioning already created the default server. Read it before creating another so you know which UUID clients and issuers should use.
2. Create and activate a hosted serverClients and issuer bindings can only reference an active server, so creation and activation come before both.
3. Register clientsThe confidential tenant client is what every later journey authenticates with, and wallet clients need exact redirects and PKCE.
4. Tune token and grant settingsToken lifetimes and grant policy only matter once clients exist, and the issuer relies on them for wallet grants.

What an authorization server is not​

An authorization server is not the credential issuer. The issuer later binds an authorization server by UUID through an explicit binding, covered in Set up the credential issuer. Configure and activate the server first, then bind it.

Resource typeUse it whenLifecycle
HostedThe tenant operates the authorization and token endpointsCreate, configure, validate, activate, register clients
ExternalThe tenant delegates to an existing upstream serverCreate from discovery, validate, activate, refresh when it changes
Federation bindingA hosted server sends user authentication upstreamCreate disabled, validate, enable; see the Keycloak journey

Deeper reference​

Authorization-server configuration explains every option, the Admin Console screens (surface=as) and the Postman correlation.

Next journey​

Continue with Federate wallet sign-in to Keycloak.