manual-oidc-logout-id-token

Persist ID tokens and populate id_token_hint during OIDC logout redirects.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill manual-oidc-logout-id-token
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manual-oidc-logout-id-token
Source: https://github.com/jonnymuir/Umbraco.Prism/tree/main/.claude/skills/manual-oidc-logout-id-token
Command: npx skills add https://github.com/jonnymuir/Umbraco.Prism --skill manual-oidc-logout-id-token

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves RP-initiated logout failures in OIDC authentication flows where the application manually handles code exchange, preventing the provider from receiving the required id_token_hint.

Core Features & Use Cases

  • Token Persistence: Ensures the id_token is stored alongside access and refresh tokens during manual code redemption.
  • Logout Hint Backfilling: Automatically populates the id_token_hint during the sign-out redirect process if it is missing.
  • Use Case: When using custom OIDC implementations like Keycloak with Umbraco Prism, this ensures that logging out of the application successfully terminates the session at the identity provider level.

Quick Start

Configure your authentication properties to include the id_token in the stored token set and ensure the sign-out callback URI is registered with your OIDC provider.

Frequently Asked Questions about manual-oidc-logout-id-token

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does RP-initiated OIDC logout fail when I manually handle code exchange?

Storing the id_token alongside access and refresh tokens during manual code redemption ensures the id_token_hint is available for RP-initiated logout. This allows the identity provider to successfully identify and terminate the correct user session.

How do I persist the ID token for OIDC logout in custom authentication flows?

Persist the ID token by configuring your authentication properties to include the id_token in the stored token set within authentication cookies during manual code redemption. This ensures the token is accessible for backfilling the id_token_hint during sign-out redirects.

Does this approach to fixing OIDC logout work with Keycloak and Umbraco Prism?

Yes, this approach to fixing OIDC logout works with Keycloak and Umbraco Prism. It specifically addresses session termination issues in custom OIDC integrations where default framework token handling is bypassed during manual authentication flows.

What is the id_token_hint used for in OIDC sign-out redirects?

The id_token_hint in OIDC sign-out redirects is used by the identity provider to identify the user session that needs to be terminated. It is automatically backfilled during the sign-out redirect process if the id_token was properly persisted.

Do I need to register a sign-out callback URI with my OIDC provider to terminate sessions?

Yes, you must register the sign-out callback URI with your OIDC provider to ensure that logging out of the application successfully terminates the session at the identity provider level and redirects the user correctly after logout.