Yazarın yazdığı tek yaprağa bağlı bir politika
Bu örnek, bir kurum kuralını ve onu ifade edilebilir kılan olguyu öğretir:
Bir kimlik bilgisi yuvası doldurulabilir. Ancak materyal çalışma alanının kendi kaynağına yazılarak doldurulamaz.
Tek bir değişkenle ayrışan iki sürüm: aynı yönetilen veritabanı, aynı zorunlu kimlik bilgisi yuvası; bu yuva iki farklı Features ile doldurulur — birini geliştirici Aggregate içinde, diğerini operatör Release içinde ekler. Operatörün yazdığı bir politika birini reddeder, diğerine izin verir. Bu çifti çalıştırmaya değer kılan, her iki eklemenin de gizli materyali işlemesidir — bu yüzden kural “bu ekleme hassas mı?” sorusuna göre yazılamaz; aşağıdaki kontrol politikası bunu denediğinizde ne olduğunu gösterir.
İki politika dosyası dışındaki her şey, yönetişim Plugin varlığı da dahil, standart kütüphane kataloğundan gelir.
Yuva ve onu doldurabilen iki Features
core/datastore/mariadb zorunlu bir kimlik bilgisi yuvası bildirir:
featuresSchema: root_password: required: true sensitive: true inject: [] description: Root database password. Recipe controls delivery (Black-Box).Oradaki sensitive: true, herhangi bir belirli doldurma hakkında değil, bağlama noktası hakkında bir ifadedir: bu yuvayı her ne bağlarsa gizli materyali işler. inject: [] teslimatı kapatır — kimlik bilgisinin nereye gideceğine Recipe karar verir ve geliştirici bunu belirlemez.
Bu yuvayı iki standart kütüphane Features’ı bağlar ve bunlar birbirine zıt kimlik bilgisi yaşam döngülerini modeller:
| Feature | materyalin sahibi kim | bir ekleme neyi yazar |
|---|---|---|
core/secret-value | bir yazar sağlar | iki values yaprağı — aşağıya bakın |
core/generated-secret | hedef motor onu sağlar ve döndürür | hiçbir şey; hiç values bildirmez |
core/secret-value iki yaprağını asimetrik olarak bildirir ve bu asimetri, bu örneğin tüm dayanak noktasıdır:
values: origin: { type: string, sensitive: true } key: { type: string, required: true, default: "value" }origin materyali taşır ve hassas olarak bildirilir. key bir teslimat adıdır ve bilerek işaretsiz bırakılır — bir anahtar, materyalin kendisi olmak yerine materyalin nerede bulunduğunu adlandırır ve bu Feature’ı uygulayan her Recipe onu açık metin olarak işler.
core/generated-secret hiç values bildirmez, dolayısıyla bir eklemenin yazacağı hiçbir şey yoktur. Aynı şeyin daha zayıf bir sürümü değil, motor tarafından yönetilen eşdeğeridir: aynı kimlik bilgisi ailesi etiketini taşır, aynı yuvayı bağlar ve Recipes’ı hiçbir şey işlemez; çünkü kimlik bilgisi, bileşenin kendi Recipe’sinin yönettiği motora aittir.
İki sürüm
aggregate-authored.yaml, yuvayı yazar tarafından sağlanan yolla bağlar: geliştirici kimlik bilgisini Aggregate içinde ekler ve ek, yaprakların ikisini de yazar:
features: root_password: type: core/secret-value values: key: MARIADB_ROOT_PASSWORD origin: root-password-in-the-clearDevredilen kol yuvayı motor tarafından yönetilen yolla bağlar ve bu bağlama operatöre aittir: kimlik bilgisinin motora ait olup olmadığı, Manifest’in seçtiği Recipe’ten çıkar; bu nedenle release-delegated.yaml, db için olan girdisinde core/generated-secret ekler ve aggregate-delegated.yaml, features: bloğu olmadan yazılmış Aggregate’tir:
components: db: features: root_password: type: core/generated-secretHer iki sürüm de üç türün tamamını Terraform hedefi için bağlayan manifest.yaml dosyasını paylaşır; dolayısıyla ikisinin ayrıştığı yer Manifest değildir:
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.0Politika
Derleme grafiğine bağlanan 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, bu bağlamanın yükünün taşıdığı ve yolunu bağlanan Feature’ın hassas olarak bildirdiği yaprakları, her birini sütun önekli noktalı bir yol olarak listeler. Okunan yük, bağlamanın sonunda taşıdığı yüktür; bu nedenle Feature’ın şemasının default olarak bildirdiği bir değerde duran bir yaprak, bir yazarın o konuma yazdığı bir yaprakla birlikte adlandırılır. Bunun iki sonucu vardır ve örnek her ikisine dayanır:
- Bir yaprak yalnızca bir bildirimin onu kapsadığı yerde görünür: bildirim o yaprağı ya da onu içeren bir nesneyi adlandırır ve eşleştirme noktalı yol üzerinde bölüt bölüt yapılır. Yolun kendi metninden hiçbir şey okunmaz ve hiçbir değer incelenmez. Bu nedenle aynı bağlamada
origin’in yanına yazılankeyhiçbir zaman görünmez: Feature’ı onun hakkında hiçbir şey bildirmez. - Yükü bildirilmiş bir yaprakta hiçbir şey taşımayan bir bağlama, listeye hiçbir şey katmaz. Devredilen release’in bağlaması bağlamanın tamamına ilişkin yanıtı taşır ve yaprak başına hiçbir liste taşımaz; çünkü anahtar boş olacağı durumda iletimden çıkarılır.
Bağlama, .aggrega-config.yaml içinde, derleme grafiğini alan rol olan ir-verdict rolünde yer alır:
plugins: governance: - uri: governance/rego:0.9.0 role: ir-verdict with: sources: - policy.regoBir karar rolü yalnızca kabul ya da ret döndürür, başka hiçbir şey döndürmez. Bu derlemeyi durdurabilir; ancak Aggregate’i uyumlu hâle getirmek için yeniden yazamaz, çünkü bir kararı ileten yolun onu bir değişiklik olarak uygulamasının hiçbir yolu yoktur. Devredilen biçimi isteyen bir Release bunu devredilen Feature’ı bağlayarak elde eder; hiçbir zaman bir politikanın sessizce onu yerine koymasıyla değil.
İkisini de derleyin
aggrega build --release release-negative-authored.yaml --auto-pull # expected to failaggrega build --release release-delegated.yaml --auto-pull--auto-pull derleme sırasında kilit dosyasını doldurur; önceden bir kez çalıştırılan aggrega pull --release release-<arm>.yaml aynı işi yapar ve sonraki derlemelerin bayrak olmadan çalışmasını sağlar. İşlenmiş çıktı ve kilit dosyaları üretilir, birlikte dağıtılmaz:
bu örnek yalnızca girdilerini commit eder ve geri kalan her şeyi yeniden üretir.
Ne geri döner
Yazarın yazdığı release reddedilir ve derleme 1 ile çıkar. E0005, bir politika reddinin taşıdığı tanılamadır; bkz.
tanılama başvurusu:
[… 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 violationYaprak yolunu okuyun. Eklentinin yükü iki değer taşır; ret
values.origin değerini adlandırır ve values.key değerinden söz etmez. Bu tek cümle,
yaprak başına işaretlemenin işini yapmasıdır: bir ekleme, iki yük yaprağı, bir
bildirim, bir ret.
Ret ayrıca herhangi bir şey işlenmeden önce gelir. dist/infra-authored/
dizini hiç oluşturulmaz; bu nedenle temizlenecek kısmi bir yapıt ağacı ve
diskte sonraki bir adımın çıktı sanabileceği hiçbir şey yoktur.
Devredilmiş release derlenir, 0 ile çıkar ve iki dosya yazar.
Sınırın kök yapılandırması olan
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"}ve derlemeyi tanımlayan bir # yorum bloğuyla açılan, ardından AWS provider
kısıtını, kaynağı ve Recipe’in yayımladığı adres çıktısını taşıyan
dist/infra-delegated/terraform/modules/db/main.tf:
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, devredilmiş biçimin çıktıya ulaşmasıdır: kimlik bilgisini motor tutar ve Release hiçbir yerde gizli malzeme adlandırmaz. İzin verilen release, hiçbir şey işlemeyerek geçmek yerine gerçek bir yapıt işledi.
Kontrol: bunun yerine tüm eklemeye ilişkin soruyu sormak
.aggrega-config.yaml içinde eklenen kaynağı değiştirin:
sources: - policy-attachment-wide.regopolicy-attachment-wide.rego, yaprak başına listeye değil attachment.sensitive
üzerine kurulu aynı dolaşımdır; bu, tüm ekleme için tek bir boolean değerdir:
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])}Her iki release’i yeniden derleyin ve ardından policy.rego dosyasını geri koyun, çünkü bu
sayfanın geri kalanı onu varsayar. Artık her ikisi de reddedilir ve aynı cümle verilir:
[… 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 violationBu, kuralın yanlış tetiklenmesi değildir; kurala daha kaba bir soru sorulmuş ve kural
onu doğru yanıtlamıştır. sensitive, varlıkların bildirdiğini okur: burada doğrudur,
çünkü slot, kendisine bağlanan her şeyin gizli materyal işlediğini bildirir ve slot
bunu onu kimin doldurduğundan bağımsız olarak söyler. Devredilen ekleme hiçbir şey
yazmaz ve yine de hassastır; bu nedenle bu yanıta dayanan bir kural iki release’i
hiçbir şekilde ayıramaz. Devredilen release, yaprak başına kuralın izin verdiği ve
tüm ekleme kuralının izin vermesinin hiçbir yolu olmayan bir derlemedir.
Üçüncü hassasiyet olgusu olan sensitive_inject de yardımcı olmaz: başvurulan
provides anahtarı hassas olarak bildirilmiş teslim anahtarlarını adlandırır. Burada
slot teslime kapalıdır ve yazar tarafından sağlanan Feature hiçbir
provides sütunu yayımlamaz; bu nedenle bu çalışma alanında hiçbir şey adlandırmaz. Üç olgudan
yalnızca yaprak başına liste “bu eklemenin yükü veriyi nerede taşır” sorusunu yanıtlar;
kurum kuralının konusu da budur.
Üç olgunun yan yana, yük biçimleriyle ve her birinin doğru soru olduğu durumlarla birlikte gösterimi için bkz. bir yönetişim politikasının okuduğu ekleme olguları. Soketin kendisi (roller, karar önem dereceleri, operatör girdi kanalı) için bkz. politika soketi; politikanın üründeki yeri için bkz. Yönetişim ve uyumluluk.
Bu hedefin yazılmış biçim hakkında görünür kıldıkları
Yönetilen veritabanı Recipe’i, motorun kendi yönetilen parola yönergesini koşulsuz olarak ayarlar ve enjekte edilmiş hiçbir kimlik bilgisini okumaz; bu nedenle bu hedefte, düşebileceği bir yer olmayan materyali kabul etmek yerine, yazılmış eklentinin kendisinde yuvayı adlandırarak derlemeyi durdurur. İlke onu daha önce, gerçekte bulunduğu yerde reddeder: çalışma alanının sürüm denetimi altında tuttuğu bir dosyada. Yönetişim kaygısı budur ve herhangi bir Recipe’in ne işleyeceğinden ayrı bir konudur.
İki Features’ın her hedefte eşit konumdaki alternatifler değil de eşdüzeyliler olmasının nedeni de budur. Yazar tarafından sağlanan Feature’ı kimlik bilgisini gerçekten sizin tuttuğunuz yerde, motor tarafından yönetileni ise hedefin ona sahip olduğu yerde bağlayın. Bu örneğin yazılmış release’i, bir kurum kuralının mekanik olarak yakalayabileceği uyumsuzluktur.
Plugin nereden gelir
Bu çalışma alanının kullandığı her varlık yayımlanmış standart kütüphane kataloğundan gelir: Component, iki Features, Recipe, iki FeatureRecipes ve yönetişim Plugin varlığı — .aggrega-config.yaml dosyasının adlandırdığı hub kayıt defterinden ya da --catalog ile belirtilen bir katalog checkout’undan (nereden edinilir) okunur.
uri: governance/rego:0.9.0 o Plugin varlığını adlandırır. Bu bir kimliktir: bir <pluginType>/<name> koordinatı artı bir sürüm; her iki yarı da biçimin parçasıdır. Sürüm, plugin’in yayımlandığı sürümdür — hub onu oci://hub.aggrega.ai/plugin/governance/rego:0.9.0 olarak yayımlar. Sürüm çözümlemede rol oynar: hiçbir katalog dizininin, hiçbir kayıt defterinin ve aggrega ikili dosyasının kendisinin de taşımadığı bir sürümü adlandıran bir ekleme derlemeyi durdurur. İkili dosya, motorun varlığını yalnızca kendi sürümünün sürüm numarasında taşır.
Kataloğun bir checkout’unu belirten --catalog ile derlendiğinde örneğin başka hiçbir şeye ihtiyacı yoktur: eklentinin adlandırdığı sürümün, Plugin varlığının kendisini taşıyan aggrega ikili dosyasıyla her varlık ağ olmadan çözümlenir ve çalışan motor aggrega ikili dosyasına derlenmiş olandır. Bu bayrak olmadan varlıklar hub.aggrega.ai üzerinden okunur.
Rego motoru CLI ikili dosyasına derlenmiştir ve sürümü, onu birlikte sunan derleyici sürümüdür. Başka bir sürümün derleyicisi, eklentinin adlandırdığı Plugin varlığını hub’dan okur ve kendisine derlenmiş motoru çalıştırır: eklentideki sürüm varlığı tanımlar, motoru seçmez.
Dosyalar
aggregate-authored.yaml— Aggregate içindecore/secret-valueile bağlananroot_passwordyuvası; teslim anahtarını ve materyali yazar belirler.aggregate-delegated.yaml— ekleme içermeyen aynı veritabanı: geliştirici hiçbir şey bağlamaz.manifest.yaml— bileşen türünü ve her iki Feature türünü Terraform Recipes’e bağlar. Her iki release tarafından paylaşılır.release-negative-authored.yaml,release-delegated.yaml— her kol için bir tane; her biri kendi sınırdirectory:değerine sahiptir. Çıktı konumu için bir bayrak yoktur, bu nedenle tek bir dizini paylaşan iki release’te ikincisi birincinin üzerine yazar.release-delegated.yamlayrıca yuvayı,dbgirdisinde, hiçbir şey yazmadancore/generated-secretile bağlar. Yuvayı hangi Feature’ın ve hangi belgede doldurduğu, iki kol arasındaki tek farktır.policy.rego— yaprak başına işarete göre anahtarlanan kurum kuralı.policy-attachment-wide.rego— tüm ekleme yanıtına göre anahtarlanan kontrol. Varsayılan olarak eklenmez..aggrega-config.yaml— varsayılan kayıt defteri ve yönetişim eklemesi.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example policy-payload-leaf-sensitivityArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd policy-payload-leaf-sensitivityDerleme
aggrega build --release release-negative-authored.yaml --auto-pull # refused; exits 1aggrega build --release release-delegated.yaml --auto-pull # buildsBir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Workspace klasöründe henüz `policy-payload-leaf-sensitivity` klasörü yoksa, `scaffold` aracını `example` değeri `policy-payload-leaf-sensitivity` olacak şekilde ve `dir` olmadan bir kez çağırın: örneği yeni bir `policy-payload-leaf-sensitivity` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `policy-payload-leaf-sensitivity`, `release` değeri `release-negative-authored.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın: bu derlemenin reddedilmesi amaçlanmıştır, bu yüzden reddi bana okuyun. Sonra `build` aracını aynı şekilde, `release` değeri `release-delegated.yaml` olacak biçimde çağırın. Bu ikinci derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `policy-payload-leaf-sensitivity/dist/` altındadır.