--- title: Runbook — AUTH_KID_UNKNOWN (키 ID 미인식) category: AUTH error_codes: [AUTH_KID_UNKNOWN] severity: P2 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: AUTH_KID_UNKNOWN (`runbook://auth/kid-unknown`) ## 증상 - HTTP 401, `error.code=AUTH_KID_UNKNOWN`, `retryable=true`. - 토큰 헤더의 `kid`가 캐시된 JWKS에 없다. ## 진단 - 최근에 IdP 키 교체가 있었는지 확인한다. - JWKS 캐시 TTL과 새로 고침 시점을 확인한다. ## 조치 - JWKS 캐시를 강제로 새로 고친다. - 새 키가 IdP JWKS 엔드포인트에 게시됐는지 확인한다. ## 에스컬레이션 - 10분이 지나도 새 kid가 JWKS에 나타나지 않으면 IdP 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.