Kebijakan yang bertumpu pada satu-satunya leaf yang ditulis oleh penulis
Contoh ini mengajarkan satu aturan internal beserta fakta yang membuatnya dapat diungkapkan:
Slot kredensial boleh diisi. Slot itu tidak boleh diisi dengan menuliskan materialnya ke dalam sumber workspace itu sendiri.
Dua release yang berbeda satu variabel: basis data terkelola yang sama, slot kredensial wajib yang sama, diisi oleh dua Features yang berbeda — satu dilampirkan oleh developer di Aggregate, yang lain dilampirkan oleh operator di Release. Sebuah kebijakan yang ditulis operator menolak yang satu dan mengizinkan yang lain. Yang membuat pasangan ini layak dijalankan adalah bahwa kedua lampiran menangani material rahasia — sehingga aturannya tidak dapat ditulis berdasarkan pertanyaan “apakah lampiran ini sensitif?”, dan kebijakan kontrol di bawah menunjukkan apa yang terjadi ketika Anda mencobanya.
Semuanya kecuali dua berkas kebijakan berasal dari katalog pustaka standar, termasuk entitas Plugin tata kelola.
Slot, dan dua Features yang dapat mengisinya
core/datastore/mariadb mendeklarasikan satu slot kredensial wajib:
featuresSchema: root_password: required: true sensitive: true inject: [] description: Root database password. Recipe controls delivery (Black-Box).sensitive: true di sana adalah pernyataan tentang titik pengikatan, bukan tentang
pengisian tertentu mana pun: apa pun yang mengikat slot ini menangani materi rahasia. inject: [] menutup pengiriman — Recipe yang menentukan ke mana kredensial dikirim, dan
pengembang tidak mendiktekannya.
Dua Features pustaka standar mengikat slot tersebut, dan keduanya memodelkan siklus hidup kredensial yang berlawanan:
| Feature | siapa pemilik materinya | apa yang ditulis oleh sebuah lampiran |
|---|---|---|
core/secret-value | seorang penulis menyediakannya | dua leaf values — lihat di bawah |
core/generated-secret | mesin target menyediakan dan merotasinya | tidak ada; Feature ini tidak mendeklarasikan values |
core/secret-value mendeklarasikan dua leaf-nya secara asimetris, dan asimetri itulah
poros utama contoh ini:
values: origin: { type: string, sensitive: true } key: { type: string, required: true, default: "value" }origin membawa materi dan dideklarasikan sensitif. key adalah nama
pengiriman dan sengaja dibiarkan tanpa tanda — sebuah key menamai di mana materi berada,
bukan materi itu sendiri, dan setiap Recipe yang mengimplementasikan Feature ini
merendernya tanpa disamarkan.
core/generated-secret sama sekali tidak mendeklarasikan values, sehingga tidak ada yang perlu
ditulis oleh sebuah lampiran. Feature ini adalah padanan yang dikelola mesin, bukan versi yang lebih lemah
dari hal yang sama: ia membawa label keluarga kredensial yang sama, mengikat slot
yang sama, dan Recipes-nya tidak merender apa pun, karena kredensial tersebut milik
mesin yang dikelola oleh Recipe milik komponen itu sendiri.
Dua rilis
aggregate-authored.yaml mengikat slot tersebut dengan cara yang dipasok penulis: pengembang
melampirkan kredensial di dalam Aggregate, dan lampiran tersebut menulis kedua
leaf:
features: root_password: type: core/secret-value values: key: MARIADB_ROOT_PASSWORD origin: root-password-in-the-clearCabang yang didelegasikan mengikatnya dengan cara yang dikelola mesin, dan pengikatan itu adalah milik
operator: apakah mesin memiliki kredensial tersebut ditentukan oleh Recipe yang
dipilih Manifest, sehingga release-delegated.yaml melampirkan core/generated-secret pada
entrinya untuk db, dan aggregate-delegated.yaml adalah Aggregate yang ditulis
tanpa blok features:-nya:
components: db: features: root_password: type: core/generated-secretKedua rilis menggunakan manifest.yaml yang sama, yang mengikat ketiga tipe untuk
target Terraform, sehingga Manifest bukanlah tempat keduanya berbeda:
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.0Kebijakan
policy.rego, dipasang pada graf build:
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 mencantumkan daun-daun yang dibawa payload lampiran ini yang jalurnya dinyatakan sensitif oleh Feature yang dilampirkan, masing-masing sebagai jalur bertitik dengan awalan pilar. Payload yang dibaca adalah payload yang pada akhirnya dibawa lampiran tersebut, sehingga daun yang berada pada nilai yang dinyatakan skema Feature sebagai default disebutkan bersama daun yang ditulis oleh penulis. Ada dua konsekuensi, dan contoh ini bergantung pada keduanya:
- Sebuah daun hanya muncul jika suatu deklarasi mencakupnya — deklarasi tersebut menyebut daun itu, atau menyebut objek yang memuatnya, dicocokkan per segmen pada jalur bertitik. Tidak ada yang dibaca dari teks jalur itu sendiri dan tidak ada nilai yang diperiksa. Jadi
key, yang ditulis di sampingorigindalam lampiran yang sama, tidak pernah muncul: Feature-nya tidak menyatakan apa pun tentangnya. - Lampiran yang payload-nya tidak membawa apa pun pada daun yang dideklarasikan tidak menyumbangkan apa pun ke daftar. Lampiran pada release terdelegasi membawa jawaban untuk seluruh lampiran dan sama sekali tanpa daftar per daun, karena kunci tersebut dihilangkan dari wire ketika isinya akan kosong.
Lampiran tersebut berada di .aggrega-config.yaml pada peran ir-verdict, yaitu peran yang menerima graf build:
plugins: governance: - uri: governance/rego:0.9.0 role: ir-verdict with: sources: - policy.regoPeran verdict mengembalikan terima-atau-tolak dan tidak ada yang lain. Peran ini dapat menghentikan build ini; peran ini tidak dapat menulis ulang Aggregate agar patuh, karena jalur yang mengirimkan verdict tidak memiliki cara untuk menerapkannya sebagai perubahan. Release yang menginginkan bentuk terdelegasi mendapatkannya dengan melampirkan Feature terdelegasi — tidak pernah melalui kebijakan yang diam-diam menggantikannya.
Membangun keduanya
aggrega build --release release-negative-authored.yaml --auto-pull # expected to failaggrega build --release release-delegated.yaml --auto-pull--auto-pull mengisi lockfile selama build; menjalankan aggrega pull --release release-<arm>.yaml sekali sebelumnya melakukan hal yang sama dan memungkinkan build berikutnya berjalan
tanpa flag. Keluaran hasil render dan lockfile dihasilkan, bukan disertakan:
contoh ini meng-commit masukannya dan menghasilkan ulang semua yang lain.
Apa yang dihasilkan
Release yang ditulis langsung ditolak, dan build keluar dengan kode 1. E0005 adalah
diagnostik yang dibawa oleh penolakan policy — lihat
referensi diagnostik:
[… 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 violationBaca jalur leaf-nya. Payload attachment tersebut membawa dua nilai; penolakan
itu menyebut values.origin dan tidak menyebut values.key. Satu kalimat itu
adalah penandaan per-leaf yang menjalankan tugasnya — satu attachment, dua leaf payload, satu
deklarasi, satu penolakan.
Penolakan itu juga terjadi sebelum apa pun di-render. Direktori dist/infra-authored/
sama sekali tidak dibuat, sehingga tidak ada pohon artefak parsial yang perlu dibersihkan
dan tidak ada apa pun di disk yang dapat dikira sebagai output oleh langkah berikutnya.
Release yang didelegasikan berhasil di-build, keluar dengan kode 0, dan menulis dua file.
dist/infra-delegated/terraform/aggrega.modules.tf, konfigurasi root
batas tersebut:
# 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"}dan dist/infra-delegated/terraform/modules/db/main.tf, yang diawali dengan
blok komentar # yang mengidentifikasi build, lalu memuat batasan
provider AWS, resource, dan output alamat yang dipublikasikan oleh 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 adalah bentuk yang didelegasikan yang muncul di output: engine yang menyimpan kredensial, dan Release tidak menyebut material apa pun di mana pun. Release yang diizinkan me-render artefak nyata, bukan lolos karena tidak me-render apa pun.
Kontrol: mengajukan pertanyaan tingkat seluruh lampiran sebagai gantinya
Tukar sumber yang dilampirkan di .aggrega-config.yaml:
sources: - policy-attachment-wide.regopolicy-attachment-wide.rego adalah penelusuran yang sama, tetapi berpatokan pada attachment.sensitive
— satu boolean untuk seluruh lampiran — alih-alih pada daftar per leaf:
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])}Bangun ulang kedua rilis — lalu kembalikan policy.rego setelahnya, karena bagian lain
halaman ini mengasumsikannya. Keduanya kini ditolak, dengan kalimat yang sama:
[… 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 violationItu bukan aturan yang salah bekerja — itu adalah aturan yang diberi pertanyaan yang lebih kasar
dan menjawabnya dengan benar. sensitive membaca apa yang dideklarasikan oleh entitas: nilainya
true di sini karena slot mendeklarasikan bahwa apa pun yang mengikatnya menangani material
rahasia, dan slot menyatakan hal itu siapa pun yang mengisinya. Lampiran yang didelegasikan
tidak menulis apa pun dan tetap sensitif, sehingga aturan yang berpatokan pada jawaban itu sama sekali tidak dapat
memisahkan kedua rilis. Rilis yang didelegasikan adalah build yang diizinkan oleh aturan per leaf
dan tidak mungkin diizinkan oleh aturan tingkat seluruh lampiran.
Fakta sensitivitas ketiga, sensitive_inject, juga tidak membantu: fakta ini menyebutkan
kunci pengiriman yang kunci provides rujukannya dideklarasikan sensitif. Di sini
slot tertutup untuk pengiriman dan Feature yang disediakan penulis tidak menerbitkan pilar
provides, sehingga pada workspace ini fakta tersebut tidak menyebutkan apa pun. Dari ketiga fakta,
hanya daftar per leaf yang menjawab “di mana payload lampiran ini membawa data”,
yang merupakan inti aturan internal tersebut.
Untuk ketiga fakta secara berdampingan, beserta bentuk payload dan kasus ketika masing-masing merupakan pertanyaan yang tepat, lihat fakta lampiran yang dibaca kebijakan tata kelola. Untuk soket itu sendiri — peran, tingkat keparahan putusan, saluran input operator — lihat soket kebijakan, dan untuk posisi kebijakan dalam produk, Tata Kelola dan Kepatuhan.
Apa yang diperlihatkan target ini tentang bentuk yang ditulis sendiri
Recipe managed-database menetapkan direktif kata sandi terkelola milik mesin itu sendiri secara tanpa syarat dan tidak membaca kredensial yang diinjeksikan, sehingga pada target ini ia menghentikan build pada lampiran yang ditulis itu sendiri, dengan menyebutkan slotnya, alih-alih menerima materi yang tidak memiliki tempat. Kebijakan menolaknya lebih dahulu, di tempat materi itu sebenarnya berada: di dalam berkas yang disimpan workspace di bawah kontrol versi. Itulah persoalan tata kelola, dan itu merupakan hal yang terpisah dari apa pun yang akan dirender oleh Recipe mana pun.
Hal ini juga menjadi alasan mengapa kedua Features tersebut setara, bukan alternatif dengan kedudukan yang sama di setiap target. Ikat Feature yang disediakan penulis di tempat Anda benar-benar memegang kredensialnya, dan Feature yang dikelola mesin di tempat target yang memilikinya. Release yang ditulis sendiri dalam contoh ini adalah ketidakcocokan yang dapat dideteksi secara mekanis oleh aturan internal.
Asal plugin
Setiap entitas yang digunakan workspace ini berasal dari katalog pustaka standar yang dipublikasikan: Component, kedua Features, Recipe, kedua FeatureRecipes, dan entitas Plugin tata kelola — dibaca dari registri hub yang disebutkan .aggrega-config.yaml, atau dari checkout katalog (cara mendapatkannya) yang disebutkan melalui --catalog.
uri: governance/rego:0.9.0 menamai entitas Plugin tersebut. Ini adalah identitas: sebuah koordinat <pluginType>/<name> ditambah versi, dan kedua bagian tersebut merupakan bagian dari bentuknya. Versinya adalah versi tempat plugin dipublikasikan — hub mempublikasikannya sebagai oci://hub.aggrega.ai/plugin/governance/rego:0.9.0. Versi tersebut ikut serta dalam resolusi: lampiran yang menamai versi yang tidak dimuat oleh direktori katalog mana pun, registri mana pun, maupun biner aggrega itu sendiri akan menghentikan build. Biner hanya memuat entitas mesin pada versi rilisnya sendiri.
Jika di-build dengan --catalog yang menyebutkan checkout katalog, contoh ini tidak memerlukan apa pun lagi: dengan biner aggrega dari rilis yang disebutkan lampiran, yang memuat entitas Plugin itu sendiri, setiap entitas diresolusi tanpa jaringan, dan mesin yang berjalan adalah mesin yang dikompilasi ke dalam biner aggrega. Tanpanya, entitas-entitas tersebut dibaca dari hub.aggrega.ai.
Mesin Rego dikompilasi ke dalam biner CLI, dan versinya adalah rilis kompiler yang menyertakannya. Kompiler dari rilis lain membaca entitas Plugin yang disebutkan lampiran dari hub dan menjalankan mesin yang dikompilasi ke dalam dirinya: versi di lampiran mengidentifikasi entitas, dan tidak memilih mesin.
Berkas
aggregate-authored.yaml— slotroot_passwordyang diikat olehcore/secret-valuedi dalam Aggregate, yang menulis kunci pengiriman dan materialnya.aggregate-delegated.yaml— basis data yang sama tanpa lampiran: pengembang tidak mengikat apa pun.manifest.yaml— mengikat tipe komponen dan kedua tipe Feature ke Recipes Terraform masing-masing. Digunakan bersama oleh kedua rilis.release-negative-authored.yaml,release-delegated.yaml— satu untuk setiap cabang, masing-masing dengandirectory:batasnya sendiri. Tidak ada flag untuk lokasi keluaran, sehingga dua rilis yang berbagi satu direktori akan membuat rilis kedua menimpa rilis pertama.release-delegated.yamljuga mengikat slot tersebut, pada entrinya untukdb, dengancore/generated-secret, tanpa menulis apa pun. Feature mana yang mengisi slot, dan di dokumen mana, adalah satu-satunya perbedaan antara kedua cabang.policy.rego— aturan internal, yang didasarkan pada penandaan per daun.policy-attachment-wide.rego— kontrol, yang didasarkan pada jawaban untuk seluruh lampiran. Tidak dilampirkan secara default..aggrega-config.yaml— registri bawaan dan lampiran tata kelola.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example policy-payload-leaf-sensitivityKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd policy-payload-leaf-sensitivityBuild
aggrega build --release release-negative-authored.yaml --auto-pull # refused; exits 1aggrega build --release release-delegated.yaml --auto-pull # buildsDengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder Workspace belum berisi folder `policy-payload-leaf-sensitivity`, panggil alat `scaffold` sekali dengan `example` diatur ke `policy-payload-leaf-sensitivity` dan tanpa `dir`: alat ini menulis contoh ke folder `policy-payload-leaf-sensitivity` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `policy-payload-leaf-sensitivity`, `release` diatur ke `release-negative-authored.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true: build ini memang dimaksudkan untuk ditolak, jadi bacakan penolakannya kepada saya. Kemudian panggil alat `build` dengan cara yang sama dengan `release` diatur ke `release-delegated.yaml`. Beri tahu saya file apa saja yang ditulis build kedua itu; file-file itu ada di bawah `policy-payload-leaf-sensitivity/dist/`.