5.6. アプリケーション起点のアクション

アプリケーション起点のアクション (AIA) を使用すると、クライアントアプリケーションは、ユーザーに Red Hat build of Keycloak でアクションを実行するように要求できます。通常、OIDC クライアントアプリケーションは、ユーザーにログインを要求する場合、OIDC セクション で説明されているように、そのユーザーをログイン URL にリダイレクトします。ログイン後、ユーザーはクライアントアプリケーションにリダイレクトされます。ユーザーは、前のセクション で説明したように管理者によって要求されたアクションを実行し、すぐにアプリケーションにリダイレクトされます。しかし、AIA を使用すると、クライアントアプリケーションは、ログイン時にユーザーに対して特定の必須アクションを要求できます。これは、ユーザーがクライアント上ですでに認証されており、アクティブな SSO セッションがある場合でも実行できます。これは、要求されたアクションを含む値を持つ kc_action パラメーターを OIDC ログイン URL に追加することによってトリガーされます。たとえば、kc_action=UPDATE_PASSWORD パラメーターです。

ユーザーはアプリケーションによって開始されたアクションをキャンセルできます。この場合、ユーザーはクライアントアプリケーションにリダイレクトされます。リダイレクト URI には、キャンセルされたアクションの名前を含むクエリーパラメーター kc_action_status=cancelled と kc_action が含まれます。

したがって、AIA を使用する場合、フローの例は次のようになります。

AIA は、Red Hat build of Keycloak アカウントコンソール でパスワードの更新を要求したり、OTP や WebAuthn などの他の認証情報をリセットしたりするために使用されることに注意してください。