Skip to content
Version v3.0.3

Front-Channel Logout

Front-channel logout lets ProAuth notify relying party applications through the user's browser when a ProAuth browser session ends. ProAuth renders hidden iframes for client applications that participated in the same OP session and have a front-channel logout URI configured.

Configure the client application with:

SettingDescription
frontchannel_logout_uriAbsolute HTTP(S) endpoint loaded by the browser in a hidden iframe. The URI must not contain a fragment.
frontchannel_logout_session_requiredWhen enabled, ProAuth includes the client only when a sid is available. New interactive OIDC sessions include a sid.

Logout Request

For every active client application with frontchannel_logout_uri, ProAuth appends these query parameters:

ParameterDescription
issThe ProAuth issuer for the tenant.
sidThe OP session identifier from the ID token.

Existing query parameters on the configured URI are preserved. If the configured URI already contains iss or sid, ProAuth replaces those values with the authoritative logout values.

Front-Channel vs Back-Channel Logout

Front-channel logout is widely supported and works well for browser-based clients that already handle iframe logout notifications. It depends on the browser loading the client endpoint, so browser tracking protections and third-party cookie restrictions can make it less reliable.

Back-channel logout sends a signed logout_token directly from ProAuth to the client application's server endpoint. Prefer back-channel logout for confidential server-side applications and enterprise single sign-out where delivery reliability matters.

Both mechanisms can be configured on the same client application. When both are configured, ProAuth renders the front-channel iframe and also sends the back-channel logout notification for the same active session.

RP-Initiated Logout

Front-channel logout is triggered during normal RP-Initiated Logout through the ProAuth end-session endpoint. When post_logout_redirect_uri is supplied, ProAuth first renders the hidden iframes and then redirects the browser to the validated post-logout redirect URI, preserving the state parameter.