OIDCを使用したHybrid Flow

Welcome to the Hybrid Flow! This OIDC flow is a fascinating combination, blending features from both the Authorization Code Flow and the Implicit Flow.

It's designed to offer flexibility, providing some tokens directly via the front-channel (browser redirect) while also enabling the secure acquisition of others via the back-channel.

Hybrid Flow addresses scenarios where an application needs immediate access to certain identity information (like an ID Token) but also requires the enhanced security of an Authorization Code for obtaining refresh tokens.

• Immediate ID Token: Useful for quick UI updates or initial authentication.
• Secure Access Token/Refresh Token: Obtained via a secure back-channel exchange, preventing token exposure in the browser history.

The key to Hybrid Flow lies in its `response_type` parameter. Unlike `code` (Authorization Code Flow) or `id_token token` (Implicit Flow), Hybrid Flow uses combinations.

Common `response_type` values for Hybrid Flow include:

• code id_token
• code token
• code token id_token

These tell the Authorization Server exactly which tokens to return in the front-channel response.

The process begins like other OIDC flows. Your client application redirects the user's browser to the Authorization Server's authorization endpoint.

The request includes parameters like:

• client_id: Your application's identifier.
• redirect_uri: Where the user will be sent back.
• response_type: Crucially, a hybrid combination (e.g., code id_token).
• scope: What resources/information you want to access (e.g., openid profile).
• nonce: A unique, single-use value to mitigate replay attacks.
• state: To maintain state and prevent CSRF attacks.

After the user authenticates and grants consent, the Authorization Server redirects the user's browser back to your redirect_uri.

Crucially, this front-channel redirect URL will contain both an authorization code and one or more tokens (e.g., id_token, access_token) directly in the URL fragment or query string, depending on the response_type.

For example, with response_type=code id_token, you'd get both.

Upon receiving the redirect, your client-side application (e.g., a Single-Page Application) can immediately extract the id_token from the URL fragment.

This ID Token can be used to:

• Authenticate the user locally.
• Update the UI with user profile information.
• Provide a sense of immediate login without further network calls.

The code is also extracted for later use.

The authorization code received in the front-channel response is then used by your client application to make a direct, secure back-channel request to the Authorization Server's token endpoint.

This request, usually from your backend server or a secure client, exchanges the code for a new access_token and, importantly, a refresh_token.

This ensures the refresh token is never exposed in the browser.

With Hybrid Flow, you might receive tokens from two different channels: the front-channel (ID Token, potentially Access Token) and the back-channel (Access Token, Refresh Token).

It's critical to validate *all* tokens received to ensure their authenticity, integrity, and validity. This includes checking signatures, expiration, audience, issuer, and the nonce for ID Tokens.

Hybrid Flow is often preferred for applications that need a quick, visible sign-in (via the front-channel ID Token) but also require the security of a refresh token for long-lived sessions (via the back-channel code exchange).

• Pros: Immediate user experience, refresh token security.
• Cons: More complex to implement and validate due to multiple tokens from different channels.

It balances user experience with strong security for refresh token acquisition.

Today, we explored the OpenID Connect Hybrid Flow. We learned how it strategically combines elements of the Authorization Code and Implicit flows by using specific response_type values.

This allows applications to get immediate identity information directly in the browser while maintaining the security of back-channel token exchanges for refresh tokens. It's a powerful tool for flexible and secure identity management.