アプリ統合でシングルログアウトを構成する
シングルログアウト(SLO)とは、エンドユーザーが1回の操作でOktaセッションと構成済みアプリの両方からサインアウトできるようにするフェデレーション認証の機能です。
Oktaでは、サービスプロバイダー(SP)がこのサインアウトプロセスを開始した場合にのみ、シングルサインアウトがサポートされます。SPがOktaにSLOリクエストを送信すると、Oktaセッションが終了します。
- SWAアプリはSLOをサポートしません。
- すべてのアプリの統合がSLOをサポートしているわけではありません。SPがダウンストリームアプリでSLOをサポートしている場合、アプリの構成ガイドにサポート対象の機能として記載されます。SLOに対応するようリクエストを出す場合は、直接SPにお問い合わせください。
SAML統合でSLOを有効化する
SAMLアプリでは、SPがSLOリクエストをOktaに送信できる必要があり、リクエストが署名されている必要があります。
SLOの構成には、SAMLアプリケーション統合ウィザードを利用できます。
- Admin Consoleで に移動します。
- SLOを追加するSAMLアプリをクリックします。
- [General(一般)]設定タブの[SAML Settings(SAML設定)]パネルで、[Edit(編集)]をクリックします。
- SAML構成ウィザードで、[Next(次へ)]をクリックします。
- [Configure SAML(SAMLを構成)]ページで、[Show Advanced Settings(詳細設定を表示)]をクリックします。
- [Allow application to initiate Single Logout(アプリケーションによるシングルログアウトの開始を許可)]を選択します。
- [Single Logout URL(シングルログアウトURL)]:SLOが返すためのURL。これは(POST操作で)Oktaからのサインアウト応答の送信先となるサービスプロバイダーのURLです。SP側でSLO用のURLを指定していない場合は、SPのメインURLを使用できます。
- [SP Issuer(SP発行者)]:アプリの識別子。ACS URLかSPエンティティIDです。SPアプリからSLOリクエストで送信されるメタデータの中にもこの値が含まれます。
- [Signature Certificate(署名証明書)]:OktaではSLOリクエストにデジタル署名が必要です。署名証明書のコピーまたはSPがSLOリクエストへの署名に使用しているCAのどちらかをアップロードする必要があります。
- [Next(次へ)]をクリックします。
- [Finish(終了)]をクリックします。
最後に、SPアプリで必要になるSLOの情報を取得する必要があります。
- [Sign On(サインオン)]設定タブの[View SAML setup instructions(SAMLの設定手順を表示)]をクリックします。
- ここで表示されるページから、[Identity Provider Single Logout URL(IDプロバイダーのシングルログアウトURL)]を確認できます。このURLをコピーし、SPアプリに戻って構成設定に追加します。
- SLOのフローをテストするには、Okta統合を利用してSPアプリにサインインし、SPアプリ内で該当のサインアウト方法を実行します。これにより、ブラウザー上でSPアプリとOktaの両方からサインアウトが行われます。
OIDC統合でSLOを有効にする
OpenID Connect(OIDC)統合の場合は、SLOリクエストをGETリクエストとしてOktaに送信するようにSPアプリを構成する必要があります。この設定により、アプリはOktaエンドポイントにリダイレクトされます。
GET https://{baseUrl}/logout?id_token_hint=${id_token}&post_logout_redirect_uri=${post_logout_redirect_uri}&state=${state}ここで
- baseURLはOkta orgのURLです。
- id_tokenはサインオン時にOktaによって発行されるOIDCトークンです。
- 任意。post_logout_redirect_uriはログアウトリダイレクトURIです。SLO操作後にOktaによってユーザーがリダイレクトされるURIを示します。このURIは、Okta統合の[General Settings(一般設定)]内にある、[Logout redirect URIs(ログアウトリダイレクトURI)]構成のリストに記載されている必要があります。
- 任意。stateはSLO URIへのリダイレクト時にパラメーターとして追加する任意の文字列です。
このリクエストが処理されると、id_tokenが無効になり、ユーザーはOktaからサインアウトします。
APIにGETリクエストを送信する方法の詳細については、「OpenID ConnectおよびOAuth 2.0 API」リファレンスを参照してください。
アプリ開発者向けの情報として、開発者ガイドのユーザーのサインアウトの項目で言語固有の手順も提供しています。
最後に、ログアウトリダイレクトURIをOkta統合に追加する必要があります。
- Admin Consoleで に移動します。
- SLOを追加するSAMLアプリをクリックします。
- [General(一般)]設定タブで、[Edit(編集)]をクリックします。
- [Logout redirect URIs(ログアウトリダイレクトURI)]の横の[+Add URI(URIを追加)]をクリックし、「post_logout_redirect_uri」を入力します。
- [Save(保存)]をクリックします。
- SLOのフローをテストするには、Okta統合を利用してSPアプリにサインインし、SPアプリ内で該当のサインアウト方法を実行します。これにより、ブラウザー上でSPアプリとOktaの両方からサインアウトが行われます。