작성자가 쓴 하나의 리프를 기준으로 하는 정책
이 예제는 하나의 내부 규칙과, 그 규칙을 표현할 수 있게 해 주는 사실을 설명합니다.
자격 증명 슬롯은 채워질 수 있습니다. 다만 워크스페이스 자체의 소스에 자료를 직접 작성하는 방식으로 채워서는 안 됩니다.
변수 하나만 다른 두 release가 있습니다. 동일한 관리형 데이터베이스와 동일한 필수 자격 증명 슬롯을 두 개의 서로 다른 Features가 채웁니다. 하나는 개발자가 Aggregate에서 연결하고, 다른 하나는 운영자가 Release에서 연결합니다. 운영자가 작성한 정책은 하나를 거부하고 다른 하나를 허용합니다. 이 쌍을 실행해 볼 가치가 있는 이유는 두 연결 모두 비밀 자료를 다룬다는 점입니다. 따라서 이 규칙은 “이 연결이 민감한가?”라는 질문을 기준으로 작성할 수 없으며, 아래의 대조 정책은 그렇게 시도하면 어떤 일이 일어나는지 보여 줍니다.
정책 파일 두 개를 제외한 모든 것은 표준 라이브러리 카탈로그에서 가져오며, 거버넌스 Plugin 엔터티도 여기에 포함됩니다.
슬롯, 그리고 그 슬롯을 채울 수 있는 두 Features
core/datastore/mariadb는 필수 자격 증명 슬롯 하나를 선언합니다:
featuresSchema: root_password: required: true sensitive: true inject: [] description: Root database password. Recipe controls delivery (Black-Box).여기서 sensitive: true는 특정한 채움이 아니라 바인딩 지점에 대한 진술입니다. 이 슬롯을 바인딩하는 것은 무엇이든 비밀 자료를 다룹니다. inject: []는 전달을 닫습니다. 자격 증명이 어디로 갈지는 Recipe가 결정하며, 개발자가 지정하지 않습니다.
표준 라이브러리의 두 Features가 그 슬롯을 바인딩하며, 이 둘은 서로 반대되는 자격 증명 수명 주기를 모델링합니다:
| Feature | 자료의 소유자 | 연결이 작성하는 것 |
|---|---|---|
core/secret-value | 작성자가 제공합니다 | 두 개의 values 리프 — 아래 참조 |
core/generated-secret | 대상 엔진이 프로비저닝하고 교체합니다 | 없음. values를 선언하지 않습니다 |
core/secret-value는 두 리프를 비대칭적으로 선언하며, 이 비대칭이 이 예제의 핵심 전부입니다:
values: origin: { type: string, sensitive: true } key: { type: string, required: true, default: "value" }origin은 자료를 담으며 민감한 것으로 선언됩니다. key는 전달용 이름이며 의도적으로 표시하지 않았습니다. 키는 자료 자체가 아니라 자료가 어디에 있는지를 가리키며, 이 Feature를 구현하는 모든 Recipe는 이를 평문으로 렌더링합니다.
core/generated-secret는 values를 전혀 선언하지 않으므로 연결이 작성할 것이 없습니다. 이는 같은 것의 약한 버전이 아니라 엔진이 관리하는 대등한 짝입니다. 같은 자격 증명 계열 레이블을 지니고, 같은 슬롯을 바인딩하며, 그 Recipes는 아무것도 렌더링하지 않습니다. 자격 증명이 해당 컴포넌트 자체의 Recipe가 관리하는 엔진에 속하기 때문입니다.
두 릴리스
aggregate-authored.yaml은 작성자가 공급하는 방식으로 슬롯을 바인딩합니다. 개발자가 Aggregate에서 자격 증명을 연결하고, 그 연결은 리프 두 개 모두를 작성합니다.
features: root_password: type: core/secret-value values: key: MARIADB_ROOT_PASSWORD origin: root-password-in-the-clear위임된 쪽은 엔진이 관리하는 방식으로 슬롯을 바인딩하며, 그 바인딩은 운영자의 몫입니다. 엔진이 자격 증명을 소유하는지는 Manifest가 고르는 Recipe에 따라 정해지므로, release-delegated.yaml은 db 항목에 core/generated-secret을 연결하고, aggregate-delegated.yaml은 작성된 Aggregate에서 features: 블록을 뺀 것입니다.
components: db: features: root_password: type: core/generated-secret두 릴리스는 manifest.yaml을 공유하며, 이 파일은 Terraform 대상에 대해 세 타입을 모두 바인딩합니다. 따라서 두 릴리스가 달라지는 곳은 Manifest가 아닙니다.
components: type: core/datastore/mariadb:1.0.0: terraform/mariadb-rds:1.0.0 features: type: core/secret-value:1.0.0: terraform/variable-secret:1.0.0 core/generated-secret:1.0.0: terraform/generated-secret:1.0.0정책
빌드 그래프에 연결된 policy.rego:
package house.governance
import rego.v1
deny contains msg if { some node_id, attachments in input.graph.spec.feature_values_mapping some attachment_name, attachment in attachments some leaf in attachment.sensitive_payload_leaves msg := sprintf("%v: the %v credential carries declared-sensitive material in its payload at %v", [node_id, attachment_name, leaf])}sensitive_payload_leaves는 이 연결의 페이로드가 담고 있는 리프 중 연결된 Feature가 민감하다고 선언한 경로의 리프를 나열하며, 각 리프는 필러 접두사가 붙은 점 표기 경로로 표시됩니다. 읽는 페이로드는 연결이 최종적으로 담게 되는 페이로드이므로, Feature의 스키마가 default로 선언한 값에 놓인 리프도 작성자가 직접 작성한 리프와 함께 나열됩니다. 여기서 두 가지 결과가 나오며, 이 예제는 두 가지 모두를 다룹니다:
- 리프는 선언이 그 리프를 포함하는 경우에만 나타납니다. 즉 선언이 그 리프를 지정하거나, 그 리프를 포함하는 객체를 지정하는 경우이며, 점 표기 경로에 대해 세그먼트 단위로 일치 여부를 판단합니다. 경로 자체의 텍스트에서는 아무것도 읽지 않으며 어떤 값도 검사하지 않습니다. 따라서 같은 연결에서
origin옆에 작성된key는 결코 나타나지 않습니다. 해당 Feature가 그에 대해 아무것도 선언하지 않기 때문입니다. - 선언된 리프에 아무것도 담지 않은 페이로드를 가진 연결은 목록에 아무것도 추가하지 않습니다. 위임 release의 연결은 연결 전체에 대한 답만 담고 리프별 목록은 전혀 담지 않습니다. 키가 비어 있게 될 경우 와이어에서 생략되기 때문입니다.
연결은 .aggrega-config.yaml의 ir-verdict 역할에 있으며, 이 역할이 빌드 그래프를 받는 역할입니다:
plugins: governance: - uri: governance/rego:0.9.0 role: ir-verdict with: sources: - policy.rego판정 역할은 수락 또는 거부만 반환하며 그 외에는 아무것도 반환하지 않습니다. 이 빌드를 중단시킬 수는 있지만, Aggregate를 규정에 맞게 다시 작성할 수는 없습니다. 판정을 전달하는 경로에는 판정을 변경으로 적용할 방법이 없기 때문입니다. 위임 형태를 원하는 Release는 위임 Feature를 연결하여 그 형태를 얻습니다. 정책이 몰래 대체해 주는 방식은 결코 없습니다.
둘 다 빌드하기
aggrega build --release release-negative-authored.yaml --auto-pull # expected to failaggrega build --release release-delegated.yaml --auto-pull--auto-pull은 빌드 중에 lockfile을 채웁니다. 빌드 전에 aggrega pull --release release-<arm>.yaml을 한 번 실행해도 같은 일을 하며, 이후 빌드는 플래그 없이 실행할 수 있습니다. 렌더링된 출력과 lockfile은 배포되는 것이 아니라 생성되는 것입니다.
이 예제는 입력만 커밋하고 나머지는 모두 다시 생성합니다.
돌아오는 결과
직접 작성한 release는 거부되고, 빌드는 1로 종료합니다. E0005는
정책 거부에 붙는 진단입니다.
진단 참조를 참조하십시오:
[… omitted: the pull's lines — the same refusal among them — and a lint notice about core/secret-value][POLICY_ERROR E0005] policy plugin "rego" rejected the build: db: the root_password credential carries declared-sensitive material in its payload at values.origin caused by: policy violation리프 경로를 읽어 보십시오. 이 첨부의 페이로드에는 두 값이 있지만, 거부는
values.origin을 지목하고 values.key는 언급하지 않습니다. 이 한 문장이
리프별 표시가 제 역할을 하는 모습입니다. 첨부 하나, 페이로드 리프 둘, 선언 하나,
거부 하나입니다.
거부는 또한 무엇이든 렌더링되기 전에 일어납니다. dist/infra-authored/
디렉터리는 아예 생성되지 않으므로, 정리해야 할 부분적인 아티팩트 트리도 없고
이후 단계가 출력으로 오인할 만한 것도 디스크에 남지 않습니다.
위임된 release는 빌드되어 0으로 종료하고 두 파일을 씁니다.
첫째는 경계의 루트 구성인
dist/infra-delegated/terraform/aggrega.modules.tf입니다:
# Root configuration for this boundary. Each component rendered here is one# module block below, and the directory that block points at holds that# component's own files. One configuration means one dependency graph, which is# what lets a reference or a depends_on reach from one component to another.
module "db" { source = "./modules/db"}둘째는 dist/infra-delegated/terraform/modules/db/main.tf로, 빌드를 식별하는
# 주석 블록으로 시작한 다음 AWS provider 제약, 리소스, 그리고 Recipe가
게시하는 주소 출력을 담습니다:
terraform { required_providers { aws = { source = "hashicorp/aws" version = "~> 6.69" } }}
resource "aws_db_instance" "db" { identifier = "db" engine = "mariadb" engine_version = "11.4" port = 3306
## ── Compute ────────────────────────────────────────────── instance_class = "db.t3.small"
## ── Storage ────────────────────────────────────────────── allocated_storage = 100 storage_type = "gp3"
## ── Database ───────────────────────────────────────────── db_name = "appdb" username = "admin"
## Black-Box: RDS manages the password via Secrets Manager. manage_master_user_password = true
## ── HA ─────────────────────────────────────────────────── multi_az = false
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 7
## ── Provider-specific overrides ──────────────────────────}
output "address" { value = aws_db_instance.db.address}manage_master_user_password = true는 위임된 형태가 출력에 나타난 것입니다. 엔진이 자격 증명을 보관하며, Release는 어디에서도 비밀 자료를 명시하지 않습니다. 허용된 release는 아무것도 렌더링하지 않아서 통과한 것이 아니라 실제 아티팩트를 렌더링했습니다.
대조군: 대신 첨부 전체에 대한 질문을 하는 경우
.aggrega-config.yaml에서 첨부된 소스를 바꿉니다:
sources: - policy-attachment-wide.regopolicy-attachment-wide.rego는 리프별 목록 대신 attachment.sensitive
— 첨부 전체에 대한 하나의 불리언 — 를 기준으로 하는 동일한 순회입니다:
deny contains msg if { some node_id, attachments in input.graph.spec.feature_values_mapping some attachment_name, attachment in attachments attachment.sensitive msg := sprintf("%v: the %v credential handles sensitive material", [node_id, attachment_name])}두 release를 모두 다시 빌드합니다. 이 페이지의 나머지 부분은 policy.rego를 전제로 하므로
이후에 다시 원래대로 되돌려 놓습니다. 이제 둘 다 거부되며, 같은 문장이 출력됩니다:
[… omitted: the pull's lines — the same refusal among them — and a lint notice about core/secret-value][POLICY_ERROR E0005] policy plugin "rego" rejected the build: db: the root_password credential handles sensitive material caused by: policy violation이는 규칙이 오작동한 것이 아니라, 규칙이 더 거친 질문을 받고
그 질문에 올바르게 답한 것입니다. sensitive는 엔터티가 선언한 내용을 읽습니다. 여기서
이 값이 참인 이유는 슬롯이 자신에 바인딩되는 것은 무엇이든 비밀 자료를 다룬다고 선언하기 때문이며,
슬롯은 누가 채우든 그렇게 말합니다. 위임된 첨부는
아무것도 작성하지 않지만 여전히 민감하므로, 이 답을 기준으로 하는 규칙은 두 release를
전혀 구분할 수 없습니다. 위임된 release는 리프별
규칙은 허용하지만 첨부 전체 규칙으로는 허용할 방법이 없는 빌드입니다.
세 번째 민감도 사실인 sensitive_inject도 도움이 되지 않습니다. 이 사실은
참조하는 provides 키가 민감하다고 선언된 전달 키를 지목합니다. 여기서는
슬롯이 전달 폐쇄형이고 작성자가 제공하는 Feature가
provides 기둥을 게시하지 않으므로, 이 워크스페이스에서는 아무것도 지목하지 않습니다. 세 가지 사실 중에서
“이 첨부의 페이로드가 어디에 데이터를 담고 있는가”에 답하는 것은 리프별 목록뿐이며,
이것이 바로 내부 규칙이 다루는 내용입니다.
세 가지 사실을 페이로드 형태 및 각 사실이 올바른 질문이 되는 경우와 함께 나란히 보려면 거버넌스 정책이 읽는 첨부 사실을 참조하십시오. 소켓 자체 — 역할, 판정 심각도, 운영자 입력 채널 — 에 대해서는 정책 소켓을, 제품에서 정책이 차지하는 위치에 대해서는 거버넌스와 컴플라이언스를 참조하십시오.
이 대상이 작성된 형식에 대해 드러내는 것
managed-database Recipe는 엔진 자체의 관리형 비밀번호 지시문을 무조건 설정하고 주입된 자격 증명을 읽지 않으므로, 이 대상에서는 들어갈 곳이 없는 자료를 받아들이는 대신 작성된 첨부 자체에 대해 슬롯을 명시하며 빌드를 중단합니다. 정책은 그보다 먼저 그 자료가 실제로 있는 곳에서 거부합니다. 즉 워크스페이스가 버전 관리 아래에 두는 파일 안입니다. 그것이 거버넌스의 관심사이며, 어떤 Recipe가 무엇을 렌더링했을지와는 별개의 문제입니다.
두 Features가 모든 대상에서 동등한 위상의 대안이 아니라 대등한 짝인 이유도 여기에 있습니다. 자격 증명을 실제로 보유하는 곳에는 author-supplied Feature를 바인딩하고, 대상이 자격 증명을 소유하는 곳에는 engine-managed Feature를 바인딩합니다. 이 예제의 작성된 release는 하우스 규칙이 기계적으로 잡아낼 수 있는 불일치입니다.
플러그인의 출처
이 워크스페이스가 사용하는 모든 엔터티는 게시된 표준 라이브러리 카탈로그에서 옵니다. Component, 두 Features, Recipe, 두 FeatureRecipes, 그리고 거버넌스 Plugin 엔터티입니다. 이들은 .aggrega-config.yaml이 지정하는 허브 레지스트리에서 읽거나, --catalog로 지정한 카탈로그 체크아웃(얻는 방법)에서 읽습니다.
uri: governance/rego:0.9.0는 그 Plugin 엔터티를 가리킵니다. 이것은 식별자입니다. <pluginType>/<name> 좌표와 버전으로 이루어지며, 두 부분 모두 형식의 일부입니다. 버전은 플러그인이 게시된 버전입니다. 허브는 이를 oci://hub.aggrega.ai/plugin/governance/rego:0.9.0로 게시합니다. 버전은 해석에 관여합니다. 어떤 카탈로그 디렉터리에도, 어떤 레지스트리에도, aggrega 바이너리 자체에도 없는 버전을 지정한 연결은 빌드를 중단시킵니다. 바이너리는 자신의 릴리스 버전의 엔진 엔터티만 담고 있습니다.
--catalog로 카탈로그 체크아웃을 지정해 빌드하면 예제에는 다른 것이 필요하지 않습니다. 연결이 지정하는 릴리스의 aggrega 바이너리는 Plugin 엔터티 자체를 담고 있으므로 모든 엔터티는 네트워크 없이 해석되며, 실행되는 엔진은 aggrega 바이너리에 컴파일되어 들어간 엔진입니다. 그렇지 않으면 엔터티는 hub.aggrega.ai에서 읽습니다.
Rego 엔진은 CLI 바이너리에 컴파일되어 들어가 있으며, 그 버전은 이를 함께 배포하는 컴파일러 릴리스입니다. 다른 릴리스의 컴파일러는 연결이 지정하는 Plugin 엔터티를 허브에서 읽고 자신에게 컴파일되어 들어간 엔진을 실행합니다. 연결의 버전은 엔터티를 식별할 뿐 엔진을 선택하지 않습니다.
파일
aggregate-authored.yaml— Aggregate에서core/secret-value로 바인딩된root_password슬롯으로, 전달 키와 자료를 직접 작성합니다.aggregate-delegated.yaml— 연결이 없는 동일한 데이터베이스입니다. 개발자는 아무것도 바인딩하지 않습니다.manifest.yaml— 컴포넌트 유형과 두 Feature 유형을 각각의 Terraform Recipes에 바인딩합니다. 두 릴리스가 공유합니다.release-negative-authored.yaml,release-delegated.yaml— 각 갈래마다 하나씩이며, 각각 고유한 경계directory:를 가집니다. 출력 위치를 지정하는 플래그가 없으므로, 두 릴리스가 한 디렉터리를 공유하면 두 번째가 첫 번째를 덮어씁니다.release-delegated.yaml은db항목에서core/generated-secret으로 슬롯도 바인딩하며, 아무것도 작성하지 않습니다. 어느 Feature가 슬롯을 채우는지, 그리고 어느 문서에서 채우는지가 두 갈래 사이의 유일한 차이입니다.policy.rego— 리프별 표시를 기준으로 하는 사내 규칙입니다.policy-attachment-wide.rego— 연결 전체에 대한 답을 기준으로 하는 대조군입니다. 기본적으로 연결되지 않습니다..aggrega-config.yaml— 기본 레지스트리와 거버넌스 연결입니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example policy-payload-leaf-sensitivity그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd policy-payload-leaf-sensitivity빌드
aggrega build --release release-negative-authored.yaml --auto-pull # refused; exits 1aggrega build --release release-delegated.yaml --auto-pull # buildsAI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. Workspace 폴더에 아직 `policy-payload-leaf-sensitivity` 폴더가 없으면 `example`을 `policy-payload-leaf-sensitivity`로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `policy-payload-leaf-sensitivity` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `policy-payload-leaf-sensitivity`로, `release`를 `release-negative-authored.yaml`로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 이 빌드는 거부되도록 의도된 것이므로 거부 내용을 읽어 주십시오. 이어서 같은 방식으로 `release`를 `release-delegated.yaml`로 설정하여 `build` 도구를 호출하십시오. 그 두 번째 빌드가 작성한 파일을 알려 주십시오. 파일은 `policy-payload-leaf-sensitivity/dist/` 아래에 있습니다.