パスワードを変更する
POST /fapi/v1/me/password · 環境のサインインホストから呼び出し
サインイン中のユーザーのパスワードを変更します。現在のパスワードが確認されます。新しいパスワードは、環境のパスワードポリシー、漏えいパスワードチェック、パスワード履歴ルールに適合している必要があります。成功すると、ユーザーの他のすべてのセッションとリフレッシュトークンが取り消され、このセッションはサインインしたままになります。また、ユーザーのメールアドレスにセキュリティ通知が送信されます。認証済みユーザーの __Host-idp_session Cookie が必要です。別オリジンの自社アプリケーションは、代わりにフロント API アクセストークン(DPoP 証明付きの Authorization: DPoP <token>。フロント API アクセストークン を参照)を送信できます。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子。 |
Origin |
はい | 正確に https://<sign-in host> である必要があります。 |
本文:
{"current_password": "…", "new_password": "…"}
レスポンス
204 No Content。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 401 | step_up_required |
セッションが直近 5 分以内に検証されていません。WWW-Authenticate ヘッダーの max_age=300 で再検証してください。何も確認もカウントもされません。 |
| 401 | invalid_credentials |
現在のパスワードが誤っています。失敗が繰り返されると、サインインと同じ方法でパスワードがロックされます。 |
| 403 | origin_not_allowed |
Origin がない、または誤っています。 |
| 422 | password_policy_violation |
新しいパスワードがポリシーに違反しています。errors[] には /new_password について違反したルールが一覧されます(too_short、too_long、context_term、custom_term、repeated_chars、invalid_text、reused)。 |
| 422 | breached_password |
新しいパスワードが既知のデータ漏えいに含まれています。 |
| 503 | temporarily_unavailable |
サーバーが混雑しています。Retry-After 秒後に再試行してください。 |
例
curl -X POST https://example.keenauth.app/fapi/v1/me/password \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{"current_password": "…", "new_password": "…"}' \
-b cookies.txt
個人データ
このエンドポイントは個人データ(認証情報)を扱います。KeenAuth API における個人データ では、保存される内容、保持期間、削除方法を説明しています。いかなるフィールドにも特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。