auth-keycloak

Introspect Endpoint

RFC 7662 token introspection.

The hosted MCP gateway calls this to validate a caller's bearer token: we sign tokens HS256 (symmetric), so there is no JWKS for the gateway to verify against — it asks us instead. The gateway authenticates as a confidential client (client_secret_basic); we then decode the token and return its claims.

Per RFC 7662 an inactive/invalid token is a normal 200 {"active": false} — only a CALLER authentication failure is a non-200 (401), and an unconfigured env is 503.

post/realms/public/protocol/openid-connect/token/introspect

Headers

authorizationstring nullable

Response

Successful Response

{"stackTrail":"paths:/realms/public/protocol/openid-connect/token/introspect:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.