--- title: Runbook — AUTH_TOKEN_MISSING (인증 토큰 누락) category: AUTH error_codes: [AUTH_TOKEN_MISSING, UNAUTHENTICATED] severity: P3 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_TOKEN_MISSING (`runbook://auth/token-missing`) ## 증상 - HTTP 401, `error.code=AUTH_TOKEN_MISSING`, `WWW-Authenticate: Bearer`. - WARN 로그 줄 `security failure: code=AUTH_TOKEN_MISSING category=AUTH method=… path=…`(logger `AuthErrorResponseWriter`). 보안 chain이 거부한 요청은 요청 로그(`http_request …`)에는 없다. ## 진단 - 헤더가 있었는지는 앱 로그에 없다. 앞단 프록시·gateway 설정과 클라이언트 SDK 설정을 본다. ## 조치 - API 클라이언트가 Authorization 헤더를 보내는지 확인한다. - gateway·proxy가 헤더를 지우는지 설정을 확인한다. ## 에스컬레이션 - 넓게 퍼졌거나 중요한 업무 흐름에 영향이 있으면 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.