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

## 본문

<!-- body:start -->

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

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

## 확인하지 못한 것

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

<!-- body:end -->