문제: AuthErrorResponseWriter는 보안 필터가 답한 실패를 모두 WARN으로 남긴다. AUTH_JWKS_UNAVAILABLE(503, 키 서버 장애)과 INTERNAL_AUTH_MISCONFIGURATION(500, 인증 설정 오류)은 서버 쪽 고장인데도 WARN이다. 다른 모든 경로는 5xx를 ERROR로 남기므로(ServerFailureLog) 규칙이 갈라져 있고, ERROR로 거르는 운영자는 이 둘을 놓친다. 고른 방법: 응답 상태로 레벨을 고른다. 5xx는 ERROR, 4xx는 WARN이다. 줄의 모양(code·category·method·path, 예외 없음)은 그대로다. 401 서명·issuer· audience 불일치는 WARN으로 둔다(소유자 결정 3, 2026-11-06). 테스트가 서명 실패 WARN도 고정한다. 버린 대안: 두 코드를 이름으로 나열하기 — 새 5xx 보안 코드가 생기면 조용히 WARN에 남는다. ServerFailureLog 줄로 바꾸기 — 예외를 붙이는 줄이라, 토큰이 섞일 수 있는 실패 메시지를 남기지 않는 이 writer의 계약과 맞지 않는다. 위험·한계: ERROR 수로 경보를 거는 곳에 JWKS 장애와 인증 설정 오류가 새로 잡힌다. upgrade 안내 5절에 적었다. 결정은 docs/superpowers/specs/2026-11-06-error-code-log-level-design.md 10절이다. 검증(desktop, 공유 잠금, 로그는 desktop ~/t3-loglevel-logs/): - RED: 기준 writer로 EnvelopeAuthenticationEntryPointTest 8건 중 2건 실패 (aKeyServiceOutageIsLoggedAtError, aDecoderMisconfigurationIsLoggedAtError — WARN이 나오고 ERROR를 기대). rc=1, red-web.log - GREEN: :adapter:inbound:web:check rc=0, 테스트 329건 실패 0. green-web-check.log - :adapter:inbound:web:testQualityCheck rc=0, green-quality.log
1.0 KiB
1.0 KiB
title, category, error_codes, severity, owner, last_updated, status
| title | category | error_codes | severity | owner | last_updated | status | |
|---|---|---|---|---|---|---|---|
| Runbook — INTERNAL_AUTH_MISCONFIGURATION (공개 경로 설정 오류) | INTERNAL |
|
P1 | oncall | 2026-11-06 | stub |
Runbook: INTERNAL_AUTH_MISCONFIGURATION (runbook://auth/public-path-misconfiguration)
Symptoms
- HTTP 500 with
error.code=INTERNAL_AUTH_MISCONFIGURATION - ERROR log line
security failure: code=INTERNAL_AUTH_MISCONFIGURATION category=INTERNAL method=… path=…(loggerAuthErrorResponseWriter) - Security filter misconfiguration detected at runtime
Diagnosis
- Check
verifyPublicPathSnapshotoutput in CI - Review recent changes to
SecurityConfigorapplication.ymlpublic path list
Action
- Revert misconfigured public path change
- Run
./gradlew verifyPublicPathSnapshotto compare snapshot
Escalation
- P1 immediate: if auth bypass is possible due to misconfiguration
Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)