--- title: Runbook — AUTHZ_TENANT_MISMATCH (테넌트 cross-access 시도) category: AUTHZ error_codes: [AUTHZ_TENANT_MISMATCH] severity: P1 owner: oncall last_updated: 2026-11-13 status: 초안 --- # Runbook: AUTHZ_TENANT_MISMATCH (`runbook://authz/tenant-mismatch`) ## 증상 - `AUTHZ_TENANT_MISMATCH`는 enum 상수와 registry 행이 있지만 템플릿 코드는 내지 않는다. 템플릿이 정한 규칙은 남의 tenant 객체를 없는 것처럼 404로 답하는 것이다(`docs/manual/07-authorization.md` 「객체 단위 권한」, 실제 신호는 `docs/runbooks/authz-cross-tenant-violation.md`). - 서비스가 다른 tenant 접근을 403 `AUTHZ_TENANT_MISMATCH`로 따로 답하기로 했을 때만 이 runbook을 쓴다. 403 carrier는 로그 줄 없이 응답하므로(`ServerFailureLog`), 그 서비스가 판단하는 자리에서 `code=AUTHZ_TENANT_MISMATCH`를 남겨야 찾을 수 있다. ## 진단 - `trace_id`로 요청 흐름을 따라간다. tenant는 인증 정보에서만 온다. 요청이 tenant를 제안하면(`X-Tenant-Id` 등) 서비스가 web-advanced `WebSecurityContextBridge.resolve(authentication, requestInput)`을 부를 때 403 `TENANT_INPUT_UNTRUSTED`로 거부하고, 한 인자 `resolve`만 부르거나 부르지 않으면 무시한다. 그래서 비교할 「요청의 tenant」는 없다. 토큰·`Authorization` 헤더·JWT payload는 로그에 남지 않고 남겨서도 안 된다. 값을 봐야 하면 클라이언트 쪽에서 재현한다. - 클라이언트 설정 오류인지 의도한 공격인지 가린다. ## 조치 - 반복하는 호출자는 gateway에서 막는다. - 보안 팀에 조사를 요청한다. ## 에스컬레이션 - 악의적인 다른 테넌트 접근 시도로 확인되면 P1. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.