--- title: Runbook — AUTH_AUDIENCE_MISMATCH (대상 불일치) category: AUTH error_codes: [AUTH_AUDIENCE_MISMATCH] severity: P2 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTH_AUDIENCE_MISMATCH (`runbook://auth/audience-mismatch`) ## 증상 - HTTP 401, `error.code=AUTH_AUDIENCE_MISMATCH`. - 토큰의 `aud` 클레임에 이 서비스가 기대하는 audience가 없다. ## 진단 - 클라이언트가 어떤 audience로 token을 요청하는지 클라이언트 설정에서 본다. 토큰·`Authorization` 헤더·JWT payload는 로그에 남지 않고 남겨서도 안 된다. 값을 봐야 하면 클라이언트 쪽에서 재현한다. - 설정된 `app.security.audience`(`APP_SECURITY_JWT_AUDIENCE`, 쉼표로 구분)와 비교한다. 토큰은 그중 하나 이상을 담아야 한다. ## 조치 - 클라이언트가 맞는 audience로 토큰을 요청하는지 확인한다. - 서비스 식별자가 바뀌었으면 audience 설정을 고친다. ## 에스컬레이션 - 설정 오류가 시스템 전체에 걸쳐 있으면 인증 플랫폼 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.