Implement OIDC back-channel logout

domain: openid.net · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Register a backchannel_logout_uri on your relying party client registration; this must be an HTTPS URL that Cognito, Okta, or another OP can reach directly from its backend.
  2. Advertise back-channel logout support in your RP's metadata and confirm the OP supports it by checking the backchannel_logout_supported and backchannel_logout_session_supported claims in the OP's discovery document.
  3. When your endpoint receives a POST from the OP, extract the logout_token from the request body (application/x-www-form-urlencoded), verify its signature using the OP's JWKS, and validate the required claims: iss, aud, iat, jti, and the events claim containing http://schemas.openid.net/event/backchannel-logout.
  4. Confirm the logout_token does not contain a nonce claim (its presence makes the token invalid per the spec) and that jti has not been seen before within the token's validity window.
  5. Using the sub or sid claim from the logout token, invalidate all sessions for that user or that specific session in your application.
  6. Return HTTP 200 (or 204) synchronously once session invalidation is complete; return 400 if the token is invalid; the OP may retry on non-2xx responses.

Known gotchas

Related routes

Implement OIDC session management with refresh token rotation and silent renew in a single-page application
openid.net · 6 steps · unrated
Implement LTI 1.3 OIDC third-party-initiated login (the initiation step before the id_token launch)
imsglobal.org · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans