연결의 rpId 마이그레이션 조회
GET /v1/connections/{connection_id}/rp-id-migration · 권한 connections:read
패스키 연결의 최신 rpId 마이그레이션을 반환합니다. 마이그레이션이 아직 진행 중이든 이미 종료되었든 관계없이 조회할 수 있습니다(패스키 rpId 변경 참조). 개수는 마이그레이션이 종료될 때 기록되며, active 상태인 동안에는 null입니다. 조회는 감사 로그에 기록되지 않습니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
connection_id |
path | 예 | 패스키 연결 ID(conn_…). |
응답
200 OK:
{
"id": "rpm_01j9xr4a6b8c0d2e4f6g8h0j2k",
"connection_id": "conn_01j9xp6q0r1s5t7v9w1x3y5z7b",
"previous_rp_id": null,
"new_rp_id": "login.example.com",
"status": "completed_early",
"started_at": "2026-10-27T10:00:00Z",
"ends_at": "2027-01-25T10:00:00Z",
"completed_at": "2026-12-01T09:00:00Z",
"revoked_count": 12,
"new_registration_count": 340,
"fallback_enabled_by_migration": false
}
| 필드 | 설명 |
|---|---|
status |
active, completed(기간이 종료됨) 또는 completed_early. |
revoked_count |
마이그레이션이 종료될 때 취소된, 이전 rpId의 패스키 수. |
new_registration_count |
기간 동안 새 rpId에 등록된 패스키 수. |
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 환경에 연결이 없거나, 패스키 연결이 아니거나, rpId 마이그레이션이 한 번도 없었습니다. |
| 401 | unauthenticated |
자격 증명이 없거나 잘못되었거나 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예시
curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/rp-id-migration" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
keenauth connections rp-id-migration conn_01j9xp6q0r1s5t7v9w1x3y5z7b