--- title: Runbook — AUTH_TOKEN_EXPIRED (토큰 만료) category: AUTH error_codes: [AUTH_TOKEN_EXPIRED] severity: P3 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_TOKEN_EXPIRED (`runbook://auth/token-expired`) ## 증상 - HTTP 401, `error.code=AUTH_TOKEN_EXPIRED`. - 급증하면 시계 차이(clock skew)나 오래 사는 토큰을 의심한다. ## 진단 - 서버 시계와 token 발급 호스트의 시계를 비교한다. token의 `exp`는 클라이언트 쪽에서 재현해 본다. 토큰·`Authorization` 헤더·JWT payload는 로그에 남지 않고 남겨서도 안 된다. - 토큰을 발급하는 호스트의 NTP 동기화를 확인한다. ## 조치 - 클라이언트는 만료 전에 토큰을 새로 받아야 한다. - 시계 차이 허용값을 확인한다. 이 템플릿의 JWT 검증기는 60초를 허용한다(`JwtDecoderConfig`). ## 에스컬레이션 - 급증이 넓게 퍼졌거나 시계 어긋남이 확인되면 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.