사용자에게서 연결된 ID 제거
DELETE /v1/users/{user_id}/identities/{identity_id} · 권한 users:write
사용자의 연결된 ID 하나(비밀번호, 소셜, SAML, OIDC 또는 레거시)를 제거합니다. 사용자가 속한 조직이 해당 ID의 연결을 통해 Single Sign-On을 강제하더라도 제거는 진행됩니다. 사용자는 계정 포털에서 이런 ID를 제거할 수 없으므로(409 sso_enforced_by_organization), 고객이 이 엔드포인트로 제거해야 합니다. 사용자의 마지막 1차 인증 방식은 제거할 수 없습니다(409 last_login_method). 확인된 모든 이메일 주소로 사용자에게 알림이 전송되며, 작업은 API 키를 행위자로 하여 관리 감사 로그에 기록됩니다.
요청
| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
user_id |
경로 | 예 | 사용자 ID이며 접두사는 usr_입니다. |
identity_id |
경로 | 예 | ID의 식별자이며 접두사는 idn_입니다(GET /v1/users/{user_id}/identities가 반환한 값). |
요청 본문은 필요하지 않습니다.
응답
204 No Content.
오류
모든 오류는 안정적인 code를 포함한 application/problem+json 본문으로 반환됩니다.
| HTTP | code |
발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 사용자가 없거나, ID가 이 사용자에게 속하지 않거나 알 수 없거나, ID 형식이 잘못되었습니다. |
| 409 | last_login_method |
이 ID는 사용자의 마지막 1차 인증 방식입니다. 먼저 다른 방식을 추가하십시오. |
| 401 | unauthenticated |
API 키가 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | insufficient_permissions |
키에 users:write 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After를 준수하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |
예시
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities/idn_0a1b2c3d4e5f6g7h8j9k0m1n2r \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
개인 데이터
이 엔드포인트는 개인 데이터를 포함합니다: 연결된 ID. KeenAuth API의 개인 데이터에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특별 범주의 개인 데이터(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.