他のセッションをサインアウト
POST /fapi/v1/me/sessions:revoke-others · 環境のサインインホストから呼び出します
リクエストを行っているセッション以外の、認証済みユーザーの有効なセッションをすべて終了し、そのセッションに紐づかないユーザーのリフレッシュトークンを取り消します。終了したセッションが発行したアクセストークンは拒否され、そのセッションを通じてサインインしていたアプリケーションには通知されます。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れである、または取り消されている場合は 401 unauthenticated を返します。別のオリジンにある自社アプリは、代わりにフロント API アクセストークン(DPoP 証明付きの Authorization: DPoP <token>。フロント API アクセストークンを参照)を送信できます。セッションは直近 300 秒以内に検証されている必要があります。そうでない場合は、RFC 9470 の WWW-Authenticate チャレンジ(max_age=300)を伴う 401 step_up_required を返し、何も変更されません。再度サインインし(例: max_age=0 または prompt=login)、リトライしてください。他のセッションがない場合も、レスポンスは 204 です。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
Origin |
はい | https://<サインインホスト> と完全に一致している必要があります。 |
ボディはありません。
レスポンス
204 No Content。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 401 | step_up_required |
セッションが 300 秒より前に検証されています。 |
| 403 | origin_not_allowed |
Origin がないか、誤っています。 |
例
curl -X POST https://example.keenauth.app/fapi/v1/me/sessions:revoke-others \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt