제한 데이터가 마스킹되지 않은 채 관리형 모델에 도달하면 빌드를 중단하는 정책
한 시스템 환경에서 제한된 고객 데이터를 다루는 보험금 청구 어시스턴트와 데이터를 전혀 다루지 않는 헬프데스크 어시스턴트를 운영합니다. 두 어시스턴트 모두 클러스터 내 AI 게이트웨이를 통해 OpenAI의 관리형 API로 모델 트래픽을 보냅니다. 이 환경의 내부 규칙은 다음과 같습니다.
한 등급의 데이터는 빌드 그래프의 경로를 따라 다른 등급의 컴포넌트에 도달하지 않습니다. 단, 해당 경로에 등급 해제 Feature가 연결된 경우는 예외입니다.
이 워크스페이스는 해당 규칙을 빌드 그래프에 대한 정책으로 연결하고, 하나의 Aggregate에 대한 세 개의 Releases를 빌드합니다. 그중 하나에서는 보험금 청구 어시스턴트의 요청이 요청을 마스킹하는 게이트웨이를 거치며, 빌드가 완료됩니다. 나머지 두 개에서는 그렇지 않으므로, 아무것도 렌더링되기 전에 빌드가 중단되고 정책이 경로의 양쪽 끝을 지목합니다.
이 규칙은 실행되는 정책 엔진마다 한 번씩, 즉 CLI에 컴파일되어 들어간 Rego 엔진과 CEL 엔진, 그리고 OPA용으로 세 번 작성되며, 세 사본은 여기의 모든 빌드에서 같은 결과를 냅니다. Releases 옆에 있는 스크립트가 아홉 가지 조합을 모두 빌드하고 각 결과를 확인합니다.
구성되는 내용
| 인스턴스 | 카탈로그 Component | 여기서의 역할 |
|---|---|---|
assistant | local/ai-agent/claims-assistant | 청구 어시스턴트: 표준 라이브러리의 LangGraph 에이전트로, 이 워크스페이스의 카탈로그에 레이블 하나를 추가해 선언합니다. 그 레이블은 이 어시스턴트가 처리하는 데이터의 등급입니다 |
helpdesk | core/ai-agent/langgraph | 등급이 없는 헬프데스크 어시스턴트 |
checkpointer | core/datastore/valkey | 두 어시스턴트가 실행 상태를 보관하는 곳 |
masking-gateway | core/gateway/litellm | 별칭 하나(chat)를 제공하며 core/data-masking이 연결된 AI 게이트웨이 |
plain-gateway | core/gateway/litellm | 아무것도 연결되지 않은 동일한 게이트웨이 |
gpt | core/ai-model/openai | 참조로 접근하는 OpenAI의 관리형 API: 클러스터에서는 이를 위해 아무것도 실행되지 않습니다 |
analyzer, anonymizer | core/security/presidio-analyzer, core/security/presidio-anonymizer | 마스킹이 호출하는 인식기 서비스 |
두 게이트웨이는 모두 models 소켓을 통해 gpt에 연결되며, 각각 그 연결에서 모델의 키를 제시합니다. 마스킹 연결은 마스킹할 대상을 나열합니다. 이 조직의 청구 번호에 대한 패턴과 엔터티 유형 PERSON 및
EMAIL_ADDRESS입니다. 두 어시스턴트는 해당 Component가 선언하는 model 소켓을 선언합니다. 이 소켓은 모델 또는 모델 API를 제공하는 게이트웨이를 허용하며, 바인딩되지 않은 채로 둡니다. 각 Release가 이를 연결합니다.
세 가지 Releases
Releases는 각 어시스턴트의 모델 트래픽이 어느 게이트웨이를 거치는지만 다릅니다.
| Release | 클레임 어시스턴트의 트래픽 | 헬프데스크 어시스턴트의 트래픽 | 빌드 |
|---|---|---|---|
release-masked.yaml | masking-gateway 경유 | plain-gateway 경유 | 완료됨 |
release-unmasked.yaml | plain-gateway 경유 | plain-gateway 경유 | 중단됨 |
release-masking-off-route.yaml | plain-gateway 경유 | masking-gateway 경유 | 중단됨 |
각 Release는 두 어시스턴트의 model 소켓을 Aggregate가 선언한 게이트웨이에 바인딩합니다. 이는 Component가 선언한 소켓 안에서의 엣지 연결이며,
Release가 할 수 있는 작업입니다. 컴포넌트를 추가하지도 않고 값을 변경하지도 않습니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example policy-data-class-route그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd policy-data-class-route빌드
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pullaggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1같은 규칙을 다른 엔진에서 실행하려면 governance-rego.yaml을 governance-cel.yaml 또는 governance-opa.yaml로
바꿉니다.
--config는 해당 실행에 사용할 전역 구성 파일을 지정합니다. 이 파일은
머신이 원래 읽었을 파일, 즉 AGGREGA_CONFIG가
지정하는 파일이나 기본 위치의 파일 대신 읽히며, 이 워크스페이스 자체의 .aggrega-config.yaml은
여전히 그 위에 덧씌워집니다. 따라서 해당 실행에서는 자신의 전역
파일에 둔 내용이 하나도 적용되지 않습니다. 다른 거버넌스 연결, default_registry, 오프라인
설정 등이 그렇습니다. aggrega login으로 저장한 자격 증명은 그 파일에 속하지 않으므로
여전히 적용됩니다. 워크스페이스 파일은 카탈로그 디렉터리를 선언하며 자체
거버넌스 연결은 선언하지 않습니다. 워크스페이스 파일이 목록을 선언하면 지정된 파일의 목록을
대체하므로, 실행되는 것은 지정된 파일의 연결입니다.
거버넌스 정책은 Release가 아니라 구성을 통해 연결됩니다. Release에는 이를 위한 필드가 없습니다. 그래서 엔진은 Release별이 아니라 빌드별로 선택됩니다.
첫 빌드 전에 두 가지가 준비되어 있어야 합니다.
- 표준 라이브러리 카탈로그.
.aggrega-config.yaml은 이 워크스페이스 자체의catalog/를 나열하는데, 여기에는 claims 어시스턴트와 OPA 엔진의 Plugin 엔티티가 들어 있습니다. Rego와 CEL 엔진의 Plugin 엔티티를 포함한 나머지 모두는 아래의 hub 레지스트리에서, 또는--catalog로 지정한 카탈로그 체크아웃에서 해석됩니다. - 허브 레지스트리. 데이터 마스킹 실현은 컴파일러에도 카탈로그에도 포함되지 않은 플러그인 하나, 즉 게이트웨이 구성 단계인
pipeline-step/litellm-gateway-config를 통해 가드레일을 작성하며, 빌드는 이를default_registry가 지정하는 레지스트리hub.aggrega.ai에서 가져옵니다.
--auto-pull은 빌드 중에 각 Release의 lockfile을 채웁니다. lockfile과
렌더링된 출력은 생성되는 것이며 함께 배포되지 않습니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. Workspace 폴더에 아직 `policy-data-class-route` 폴더가 없으면 `example`을 `policy-data-class-route`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `policy-data-class-route` 폴더에 예제가 작성됩니다. 그런 다음 `aggrega build`를 실행하고 그 `--config` 플래그를 받는 `cli-build` 도구를 각 Release마다 `release-masked.yaml`, `release-unmasked.yaml`, `release-masking-off-route.yaml` 순서로 한 번씩 호출하되, 매번 `workspace_root`를 `policy-data-class-route`로, `release`를 해당 파일로, `auto_pull`을 true로, `config`를 `governance-rego.yaml`로 설정하십시오. 두 번째와 세 번째는 거부되도록 의도된 것이므로 각 거부 내용을 읽어 주십시오. 첫 번째 빌드가 작성한 파일을 알려 주십시오. 파일은 `policy-data-class-route/dist/` 아래에 있습니다.중단
각 엔진에서의 release-unmasked.yaml입니다. Rego 엔진:
[… omitted: the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "rego" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violationCEL 엔진:
[… omitted: the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "cel" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violationOPA:
[… omitted: a warning that the OPA guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "opa" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them caused by: policy violation빌드는 1로 종료되며 dist/를 쓰지 않습니다. 정책은 무엇이든 렌더링되기 전에 빌드 그래프에 대해 평가됩니다. E0005는 정책 거부가 갖는 진단입니다. 진단 레퍼런스를 참조하십시오.
release-masking-off-route.yaml도 각 엔진에서 같은 거부를 출력합니다.
이 문장을 정책이 찾아낸 경로로 읽으십시오. assistant는 restricted 데이터를 보유합니다. 그 모델 트래픽은
plain-gateway를 거쳐, 정책이 public으로 분류하는 gpt에 도달하며, 그 경로상의 어느 것도(어시스턴트도, 게이트웨이도,
모델도) 정책이 기밀 해제로 간주하는 Feature를 갖고 있지 않습니다. 서로 다른 등급의 두 분류가
사이에 아무것도 없이 한 경로에서 만나므로, 정책은 빌드를 거부합니다.
pull 역시 고정해야 할 외부 입력을 찾기 위해 Release를 렌더링하며, 그 과정에서 같은 거부를 만납니다. 위에서 생략된 줄에 이 문장이 한 번 더 나오는 이유가 이것입니다. 잠금 파일은 그래도 작성됩니다.
충족하기: 경로 위의 마스킹 게이트웨이
release-masked.yaml은 청구 어시스턴트를 masking-gateway를 거치도록 라우팅하며, 모든 엔진이 빌드를 허용합니다. 여기서 <workspace>는 이 예제의 폴더를 나타냅니다:
[… omitted: the pull's lines, a lint notice, under OPA a warning that its guest runs unverified, and the total build time]Build completed: 17 files written to <workspace>/dist이제 마스킹 게이트웨이는 청구 어시스턴트가 모델에 이르는 유일한 경로 위에 있으며, 정책은 그곳에서 이를 읽습니다. 즉 그 경로 위에서, 등급이 달라지는 지점 또는 그 이전에, 어떤 컴포넌트가 정책의 declassifying_features 설정에 나열된 유형의 attachment를 가지고 있습니다. 경로는 렌더링된 출력에서 읽을 수 있습니다. dist/helm/assistant-deployment.yaml은 청구 어시스턴트를 마스킹 게이트웨이로 보내고, dist/helm/helpdesk-deployment.yaml은 헬프데스크를 일반 게이트웨이로 보냅니다.
# dist/helm/assistant-deployment.yaml, the env of the assistant's containerenv: [… omitted: the recursion limit] - name: OPENAI_BASE_URL value: http://masking-gateway-default:4000/v1 [… omitted: the alias, the checkpointer's address and the graph's entrypoint]# dist/helm/helpdesk-deployment.yaml, the env of the helpdesk's containerenv: [… omitted: the recursion limit] - name: OPENAI_BASE_URL value: http://plain-gateway-default:4000/v1 [… omitted: the alias, the checkpointer's address and the graph's entrypoint]마스킹 자체는 마스킹 게이트웨이의 구성, 즉 dist/helm/masking-gateway/litellm-gateway-config/configmap.yaml의 config.yaml 키에 있습니다:
[… omitted: the routing table]litellm_settings: callbacks: - /etc/litellm-request-guard/request_field_filter.filter turn_off_message_logging: trueguardrails: - guardrail_name: masking-gateway-masking litellm_params: default_on: true guardrail: litellm_content_filter mode: pre_call patterns: - action: MASK name: claim_number pattern: "\\bCLM-[0-9]{8}\\b" pattern_type: regex skip_tool_message_in_guardrail: true [… omitted: three more guardrail entries masking the same pattern and the two entity types, and the request guard's settings]일반 게이트웨이의 구성에는 guardrail 항목이 전혀 없습니다.
정책은 렌더링되는 내용을 전혀 바꾸지 않습니다. 각 엔진의 release-masked 트리는 정책을 연결하지 않고 빌드한 같은 Release와 바이트 단위로 동일합니다. 정책은 verdict 역할인 ir-verdict 역할에 연결됩니다. 이 역할은 수락 또는 거부를 반환하며, verdict를 디스패치하는 경로에는 이를 변경으로 적용할 방법이 없습니다. 따라서 그곳의 정책은 빌드를 중단시킬 수는 있지만 빌드를 규정에 맞게 다시 작성할 수는 없습니다.
정책은 마스킹이 경로 위에 연결되어 있는지를 검사할 뿐, 무엇을 마스킹하는지는 검사하지 않습니다. 누구의 데이터와도 일치하지 않는 패턴을 나열한 attachment도 이 attachment와 마찬가지로 정책을 충족합니다. 마스킹 attachment가 무엇을 나열하는지는 attachment를 작성하는 곳에서 내리는 해당 환경 자체의 판단입니다.
Releases가 첨부가 아니라 경로를 옮기는 이유
Release는 Feature를 첨부할 수 있지만, Release에 작성된 첨부는
values를 가지지 않으며, core/data-masking은 마스킹 대상인 patterns와 entities를
values에 두고 둘 다 나열하지 않는 첨부는 중단시킵니다. 그래서 마스킹은
Aggregate에서 masking-gateway에 첨부되며, 세 빌드 모두의 그래프에
포함됩니다:
release-masked.yaml에서는 청구 어시스턴트의 경로 위에 있으며, 빌드가 완료됩니다;release-unmasked.yaml에서는 어떤 어시스턴트의 경로 위에도 없으며, 빌드가 중단됩니다;release-masking-off-route.yaml에서는 헬프데스크의 경로 위에 있으며, 빌드가 다시 중단됩니다.
두 번째와 세 번째 빌드는 같은 첨부를 가지며, 그 첨부가 누구의 경로 위에 있는지만 다릅니다. 둘 다 중단되므로, 정책은 빌드의 첨부 수를 세는 것이 아니라 경로를 읽고 있습니다.
정책이 읽는 것
이 모두는 컴파일러가 ir-verdict 첨부에 넘겨주는 빌드 그래프에서 오며, 그 의미는 모두 첨부의 설정에서 옵니다.
- 컴파일러가 열거하는 경로,
input.precalculated_paths: 각각은uses엣지로 연결된 컴포넌트의 순서 있는 목록입니다.release-unmasked.yaml에서는 그중 하나가assistant → plain-gateway → gpt입니다. 정책은 각 경로를 첫 번째 컴포넌트부터 읽으며, 컴파일러가 모든 컴포넌트에서 출발하는 경로를 열거하므로 이것으로 충분합니다. 정책 자체는 아무것도 열거하지 않습니다. - 각 컴포넌트의 클래스. 컴포넌트가
class_label이 지정하는 레이블compliance.aggrega.ai/data-class를 지니는 경우 그 값입니다. 이 레이블을 지니는 것은assistant뿐이며, 값은restricted입니다. 그렇지 않으면, 컴포넌트가 지니는 레이블과 값이 일치하는 첫 번째classes_by_label항목의 클래스입니다. - 각 컴포넌트의 첨부,
input.graph.spec.feature_values_mapping. 경로 자체의attached_features목록은 의도적으로 읽지 않습니다. 이 목록은 경로 어디에든 첨부된 모든 Feature를 나열하므로, 해당 두 컴포넌트 사이에 하나가 있는지는 알려 줄 수 없습니다.
클래스가 없는 컴포넌트는 건너뜁니다. 경로가 그려진 방향(연결은 요청을 한쪽으로, 응답을 다른 쪽으로 전달합니다)과, 설정이 같은 순위로 매기는 클래스들도 마찬가지로 고려하지 않습니다.
모델의 클래스는 호스팅 레이블에서 옵니다. gpt는 클래스 레이블을 지니지 않습니다.
그 Component인 core/ai-model/openai는 component.aggrega.ai/hosting: managed를 지니는데, 이는 서비스가 클러스터 외부에서 제공자에 의해 운영된다는 카탈로그의 진술이며, 설정은 이를 클래스로 매핑합니다.
classes_by_label: - label: component.aggrega.ai/hosting value: managed class: public관리형 모델은 전송된 모든 것을 보유하며, 이 환경에서는 이를 공개로 취급합니다.
core/ai-model/vllm 같은 자체 호스팅 모델과 여기의 두 게이트웨이는 대신 self-hosted를 지니므로, 클래스가 없습니다.
경로는 제한됩니다. 컴파일러는 각 시작 컴포넌트에서 제한된 수의 경로를 나열하고 그 한도를 넘는 것은 나열하지 않으므로, 그보다 많은 경로가 있는 그래프에서는 어떤 경로가 읽히지 않은 채 빌드가 통과할 수 있습니다. 정책이 읽는 경로는 실재하지만, 경로가 없다는 것이 그 경로가 존재하지 않는다는 증거는 아닙니다. 판정 역할을 참조하십시오.
클래스는 컴파일러가 아니라 정책의 것입니다
컴파일러는 compliance.aggrega.ai/data-class를 문자열로 빌드 그래프에 전달하며 그 안에서 어떤 의미도 읽어 내지 않습니다. 컴파일러는 restricted가 public보다 더 민감하다는 것도, 두 단어 중 어느 것이 무언가를 의미한다는 것도 알지 못합니다. 클래스와 그 순위는 정책의 설정이며, 세 엔진 파일 모두에서 동일합니다:
class_label: compliance.aggrega.ai/data-classrank: public: 0 internal: 1 restricted: 2자체 어휘를 가진 환경은 자체 어휘로 대체합니다: rank 아래에는 자체 클래스와 그 순서를, class_label 아래에는 클래스를 담아 두는 레이블을, classes_by_label 아래에는 파생 규칙을, declassifying_features 아래에는 등급 해제로 인정하는 Features를 둡니다. 세 엔진 파일을 모두 똑같이 변경해야 합니다. 파일 간의 차이는 곧 엔진 판정 간의 차이이기 때문입니다. 컴포넌트가 가진 클래스 중 rank에 나열되지 않은 클래스는 클래스 없음으로 읽히지 않고 빌드를 중단시키므로, 철자 오류는 통과되지 않고 보고됩니다. 청구 어시스턴트의 레이블을 Restricted로 작성하면 모든 엔진이 release-masked.yaml를 거부합니다. aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull은 아래의 거부 메시지를 출력하며, 다른 각 엔진의 파일도 해당 엔진의 이름을 머리에 단 동일한 메시지를 출력합니다:
[… omitted: under OPA a warning that its guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret][POLICY_ERROR E0005] policy plugin "rego" rejected the build: assistant carries the data class "Restricted", which the policy's rank setting does not list; correct the class or rank it caused by: policy violation클래스는 표준 라이브러리의 Component가 아니라 이 워크스페이스 자체의 Component가 가집니다. 어시스턴트가 제한된 데이터를 다루는지는 LangGraph에 관한 진술이 아니라 환경이 그것을 어떻게 사용하는지에 관한 진술이므로, local/ai-agent/claims-assistant는 core/ai-agent/langgraph를 확장하여 그 계약을 상속하고 레이블 하나를 추가합니다. Aggregate는 컴포넌트 인스턴스에 레이블을 붙일 수 없으므로, 클래스는 항상 인스턴스가 선언된 Component의 속성입니다. 청구 어시스턴트를 대신 표준 라이브러리 에이전트로 선언하면 어떤 컴포넌트도 클래스 레이블을 가지지 않으며, release-unmasked.yaml는 모든 엔진에서 빌드되고 그 결과는 정책이 없을 때 빌드되는 것과 바이트 단위로 동일합니다. 모델은 여전히 public을 파생하지만, 그 클래스가 마주칠 두 번째 클래스가 없습니다.
세 엔진, 세 번 작성된 규칙
| 엔진 | 연결 방식 | 규칙 |
|---|---|---|
| CLI에 컴파일되어 포함된 Rego 엔진 | governance-rego.yaml | with.sources 아래에 지정된 policies/data-class-paths.rego |
| CLI에 컴파일되어 포함된 CEL 엔진 | governance-cel.yaml | with.sources 아래에 지정된 policies/data-class-paths.cel |
| 참조 어댑터 게스트 뒤의 OPA | governance-opa.yaml | 게스트에 컴파일되어 포함된 policies/data-class-paths-opa.rego |
세 사본은 의도적으로 거의 중복되어 있습니다. 각 사본은 규칙을 바탕으로 따로 작성되었으므로, 엔진 간에 판정이 엇갈리는 빌드는 그 불일치를 드러냅니다. 같은 빌드가 한 엔진에서는 중단되고 다른 엔진에서는 완료되는 것이 그 신호입니다. 어느 사본도 다른 사본에서 생성되지 않으며, 하나의 공유 구현으로 병합해서도 안 됩니다. 병합하면 엔진들이 구조상 같은 판정을 내리게 되어, 이 구성이 잡아내려는 차이가 가려지기 때문입니다. 각 파일의 첫머리에 이 점이 적혀 있습니다.
사본들은 엔진이 서로 다른 지점에서 차이가 납니다.
- CEL 사본은 이름을 값에 바인딩하거나 목록의 위치를 순회할 수 없으므로,
설정에 항목이 하나 더 있습니다. 바로 경로의 구성 요소를 읽는 위치 0부터 15까지를 담은
positions입니다. 이보다 긴 경로는 일부만 읽히는 대신, 시작 지점을 명시하며 빌드를 중단합니다. - OPA 사본은 OPA 자체 도구 체인으로 미리 컴파일되어
catalog/plugin/governance/opa/1.0.0/plugin.yaml옆의 게스트에 내장되므로, 해당 연결은 설정만 제공하고 정책 파일은 제공하지 않습니다. 어댑터는 OPA가 호스트에 맡기는 내장 함수를 하나도 제공하지 않으므로, Rego 엔진의 사본이sprintf로 메시지를 서식화하는 곳에서 이 사본은concat으로 메시지를 연결합니다. 이 사본을 수정해도 아래에서 설명하는 대로 게스트를 다시 빌드하기 전까지는 어떤 빌드도 바뀌지 않습니다.
Rego와 CEL 연결은 CLI에 컴파일되어 들어간 두 엔진을 위해 표준 라이브러리 카탈로그가 담고 있는 Plugin 엔티티인 governance/rego:0.9.0와 governance/cel:0.9.0를 지정하며, 실제로 실행되는 엔진은 빌드를 실행하는 바이너리에 컴파일되어 들어간 엔진입니다. catalog/plugin/governance/에 있는 OPA의 Plugin 엔티티는 이 워크스페이스 자체의 버전 1.0.0 선언이므로, 그 연결은 governance/opa:1.0.0을 지정합니다. 거부 메시지의 머리글은 연결 참조의 마지막 세그먼트에서 버전을 뺀 것으로, policy plugin "rego", "cel" 또는 "opa"입니다. 각 빌드는 엔진 하나를 연결하므로, 빌드가 출력하는 거부 메시지에는 그 엔진의 이름이 나옵니다. OPA 게스트는 빌드할 때마다 엔티티 옆에서 읽히며, 그 다이제스트를 기록하는 곳이 없으므로 이를 사용하는 모든 빌드는 검증되지 않은 상태로 실행된다는 경고를 출력합니다.
모든 빌드 검사하기
이 자체 점검은 사용하는 공유 빌드 헬퍼가 들어 있는 문서 저장소의 체크아웃에서 실행됩니다. aggrega scaffold --example로 작성된 사본에는 그 헬퍼가 없습니다.
./check.shcheck.sh는 세 Releases를 세 엔진으로 ./build-release.sh를 통해
빌드하고, 각 결과를 이 페이지가 설명하는 결과와 대조합니다. 중단은 위의 문장을
메시지로 하는 E0005와 함께 0이 아닌 상태로 종료해야 하며, 그 밖의 다른 거부가 함께 있어서는
안 됩니다. 완료된 빌드는 0으로 종료하고, 정책 없이 빌드한 같은 Release와 바이트 단위로
동일한 파일을 써야 하며, 이 Release는 기준으로 삼기 위해 먼저 빌드합니다. 모든 엔진은
같은 문장을 기준으로 검사됩니다. 빌드마다 한 줄을 출력하고, 어느 결과라도 다르면 해당
빌드의 출력을 표시하고 1로 종료합니다:
ENGINE RELEASE EXIT EXPECTED VERDICT------------------------------------------------------------------------------------------none release-masked.yaml 0 reference OKrego release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyrego release-unmasked.yaml 1 halt OK: E0005, the expected sentencerego release-masking-off-route.yaml 1 halt OK: E0005, the expected sentencecel release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policycel release-unmasked.yaml 1 halt OK: E0005, the expected sentencecel release-masking-off-route.yaml 1 halt OK: E0005, the expected sentenceopa release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyopa release-unmasked.yaml 1 halt OK: E0005, the expected sentenceopa release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
check: every build ended as expected.단일 빌드에 필요한 것이 그대로 필요합니다. 즉 표준 라이브러리 카탈로그와 허브 레지스트리입니다. ./build-release.sh가 결정하는 바이너리를 사용하므로 AGGREGA_BIN으로 선택할 수 있습니다. -- 뒤의 인수는 모든 빌드에 전달되므로, ./check.sh -- --offline은 가져오는 모든 것이 캐시된 뒤에는 네트워크 없이 실행됩니다. 빌드가 쓰는 트리를 비교하기 때문에 이 디렉터리에 dist/가 있으면 시작을 거부하며, 실행 후에는 아무것도 남기지 않습니다. 종료 상태가 판정의 전부이므로, 파이프라인은 각 Release를 개별적으로 빌드하는 대신 이것을 실행할 수 있습니다.
OPA 게스트 다시 빌드하기
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm은 플러그인 키트의 참조 OPA 어댑터 게스트, 즉 aggrega-pdk 저장소의 rust/examples/policy-opa-wasm이며, 어댑터 자체의 모듈 대신 OPA가 policies/data-class-paths-opa.rego에서 컴파일한 모듈을 담고 있습니다. 이 게스트는 afd9ac6c6800c34c6c47a2030f580c9681387047 시점의 aggrega-pdk와, 어댑터가 빌드 대상으로 삼는 ABI crate인 2ececa8d3b598243f023a2a6c80b351c8d1411a1 시점의 aggrega-abi로부터 rustc 1.97.1을 사용해, OPA 1.21.1이 컴파일한 모듈을 감싸 빌드되었습니다.
먼저 이 디렉터리에서 모듈을 빌드합니다. 규칙을 이 위치 기준의 상대 경로로 지정하면 모듈에는 그 경로만 남고 머신에 관한 정보는 남지 않습니다.
opa build -t wasm -e data_class_paths/deny policies/data-class-paths-opa.rego -o bundle.tar.gztar -xzf bundle.tar.gz -O /policy.wasm > policy.wasmrm bundle.tar.gzsha256sum policy.wasm# 321e8a1f150a7ef7625e174cf636967b6c0e1f7bd39c3b7fa1010838ce35c871 policy.wasmOPA 1.21.1은 이 작업 공간이 어느 디렉터리에 있든 같은 소스에서 같은 바이트를 컴파일합니다.
다음으로 게스트를 빌드합니다. 절대 경로로 지정한 임시 디렉터리 $BUILD에 두 저장소를 나란히 두어, 어댑터의 경로 의존성이 한 저장소에서 다른 저장소로 닿도록 합니다. 세 가지 경로 매핑은 빌드 디렉터리, cargo 홈, 툴체인 자체의 소스가 게스트에 들어가지 않도록 합니다.
mkdir -p "$BUILD/aggrega-pdk" "$BUILD/aggrega-abi"git -C <aggrega-pdk checkout> archive afd9ac6c6800c34c6c47a2030f580c9681387047 | tar -x -C "$BUILD/aggrega-pdk"git -C <aggrega-abi checkout> archive 2ececa8d3b598243f023a2a6c80b351c8d1411a1 | tar -x -C "$BUILD/aggrega-abi"cp policy.wasm "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm/policy.wasm"cd "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm"SRC="$(rustc +stable --print sysroot)/lib/rustlib/src/rust"HASH="$(rustc +stable -vV | awk '/^commit-hash: /{print $2}')"RUSTFLAGS="--remap-path-prefix=$BUILD=/build --remap-path-prefix=${CARGO_HOME:-$HOME/.cargo}=/cargo --remap-path-prefix=$SRC=/rustc/$HASH" \ CARGO_TARGET_DIR="$BUILD/target" \ cargo +stable build --locked --release --target wasm32-wasip1그런 다음 $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm을 catalog/plugin/governance/opa/1.0.0/governance--opa.wasm으로 복사합니다.
게스트는 cargo 빌드의 출력 그대로입니다. 어댑터 자체의 빌드 스크립트는 선택적인 크기 최적화 단계도 실행하지만, 여기서는 건너뜁니다. 이 단계는 게스트의 데이터를 다시 쓰며, 이 단계가 없으면 모듈이 게스트 안에 바이트 단위로 그대로 남습니다. 덕분에 게스트가 담고 있는 내용을 규칙이 컴파일된 결과와 대조해 확인할 수 있습니다.
python3 -c 'import sys; print(open(sys.argv[1], "rb").read() in open(sys.argv[2], "rb").read())' \ policy.wasm catalog/plugin/governance/opa/1.0.0/governance--opa.wasm# True게스트 자체의 바이트는 crate가 빌드된 디렉터리와 툴체인에도 의존하므로, 다른 곳에서 다시 빌드하면 sha256이 다른 동등한 게스트가 만들어집니다. 여기에 포함된 게스트의 sha256은 eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93입니다.
컴파일러가 해석하지 않는 부분
컴파일러는 클래스 레이블을 문자열로 빌드 그래프에 전달하고, Aggregate와 Releases가 선언한 uses 엣지를 따라 경로를 열거하며,
둘 다 정책에 넘깁니다. 컴파일러는 클래스의 순위를 매기지 않으며, managed가 데이터가 클러스터를 떠나 provider로 간다는 뜻임을 알지 못하고,
core/data-masking이 무언가를 숨긴다는 것도 알지 못합니다. 이러한 의미는 모두 정책의 설정이며, 그렇기 때문에
다른 클래스, 다른 레이블, 다른 비기밀화 Features를 가진 환경도 같은 메커니즘을 변경 없이 실행할 수 있습니다. 정책이 연결되는 소켓, 즉
역할, 페이로드, 판정 심각도에 대해서는
정책 소켓을 참조하고, 제품에서 정책이 차지하는 위치에 대해서는
거버넌스와 컴플라이언스를 참조하십시오.
파일
aggregate.yaml— 두 어시스턴트, 그 체크포인터, 두 게이트웨이, 모델과 인식기 쌍;masking-gateway에 부착된 마스킹; 어느 어시스턴트의model소켓도 바인딩되지 않습니다.manifest.yaml— 모든 컴포넌트 타입과 두 Feature 타입을 각각의 Kubernetes Recipes에, 클레임 어시스턴트를 기본 에이전트의 Recipe에 바인딩합니다. 세 Releases가 공유합니다.release-masked.yaml,release-unmasked.yaml,release-masking-off-route.yaml— 세 가지 라우팅과, 각 게이트웨이의 키를 읽어 오는 Secret입니다.catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml— 클래스 레이블이 추가된core/ai-agent/langgraph인 클레임 어시스턴트입니다.catalog/plugin/governance/opa/1.0.0/plugin.yaml— OPA 엔진의 Plugin 엔티티이며, 그 옆에 게스트governance--opa.wasm이 있습니다.policies/data-class-paths.rego,policies/data-class-paths.cel,policies/data-class-paths-opa.rego— 엔진마다 한 번씩 작성한 규칙입니다.governance-rego.yaml,governance-cel.yaml,governance-opa.yaml— 엔진마다 하나씩인--config파일로, 각각 같은 설정으로ir-verdict에 규칙을 부착합니다..aggrega-config.yaml— 카탈로그 검색 스택과 레지스트리이며, 거버넌스 부착은 없습니다.build-release.sh— Release 하나를 빌드하며, 이에 해당하는aggrega build명령을 출력합니다.check.sh— 아홉 개를 모두 빌드하고 각 결과를 확인합니다.