document-haness/docs/clean-architecture-backend-template/tech-log-studio/security-policy-enforcement/case/case-grpc-admin-f02.md

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, evidenceCapturedOn, assets, evidence, source, module, priority

kind	slug	title	topic	project	status	sourceRevision	rootTreeNode	evidenceCapturedOn	assets	evidence	source	module	priority
CASE	grpc-admin-f02	비밀 필드 검사가 스냅숏의 네 구획 중 하나에만 적용된다	security-policy-enforcement	clean-architecture-backend-template	게시 전	21234e38cdb9a926cbc92bb97a2aee2e4a7d2916	case:grpc-admin-f02	2026-09-01	key file grpc-admin-f02 ../../../final/evidence/rendered/grpc-admin-f02.svg	../../../final/evidence/raw/grpc-admin-f02.txt	원본 분석 절은 analysis/grpc/grpc-admin.md#L162 이다.	grpc-admin	P3

비밀 필드 검사가 스냅숏의 네 구획 중 하나에만 적용된다

메시지는 "a platform snapshot must not carry …" 로 스냅숏 전체를 말한다. 검사 대상은 channelProfileHashes 하나다.

문제

메시지는 "a platform snapshot must not carry …" 로 스냅숏 전체를 말한다.

검사 대상은 channelProfileHashes 하나다.

결론

같은 채널 이름 공간을 쓰는 두 맵이 더 있다 — resolverAndLoadBalancerByChannel, retryOwnerByChannel.

그리고 registeredServices 목록과 serviceHealth 맵이 있다.

어느 것도 검사되지 않는다.

세 맵의 키 집합이 같아야 한다는 요구가 없으므로, 어떤 채널이 나머지 두 맵에만 있으면 그 이름은 검사를 지나지 않는다.

grpc-advanced-diagnostics 의 스냅숏은 같은 형태의 자기 검사를 두 구획(주소 목록, 자원 판본 키)에 적용한다.

두 리프의 규율이 갈린다.

수정은 네 구획 전부를 같은 검사에 넣는 것이다.

값이 아니라 키를 보는 검사이므로 비용이 낮다.

검증 환경

OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : 검사에 들어가는 구획과 스냅숏이 담는 네 구획의 대조 소스 수정 : x

재현 조건

원문은 analysis/grpc/grpc-admin.md#L162 에 있다.

본문

검사는 한 구획에만 걸린다.

List<String> forbidden = GrpcAdminExposurePolicy.forbiddenFields(channelProfileHashes);
if (!forbidden.isEmpty()) {
  throw new IllegalArgumentException("a platform snapshot must not carry " + forbidden + "; hashes and names only");
}

메시지는 "a platform snapshot must not carry …" 로 스냅숏 전체를 말한다. 검사 대상은 channelProfileHashes 하나다.

검사가 걸리는 구획

:::evidence key="grpc-admin-f02" alt="분석 문서 analysis/grpc/grpc-admin.md 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/grpc/grpc-admin.md 발췌 — 15줄" zoom="true" :::

검사되지 않는 세 구획

같은 채널 이름 공간을 쓰는 두 맵(resolverAndLoadBalancerByChannel, retryOwnerByChannel)과 registeredServices 목록·serviceHealth 맵이다. 세 맵의 키 집합이 같아야 한다는 요구가 없으므로, 어떤 채널이 나머지 두 맵에만 있으면 그 이름은 검사를 지나지 않는다.

두 리프의 규율이 갈린다

grpc-advanced-diagnostics 의 스냅숏은 같은 형태의 자기 검사를 두 구획(주소 목록, 자원 판본 키)에 적용한다. 수정은 네 구획 전부를 같은 검사에 넣는 것이다 — 값이 아니라 키를 보는 검사이므로 비용이 낮다.

확인하지 못한 것

검사되지 않는 세 구획에 실제로 비밀 형태의 키를 넣어 통과를 관측하지 않았다. 검사 인자와 구획 목록의 대조로 판정했다.