사용자의 연결된 ID 목록 조회
GET /v1/users/{user_id}/identities · 권한 users:read
사용자의 연결된 ID(비밀번호, 소셜, SAML, OIDC, 레거시)를 생성 시간순으로 한 페이지에 나열합니다. 사용자당 ID 수는 제한되어 있으므로, 목록에는 limit, after, before, order가 없으며 list_metadata는 항상 null 값입니다. ID의 외부 주체(OIDC sub, SAML NameID), ID 공급자가 보고한 이메일 주소, 자격 증명 참조는 반환되지 않습니다. 패스키와 일회용 코드 방식은 인증 수단이므로 GET /v1/users/{user_id}/authenticators로 조회합니다.
요청
| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
user_id |
path | 예 | usr_ 접두사가 붙은 사용자 ID입니다. |
응답
200 OK. data에는 생성 시간순으로 정렬된 ID가 들어 있습니다. 목록은 페이징되지 않으므로 list_metadata는 항상 null 값입니다. connection_id는 password인 경우 null이며, provider는 social인 경우에만 설정됩니다.
ID에는 idn_ 접두사가 붙습니다.
{
"data": [
{
"id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2q",
"type": "password",
"connection_id": null,
"provider": null,
"linked_via": "primary",
"created_at": "2026-01-15T09:30:00Z"
},
{
"id": "idn_0a1b2c3d4e5f6g7h8j9k0m1n2r",
"type": "social",
"connection_id": "conn_0a1b2c3d4e5f6g7h8j9k0m1n2s",
"provider": "google",
"linked_via": "manual_link",
"created_at": "2026-02-01T08:00:00Z"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
type: password, social, saml, oidc, legacy · linked_via: primary, auto_verified_email, user_confirmed, admin_api, import, jit, auto_domain, invite_proof, manual_link, scim_match
오류
모든 오류는 안정적인 code가 포함된 application/problem+json 본문으로 반환됩니다.
| HTTP | code |
발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 사용자가 없거나 ID 형식이 잘못되었습니다. |
| 401 | unauthenticated |
API 키가 없거나 유효하지 않거나 취소되었습니다. |
| 403 | insufficient_permissions |
키에 users:read 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After를 따르십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |
예제
curl https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/identities \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
개인정보
이 엔드포인트는 개인정보인 연결된 ID를 포함합니다. KeenAuth API의 개인정보에서 저장되는 내용, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.