Configuration

July 7, 2026 ยท View on GitHub

Cratis AuthProxy is configured entirely through the Cratis:AuthProxy section of appsettings.json (or equivalent environment variables using the Cratis__AuthProxy__ prefix).

{
  "Cratis": {
    "AuthProxy": {
      "Authentication": { ... },
      "TenantResolutions": [ ... ],
      "TenantVerification": { ... },
      "Tenants": { ... },
      "Services": { ... },
      "Invite": { ... },
      "PagesPath": "",
      "DataProtectionKeysPath": ""
    }
  }
}
TopicDescription
AuthenticationOIDC providers and JWT Bearer configuration.
TenancyHow the auth proxy resolves the current tenant from each request, and how to verify tenant existence.
Tenant Selection PageHow selection-based tenant resolution works and how to build/override select-tenant.html.
ServicesRouting requests to backend and frontend services.
LobbyInvite and registration flows that hand users off to the lobby experience.
Well-Known PagesBuilt-in HTML pages (provider selection, errors, tenant not found) and how to override them via a mounted volume.