--- title: Runbook — AUTH_TOKEN_MALFORMED (토큰 파싱 실패) category: AUTH error_codes: [AUTH_TOKEN_MALFORMED, INVALID_TOKEN] severity: P3 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_TOKEN_MALFORMED (`runbook://auth/token-malformed`) ## 증상 - HTTP 401, `error.code=AUTH_TOKEN_MALFORMED`, `WWW-Authenticate: Bearer error="invalid_token"`. - WARN 로그 줄 `security failure: code=AUTH_TOKEN_MALFORMED category=AUTH method=… path=…`(logger `AuthErrorResponseWriter`). - 분류기가 더 좁은 코드로 가르지 못한 token 실패도 이 코드다(`SecurityErrorClassifier`). ## 진단 - 토큰, `Authorization` 헤더, JWT payload는 로그에 남지 않고 남겨서도 안 된다. 값을 봐야 하면 클라이언트 쪽에서 재현한다. - 같은 `path=`·시각에 몰리는지 보고 어느 클라이언트인지 앞단 접근 로그로 찾는다. ## 조치 - 클라이언트의 token 생성·전달(접두어 `Bearer `, 잘린 값)을 고친다. ## 에스컬레이션 - 급증이 인프라 문제(프록시가 헤더를 바꿈 등)를 가리키면 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.