--- title: Runbook — AUTH_CLAIM_MAPPING_FAILED (클레임 매핑 실패) category: AUTH error_codes: [AUTH_CLAIM_MAPPING_FAILED] severity: P2 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: AUTH_CLAIM_MAPPING_FAILED (`runbook://auth/claim-mapping-failed`) ## 증상 - HTTP 401, `error.code=AUTH_CLAIM_MAPPING_FAILED`. - 토큰 검증은 통과했지만 필요한 클레임(sub, roles, tenant)이 없거나 타입이 다르다. ## 진단 - 로그에서 토큰 payload의 클레임을 본다. - 클레임 추출 설정을 확인한다. ## 조치 - IdP 토큰 템플릿에 필요한 클레임이 들어 있는지 확인한다. - IdP 스키마가 바뀌었으면 클레임 매핑 설정을 고친다. ## 에스컬레이션 - IdP가 클레임 스키마를 바꿨으면 인증 플랫폼 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.