パスキーを削除する
DELETE /fapi/v1/me/passkeys/{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/passkeys/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 における個人データ では、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。