--- title: Runbook — AUTH_ISSUER_MISMATCH (발급자 불일치) category: AUTH error_codes: [AUTH_ISSUER_MISMATCH] severity: P2 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_ISSUER_MISMATCH (`runbook://auth/issuer-mismatch`) ## 증상 - HTTP 401, `error.code=AUTH_ISSUER_MISMATCH`. - WARN 로그 줄 `security failure: code=AUTH_ISSUER_MISMATCH category=AUTH method=… path=…`(logger `AuthErrorResponseWriter`). ## 진단 - 검증기가 비교하는 값은 `app.security.issuer-uri`(env `APP_SECURITY_JWT_ISSUER`)다(`config/security.yml` → `JwtDecoderConfig`). 같은 env가 `spring.security.oauth2.resourceserver.jwt.issuer-uri`도 채우지만 decoder는 그 키를 읽지 않는다. - 거부된 token의 `iss`를 클라이언트 쪽에서 디코딩해 `APP_SECURITY_JWT_ISSUER`와 견준다. 흔한 원인은 hostname(내부·외부 주소), realm 이름, 끝의 `/` 차이다. IdP discovery의 `issuer`와 설정값이 다르면 이 401이 아니라 decoder를 만들지 못한 500 `INTERNAL_AUTH_MISCONFIGURATION`이다(`docs/runbooks/auth-public-path-misconfiguration.md`). - 토큰, `Authorization` 헤더, JWT payload는 로그에 남지 않고 남겨서도 안 된다. ## 조치 - IdP를 옮겼으면 `APP_SECURITY_JWT_ISSUER`를 고친다. - 예상하지 않은 발급자의 token은 계속 거부한다. ## 에스컬레이션 - 예상하지 않은 발급자를 찾으면 플랫폼 보안 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.