エンドポイント
GET /oidc/logout
このエンドポイントを使用して、ユーザーをログアウトできます。ログアウト後にユーザーを特定の URL に遷移させたい場合は、その URL を post_logout_redirect_uri パラメーターに設定します。この URL は、該当する Allowed Logout URLs の一覧に含まれている必要があります。
id_token_hintパラメーターが含まれている場合:client_idパラメーターが含まれている場合、サーバーはid_token_hintのaudクレーム内の URL を使用して、client_idで指定されたアプリケーションに設定されているAllowed Logout URLsのうち、どれを使用するかを選択します。client_idパラメーターが含まれていない場合、サーバーはid_token_hintのaudクレーム内の URL を使用して、テナントレベルに設定されているAllowed Logout URLsのうち、どれを使用するかを選択します。
id_token_hintパラメーターが含まれていない場合:client_idパラメーターが含まれている場合、post_logout_redirect_uriの URL は、アプリケーションレベルで設定されたAllowed Logout URLsの一覧に含まれている必要があります。client_idパラメーターが含まれていない場合、post_logout_redirect_uriの URL は、テナントレベルで設定されたAllowed Logout URLsの一覧に含まれている必要があります。client_idパラメーターが含まれており、post_logout_redirect_uriの URL が設定されていない場合、サーバーはユーザーを Auth0 Dashboard で設定された最初のAllowed Logout URLsにリダイレクトします。
注記
- ユーザーをソーシャル ID プロバイダーからログアウトさせることは一般的ではないため、ソーシャル ID プロバイダーで
federatedクエリ文字列パラメーターを使用する前に、ユーザーエクスペリエンスを十分に考慮してください。 id_token_hintとlogout_hintの両方を指定する場合、logout_hintの値はid_token_hintのsidクレームと一致している必要があります。id_token_hintとclient_idの両方を指定する場合、client_idの値はid_token_hintのaudクレームと一致している必要があります。id_token_hintが指定されていない場合、ユーザーのセッション ID と一致するlogout_hintが指定されていない限り、ユーザーに同意を求めるプロンプトが表示されます。- このリクエストでは
POSTHTTP メソッドもサポートされています。POSTを使用する場合、リクエストパラメーターはクエリ文字列ではなく、フォームパラメーターとしてリクエストボディで指定する必要があります。federatedパラメーターにはtrueまたはfalseを指定する必要があります。 - これは OIDC RP-Initiated Logout 仕様 に準拠しています。
詳しくはこちら
クエリパラメータ
string
[推奨] ユーザーに以前発行された ID トークンです。どのユーザーをログアウトするかを示すために使用されます。
string
どのユーザーをログアウトするかを示すための、任意の
sid (セッション ID) 値です。id_token_hint が利用できない場合に指定してください。string
ログアウト後にユーザーをリダイレクトするための URL です。
string
アプリケーションの
client_id です。string
ユーザーを ID プロバイダーからログアウトさせるには、このクエリ文字列パラメーターを追加します:
https://YOUR_DOMAIN/oidc/logout?federated。string
アプリケーションが最初のリクエストに追加する不透明な値で、認可サーバーは
post_logout_redirect_uri へのリダイレクト時にこの値を含めます。string
リクエストで使用する言語リストを制限するための、スペース区切りのロケール一覧です。一覧の先頭のロケールは、テナントで有効になっているロケールと一致している必要があります。