Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Endpoints

OAuth2 / OIDC

EndpointDescription
GET /.well-known/openid-configurationOIDC Discovery
GET /.well-known/jwks.jsonJSON Web Key Set
GET/POST /authorizeAuthorization endpoint (login page)
POST /tokenToken endpoint
GET/POST /userinfoUserInfo endpoint
POST /introspectToken Introspection (RFC 7662)
POST /revokeToken Revocation (RFC 7009)
GET/POST /logoutOIDC End Session / Logout (alias: /end_session)
GET /ui/logoutDashboard session logout (the web UI's Logout button)
POST /device_authorizationDevice Authorization (RFC 8628; alias: /device/code)
GET/POST /deviceDevice verification page

curl examples for every grant are in Requesting tokens.

The standard OIDC profile / email claims (email, email_verified, preferred_username, ...) are served from GET /userinfo, not embedded in the tokens - see Tokens and claims.

SAML

EndpointDescription
GET /saml/metadataIdP Metadata
GET /saml/cert.pemIdP signing certificate (PEM)
GET/POST /saml/ssoSingle Sign-On (supports both HTTP-POST and HTTP-Redirect bindings)
POST /saml/attribute-queryAttribute Query

Bindings, strict-binding mode, response signing, and canonicalization are covered in SAML options.

REST API

EndpointDescription
GET /api/healthHealth check
GET /api/usersList users
GET /api/users/{username}Get user details
POST /api/users/{username}/tokenGenerate token
GET /api/auditGet audit log
GET /api/audit/statsAudit log statistics
POST /api/audit/clearClear the audit log
GET /api/configGet current configuration
POST /api/config/reloadReload configuration
POST /api/keys/rotateRotate cryptographic keys
GET /api/keys/infoGet key information