Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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:

Featuresiapa pemilik materinyaapa yang ditulis oleh sebuah lampiran
core/secret-valueseorang penulis menyediakannyadua leaf values — lihat di bawah
core/generated-secretmesin target menyediakan dan merotasinyatidak 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-clear

Cabang 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-secret

Kedua 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.0

Kebijakan

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 samping origin dalam 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.rego

Peran 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

Terminal window
aggrega build --release release-negative-authored.yaml --auto-pull # expected to fail
aggrega 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 violation

Baca 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.rego

policy-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 violation

Itu 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 — slot root_password yang diikat oleh core/secret-value di 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 dengan directory: batasnya sendiri. Tidak ada flag untuk lokasi keluaran, sehingga dua rilis yang berbagi satu direktori akan membuat rilis kedua menimpa rilis pertama. release-delegated.yaml juga mengikat slot tersebut, pada entrinya untuk db, dengan core/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:

Terminal window
aggrega scaffold --example policy-payload-leaf-sensitivity

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd policy-payload-leaf-sensitivity

Build

Terminal window
aggrega build --release release-negative-authored.yaml --auto-pull # refused; exits 1
aggrega build --release release-delegated.yaml --auto-pull # builds

Dengan 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/`.