비밀번호 변경

POST /fapi/v1/me/password · 환경의 로그인 호스트에서 호출

로그인한 사용자의 비밀번호를 변경합니다. 현재 비밀번호를 확인하며, 새 비밀번호는 환경의 비밀번호 정책, 유출 비밀번호 검사, 비밀번호 이력 규칙을 통과해야 합니다. 성공하면 사용자의 다른 모든 세션과 리프레시 토큰이 폐기되고, 현재 세션은 로그인 상태를 유지하며, 사용자의 이메일 주소로 보안 알림이 발송됩니다. 인증된 사용자의 __Host-idp_session 쿠키가 필요합니다. 다른 출처의 자사 애플리케이션은 대신 프런트 API 액세스 토큰(DPoP 증명을 포함한 Authorization: DPoP <token>)을 보낼 수 있습니다. 자세한 내용은 프런트 API 액세스 토큰을 참조하십시오.

요청

헤더:

헤더 필수 설명
Idp-Client 예 SDK 식별자입니다.
Origin 예 정확히 https://<sign-in host>이어야 합니다.

본문:

{"current_password": "…", "new_password": "…"}

응답

204 No Content.

오류

상태 코드 발생 조건
401 unauthenticated 유효한 세션 쿠키가 없습니다.
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의 개인정보에서 확인하십시오. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.