İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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:

Featuremateryalin sahibi kimbir ekleme neyi yazar
core/secret-valuebir yazar sağlariki values yaprağı — aşağıya bakın
core/generated-secrethedef motor onu sağlar ve döndürürhiç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-clear

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

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

Politika

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ılan key hiç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.rego

Bir 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

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

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

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

Bu, 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çinde core/secret-value ile bağlanan root_password yuvası; 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ır directory: 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.yaml ayrıca yuvayı, db girdisinde, hiçbir şey yazmadan core/generated-secret ile 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:

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

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd policy-payload-leaf-sensitivity

Derleme

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

Bir 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.