--- title: Runbook — AUTH_TOKEN_INVALID_SIGNATURE (서명 검증 실패) category: AUTH error_codes: [AUTH_TOKEN_INVALID_SIGNATURE] severity: P1 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_TOKEN_INVALID_SIGNATURE (`runbook://auth/token-invalid-signature`) ## 증상 - HTTP 401, `error.code=AUTH_TOKEN_INVALID_SIGNATURE`. - WARN 로그 줄 `security failure: code=AUTH_TOKEN_INVALID_SIGNATURE category=AUTH method=… path=…` (logger `AuthErrorResponseWriter`). 토큰을 보낸 쪽이 호출자라서 WARN이다. 수준이 아니라 `code=`로 찾는다. 한꺼번에 몰리면 위조 토큰이나 잘못된 서명 키를 의심한다. ## 진단 - JWKS 엔드포인트가 새 키 묶음을 내놓았는지 확인한다. - 로그에서 토큰 위조 시도를 찾는다. ## 조치 - IdP가 서명에 쓰는 키가 JWKS(`jwks_uri`)에 게시됐는지 확인한다. token 헤더의 `kid`는 클라이언트 쪽에서 재현해 본다. 토큰·`Authorization` 헤더·JWT payload는 로그에 남지 않고 남겨서도 안 된다. - 위조가 의심되면 보안 팀에 알린다. ## 에스컬레이션 - 위조 흔적이 있으면 바로 P1으로 올린다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.