認証アプリを削除
DELETE /fapi/v1/me/authenticators/{authenticator_id} · 環境のサインインホストから呼び出します
認証アプリの記録を削除します。削除によって、ユーザーが環境内のいずれかのアプリケーションにサインインできなくなる場合は、削除は拒否されます。削除が成功すると、環境のセキュリティ通知設定に従い、ユーザーの認証済みメールアドレスにセキュリティ通知が送信されます。ユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消し済みの場合は、401 unauthenticated を返します。別のオリジンにあるファーストパーティのアプリは、代わりにフロント API アクセストークン(DPoP プルーフを付けた Authorization: DPoP <token>)を送信できます。詳しくは フロント API アクセストークン を参照してください。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
Origin |
はい | 正確に https://<sign-in host> である必要があります。 |
ボディはありません。
レスポンス
204 No Content を返します。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がない場合。 |
| 401 | step_up_required |
セッションが直近 5 分以内に検証されていない場合。WWW-Authenticate ヘッダーの max_age=300 を使って再検証してください。 |
| 403 | origin_not_allowed |
Origin がない、または誤っている場合。 |
| 404 | not_found |
このユーザーに該当する認証アプリがない場合。 |
| 409 | last_factor |
この要素を削除すると、少なくとも 1 つのアプリケーションにユーザーがサインインできなくなる場合。 |
例
curl -X DELETE https://example.keenauth.app/fapi/v1/me/authenticators/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
個人データ
このエンドポイントは個人データ(認証情報)を扱います。KeenAuth API における個人データ では、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。