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

Fakta lampiran yang dibaca oleh kebijakan tata kelola

Plugin tata kelola yang dipasang pada peran ir-verdict menerima seluruh grafik build, dan setiap lampiran Feature dalam build ikut tiba bersamanya. Setiap lampiran membawa sekumpulan fakta tetap tentang dirinya: Feature mana yang disebutnya, slot mana yang diisinya, koneksi mana tempat lampiran itu ditulis jika memang ditulis pada suatu koneksi, FeatureRecipe mana yang merealisasikannya, apa yang dideklarasikan oleh penulis katalog tentangnya, apa yang ditulis oleh seorang penulis ke dalamnya, dan apakah lampiran itu menangani materi yang dideklarasikan sensitif oleh seseorang. Satu hal tidak tiba sebagaimana ditulis: nilai yang dideklarasikan sensitif oleh penulis tiba dalam keadaan ditahan — lihat Nilai yang dideklarasikan sensitif tiba dalam keadaan ditahan.

Halaman ini menguraikan fakta-fakta tersebut dan menjelaskan apa yang dinyatakan dan tidak dinyatakan oleh masing-masing fakta. Untuk soket itu sendiri — keempat peran, tingkat keparahan verdict, saluran input operator, dan dua mesin kebijakan yang disertakan di dalam kompiler — lihat policy-socket.md. Untuk tabel per bidang beserta tipe dan status wajibnya, lihat referensi skema grafik yang dihasilkan; halaman ini mengajarkan cara membaca fakta-fakta tersebut, dan halaman itulah kontraknya.

Letak lampiran dalam payload

Lampiran tergantung pada graf build di bawah feature_values_mapping, dengan kunci id node lalu nama instans yang diberikan penulis untuk setiap lampiran:

input.graph.spec.feature_values_mapping[<node id>][<attachment name>]

Nama lampiran memiliki fungsi nyata, bukan sekadar hiasan. Nama itu adalah kunci yang digunakan penulis untuk mengisi slot, sehingga nama itu pula yang dipasangkan oleh kompilator dengan slot yang dideklarasikan Component induknya.

Lampiran yang ditulis pada salah satu koneksi sebuah komponen — di bawah features: pada entri uses, di dalam Aggregate atau di dalam Release — merupakan salah satu lampiran komponen pengguna, sehingga lampiran itu berada di wadah yang sama, pada node komponen pengguna. Kuncinya adalah nama yang diberikan kompilator, yaitu alias koneksi dan slot yang digabungkan dengan titik: gpt.credential untuk slot credential dari koneksi yang ditulis dengan alias gpt. Titik tidak pernah muncul dalam nama yang ditulis penulis, sehingga kunci itu tidak pernah sama dengan nama salah satu lampiran milik node itu sendiri. Namun, kebijakan tidak membaca koneksi dari kunci: entri membawanya sebagai data, dalam connection di bawah.

package security
import rego.v1
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.binding == "free"
msg := sprintf("%v carries attachment %v, which fills no declared slot.", [node_id, name])
}

Hanya ir-verdict yang melihat fakta-fakta ini. Kebijakan render-verdict menerima artefak yang telah dirender dan tidak menerima graf; kebijakan label-transform menerima proyeksi label dan nilai node, dengan nilai yang dideklarasikan sensitif ditahan seperti di sini, yang sama sekali tidak membawa lampiran; kebijakan annotation-transform menerima komponen yang boleh dianotasinya. Aturan yang membaca fakta lampiran harus ditempatkan di ir-verdict, dan memindahkannya ke peran lain menghasilkan aturan yang tidak pernah terpicu alih-alih galat, karena path yang tidak ada hanya bernilai tidak terdefinisi.

Satu wadah, setiap keluarga lampiran

Setiap lampiran pada sebuah node berada dalam wadah yang sama, apa pun yang dihasilkan oleh Feature-nya — Feature operasional, Feature kredensial, Feature identitas. Tidak ada keluarga yang mendapatkan proyeksi lebih sempit daripada yang lain, sehingga kebijakan yang menelusuri wadah tersebut melihat semuanya dan tidak pernah perlu mengetahui keluarga mana yang sedang dilihatnya sebelum dapat membaca suatu fakta.

Identitas: type dan resolved_version

type adalah URI dari Feature katalog yang dinamai oleh lampiran tersebut. resolved_version adalah versi persis yang ditetapkan oleh resolusi untuk build ini. Keduanya selalu ada.

Metadata katalog, dibawa apa adanya: labels dan catalog_annotations

labels adalah metadata.labels milik entitas Feature yang dilampirkan itu sendiri. catalog_annotations adalah metadata.annotations milik entitas tersebut. Keduanya dibawa dalam urutan yang dideklarasikan oleh entitas katalog, dan tidak satu pun yang disaring, dinormalisasi, atau dihapus prefiksnya — sebuah kunci dalam namespace milik penulis katalog sendiri tiba persis seperti yang ditulis, dan kompiler tidak membaca satu pun darinya.

Pembawaan apa adanya itulah yang memungkinkan sebuah kebijakan didasarkan pada label yang tidak perlu diketahui keberadaannya oleh kompiler. Penulis katalog yang menandai Features kredensial dengan label ciptaannya sendiri dapat menulis aturan terhadap label tersebut secara langsung.

Masing-masing tidak ada pada lampiran ketika Feature tidak mendeklarasikan apa pun, dan ketika type-nya tidak merujuk ke entitas katalog mana pun.

catalog_annotations menjelaskan entitas yang dinamai oleh lampiran. Ini adalah pertanyaan yang berbeda dari annotation_key dan annotation_source di bawah, yang menjelaskan bagaimana lampiran tersebut muncul. Lampiran yang ditulis dalam blok features: membawa anotasi katalog tanpa membawa satu pun dari dua lainnya.

Slot mana yang diisi attachment: binding

binding memiliki tiga jawaban, dan jawaban ketiga bukan varian dari jawaban kedua:

NilaiArti
sebuah nama slotAttachment mengisi slot attachment yang dideklarasikan dengan nama tersebut.
freeAttachment tidak mengisi slot yang dideklarasikan mana pun. Ini adalah temuan positif: himpunan slot berhasil di-resolve dan tidak ada slot yang dideklarasikan yang membawa nama ini.
tidak adaHimpunan slot yang dideklarasikan oleh Component host tidak dapat di-resolve, sehingga slot mana yang diisi tidak diketahui.

Dari himpunan slot yang dideklarasikan mana nama tersebut berasal bergantung pada tempat attachment ditulis. Attachment pada blok milik node itu sendiri mengisi slot yang dideklarasikan Component host dalam featuresSchema miliknya sendiri. Attachment yang ditulis pada sebuah koneksi — yang membawa connection di bawah — mengisi slot yang dideklarasikan oleh socket koneksi tersebut, dalam featuresSchema socket itu pada Component host. Jadi nilai yang sama, credential, menamai slot dari Component pada satu attachment dan slot dari sebuah socket pada attachment lain, dan connection itulah yang membedakan keduanya.

Pemasangan dilakukan berdasarkan nama — sebuah attachment mengisi slot ketika Feature dipasang di bawah nama slot tersebut, pada blok komponen atau pada koneksi — sehingga nilainya adalah kunci yang persis dari himpunan slot yang dideklarasikan. Tidak ada yang dibaca dari kunci attachment: attachment sebuah koneksi memiliki kunci gpt.credential dan melaporkan credential. Nama slot dibawa alih-alih sekadar flag karena slot mana yang diisi adalah separuh jawaban yang lebih berguna.

Attachment yang ditulis pada sebuah koneksi tidak pernah melaporkan free. Slot-slot sebuah socket adalah satu-satunya nama yang boleh dibawa oleh koneksi melalui socket tersebut, dan koneksi yang membawa nama lain ditolak saat build dimuat, sehingga setiap attachment semacam itu dalam graf yang mencapai sebuah kebijakan mengisi slot yang dideklarasikan.

Kebijakan yang memperlakukan binding yang tidak ada sebagai free akan melaporkan hal yang tidak diketahui sebagai temuan. Uji free secara eksplisit.

Koneksi tempat lampiran ditulis: connection

connection ada pada setiap lampiran yang ditulis pada salah satu koneksi node, dan tidak ada pada setiap lampiran dari blok node itu sendiri. Ia membawa dua field, yaitu koordinat koneksi tersebut pada node:

FieldArti
socketSocket yang dilalui koneksi.
aliasAlias tempat koneksi ditulis.

Pasangan ini menamai salah satu edge graf: edge yang source-nya adalah node yang membawa lampiran dan yang socket serta alias-nya adalah keduanya. target edge tersebut adalah komponen yang menerima lampiran. Dengan demikian, sebuah policy menggabungkan lampiran dengan apa yang dijangkaunya — sesuatu yang tidak dapat dinyatakan oleh fakta pada lampiran itu sendiri, karena lampiran berada pada node yang mengonsumsi:

package security
import rego.v1
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.labels["feature.aggrega.ai/kind"] == "secret"
some edge in input.graph.spec.edges
edge.source == node_id
edge.socket == attachment.connection.socket
edge.alias == attachment.connection.alias
input.graph.spec.nodes[edge.target].labels["example.com/trust-zone"] == "external"
msg := sprintf("%v presents the credential %v to %v, outside the trust zone.", [node_id, name, edge.target])
}

Apa yang dinyatakan oleh connection, dan apa yang tidak:

  • Ia mencatat tempat penulis menulis lampiran. Ia diisi dari koneksi tempat lampiran ditulis, tidak pernah diurai dari kunci lampiran, sehingga ia memuat socket — yang tidak dibawa oleh kunci — sekaligus alias.
  • Ia tidak membawa slot. Slot socket mana yang diisi lampiran adalah binding, yang dibaca dengan cara yang sama seperti untuk lampiran apa pun; slot dilaporkan satu kali, di sana.
  • Ia tidak mendeskripsikan target. Target, label-labelnya, dan siapa yang menghubungkan edge — pengembang, Release, atau sebuah Feature — adalah fakta dari edge dan node target, yang dibaca di sana setelah penggabungan.
  • Koneksi yang dibuat oleh sebuah Feature tidak membawa lampiran, sehingga tidak ada lampiran yang membawa connection yang menamai edge semacam itu. Kredensial yang dibutuhkan oleh koneksi milik Feature sendiri adalah lampiran yang mengisi slot yang dideklarasikan Feature, dan ia tidak membawa connection.
  • Ketiadaan berarti blok node itu sendiri. Lampiran tanpa connection ditulis pada features: milik komponen itu sendiri (atau mencapainya dari cakupan yang lebih luas atau melalui ekspansi berbasis anotasi). Ini bukan temuan bahwa lampiran tidak diberikan ke komponen lain: apa yang dijangkau oleh kredensial milik komponen sendiri ditentukan oleh cara pengirimannya dihubungkan, yang tidak dideskripsikan oleh field ini.

Selain menentukan dari set slot terdeklarasi mana binding dan separuh slot dari sensitive dibaca, connection tidak mengubah apa pun pada lampiran: FeatureRecipe-nya, kontrak provides-nya, fakta-fakta lainnya, dan tempatnya di bucket sama dengan lampiran lain mana pun yang dibawa node.

FeatureRecipe mana yang merealisasikan lampiran: realization

realization menyebutkan FeatureRecipe yang diikatkan oleh Manifest milik Release ke lampiran tersebut, dalam bentuk <name>:<version>. Manifest mengikat berdasarkan nama lampiran itu sendiri apabila tingkat name-nya memetakan nama tersebut — untuk lampiran yang ditulis pada sebuah koneksi, nama berkualifikasinya, gpt.credential di atas — dan jika tidak, berdasarkan tipe Feature yang disebutkan oleh lampiran. FeatureRecipe yang disebutkan adalah FeatureRecipe yang digunakan oleh build atas dokumen yang sama untuk merender lampiran tersebut: graf mencatat pengikatan sebelum apa pun dirender, dan proses render mengikat lampiran dengan cara yang sama.

package security
import rego.v1
approved_realizations := {"approved-credential:1.0.0"}
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.labels["feature.aggrega.ai/kind"] == "secret"
realization := attachment.realization
not realization in approved_realizations
msg := sprintf("%v realizes the credential %v with %v, which is not an approved FeatureRecipe.",
[node_id, name, realization])
}

Apa yang dinyatakan oleh realization, dan apa yang tidak:

  • Pasangan ini sama di setiap tempat kemunculannya. aggrega inspect mencetaknya sebagai realisasi lampiran, dan apabila sebuah target membubuhkan provenans pada apa yang direndernya, dokumen yang dirender oleh FeatureRecipe tersebut membawanya sebagai nilai aggrega.ai/recipe-uri, sehingga sebuah kebijakan dapat menggabungkan lampiran dengan apa yang direndernya tanpa menerjemahkan antarbentuk.
  • Field ini menyebutkan FeatureRecipe berdasarkan nama dan versi, bukan berdasarkan kapabilitas. Dua kapabilitas masing-masing dapat menerbitkan FeatureRecipe dengan nama dan versi yang sama. Mana di antaranya yang diikat ditentukan oleh pemetaan Manifest, yang menyebutkan kapabilitasnya di mana pun nama saja akan ambigu; field ini tidak menyatakannya ulang.
  • Lampiran milik batas Release sendiri juga membawanya, di bawah boundary_features, dibaca dengan cara yang sama. Lampiran tingkat batas juga menjangkau setiap komponen yang dimuat oleh batas tersebut, dan membawa realisasi yang sama di sana.
  • Ketiadaan berarti tidak terikat ke apa pun. Lampiran yang tidak diikatkan oleh Manifest ke FeatureRecipe mana pun yang dimuat katalog tidak membawa realization. Build atas komposisi semacam itu berhenti sebelum merender, dengan menyebutkan lampiran yang tidak terpetakan — tetapi kebijakan pada peran ini ditanyai sebelum penghentian itu, sehingga kebijakan dapat menjumpai lampiran yang tidak membawanya. Aturan di atas melewatkan lampiran semacam itu, karena badannya mengikat realization terlebih dahulu; aturan yang ingin melaporkannya menguji ketiadaan kunci tersebut secara eksplisit.

Bagaimana attachment terbentuk: origin dan dua pendampingnya

origin membedakan attachment yang diketik oleh developer dari attachment yang dihasilkan oleh ekspansi berbasis anotasi:

NilaiArti
explicitDitulis dalam blok features:.
annotationDihasilkan oleh ekspansi berbasis anotasi.
mixedLeaf value atau infra dari attachment membawa campuran keduanya; rincian per leaf ada di peta provenance.

annotation_key menyebut anotasi yang memicu attachment sintetis, dan annotation_source menunjukkan lokasi deklarasinya sebagai <release-file-path>:<dotted-yaml-key-path>. Keduanya tidak ada apabila origin bernilai explicit.

Payload yang ditulis: values, infra, dan inject

values adalah konfigurasi operasional attachment — domain pengembang. infra adalah ukuran fisik per instans — domain operator. inject adalah perutean injeksi yang agnostik, yang memetakan kunci pengiriman ke kunci provides yang menjadi sumber pengisiannya, dengan kunci pertama berupa mekanisme pengiriman.

Isi values pada attachment kredensial adalah pilihan penulis, dan compiler membawa mana pun yang ditulis tanpa me-resolve keduanya: kredensial by-reference membawa penunjuk ke penyimpanan rahasia, dan kredensial by-value membawa materialnya sendiri. Apa pun bentuknya, leaf yang dideklarasikan sensitif oleh Feature yang dilampirkan sampai ke kebijakan dalam keadaan ditahan, seperti dijelaskan pada bagian berikutnya; leaf yang tidak dideklarasikan, seperti locator yang dipublikasikan, tiba sebagaimana ditulis.

Nilai yang dideklarasikan sensitif tiba dalam keadaan ditahan

Setiap leaf yang ditandai oleh graf sebagai dideklarasikan sensitif tiba di socket ini sebagai penanda tertahan, bukan sebagai nilai yang ditulis oleh penulis. Penanda tersebut adalah objek berkunci tunggal yang memuat alasan nilai tersebut tidak ada:

{ "aggrega_withheld": "declared" }

declared berarti sebuah deklarasi mencakup leaf tersebut. Payload yang sama sekali tidak dapat dibaca ditahan seluruhnya, dengan alasan unreadable, karena tidak ada leaf di dalamnya yang dapat dinilai.

Penahanan mengikuti penandaan graf itu sendiri, sehingga penahanan menjangkau tepat leaf yang disebut oleh penandaan tersebut, di mana pun letaknya:

  • values dan infra setiap lampiran, cakupan mana pun yang menulisnya — blok milik komponen itu sendiri, subsistem, batas, atau Release, ekspansi berbasis anotasi — dan baik ditulis pada blok milik node itu sendiri maupun pada salah satu koneksinya, berdasarkan leaf yang disebut oleh sensitive_payload_leaves miliknya;
  • infra lampiran tingkat batas, di bawah boundary_features, berdasarkan penandaannya sendiri;
  • values dan infra milik node itu sendiri, di bawah values_mapping dan infra_mapping, berdasarkan sensitive_payload_leaves milik node itu sendiri;
  • values dan infra milik koneksi itu sendiri, pada edge dan pada entri uses milik node konsumen, berdasarkan sensitive_payload_leaves milik edge, yang menyebutkan leaf yang dideklarasikan sensitif oleh socket komponen konsumen.

Hal yang menjadi dasar penalaran kebijakan tetap utuh. Tipe, versi yang di-resolve, label, anotasi katalog, binding, connection, realization, origin beserta peta provenance-nya, ketiga fakta sensitivitas, dan setiap leaf yang tidak ditandai oleh deklarasi apa pun tiba sebagaimana ditulis. Kunci leaf yang ditahan juga tetap ada, sehingga kebijakan masih melihat leaf mana yang dibawa payload dan leaf mana di antaranya yang membawa materi yang dideklarasikan — hanya nilainya yang tidak ada. Aturan tentang ke mana materi yang dideklarasikan sensitif berpindah, dan melalui rute apa, karenanya dapat diekspresikan sepenuhnya; aturan tentang isi materi tersebut tidak dapat, secara desain.

Blok uses yang ditulis pada node, yang dibawa pada node di samping edge-nya, mempertahankan setiap lampiran yang ditulis pada koneksi hanya pada type dan description-nya. Nilai lampiran dibawa satu kali, pada lampiran itu sendiri, tempat penahanan menjangkaunya.

Kebijakan yang ingin membedakan leaf yang ditahan dari leaf yang ditulis menguji keberadaan kunci penanda:

package security
import rego.v1
audit contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
some key, value in attachment.values
is_object(value)
value.aggrega_withheld
msg := sprintf("%v/%v writes a declared-sensitive value at values.%v.", [node_id, name, key])
}

Ini adalah penahanan yang sama dengan yang diterapkan --ir-graph ketika sebuah perintah mencetak graf dan yang diterapkan aggrega/irGraph milik daemon ketika menjawab klien, sehingga kebijakan dan orang yang membaca graf melihat leaf yang sama ditahan. Permukaan tersebut mengembalikan nilai kepada orang yang memintanya dengan --unredacted; payload yang diterima kebijakan tidak memiliki permintaan semacam itu, dan nilai yang dideklarasikan milik node itu sendiri ditahan darinya dengan ketentuan yang sama seperti nilai lampiran. Penahanan ini berlaku untuk payload yang diterima kebijakan dan tidak untuk hal lain: graf yang menjadi sumber render build tidak tersentuh, sehingga penahanan tidak mengubah satu byte pun hasil render. Tidak ada yang ditahan dari apa yang diterima kebijakan render-verdict, karena artefak hasil render itulah yang dinilai oleh peran tersebut.

Asal setiap leaf: values_provenance dan infra_provenance

Masing-masing diberi kunci berupa jalur leaf bertitik di dalam pilarnya, dan setiap entri mencatat origin leaf tersebut — pembedaan explicit / annotation yang sama, diterapkan satu leaf demi satu leaf. Leaf yang dikontribusikan oleh anotasi juga membawa permukaan penulisan tempat leaf itu dideklarasikan, kunci anotasi yang mengontribusikannya, dan lokasi sumber deklarasi tersebut. Jika leaf eksplisit menimpa leaf yang dikontribusikan oleh anotasi, entri tersebut juga membawa kontribusi yang ditekan yang digantikannya, sehingga policy dapat melihat apa yang ditimpa, bukan hanya apa yang menang.

Tiga unit sensitivitas

Payload membawa tiga fakta sensitivitas, dan ketiganya berada pada tiga unit yang berbeda: satu attachment utuh, satu kunci pengiriman, satu leaf payload.

Masing-masing dihitung dari inputnya sendiri. Tidak ada yang diturunkan dari yang lain, dan secara khusus jawaban per attachment tidak pernah disebarkan ke unit yang lebih sempit. Mencampuradukkan dua di antaranya menghasilkan kebijakan yang keliru ke arah yang gagal secara diam-diam, sehingga ketiganya layak dibaca secara terpisah sebelum menulis aturan terhadap salah satunya.

Masing-masing diturunkan dari apa yang dideklarasikan oleh penulis — sensitive: true pada leaf skema sebuah Feature, atau sensitive: true pada slot attachment yang dideklarasikan sebuah Component, untuk attachment-nya sendiri atau pada salah satu socket-nya. Isi nilai tidak diperiksa, dan tidak ada makna yang dibaca dari nama sebuah field.

sensitive — satu jawaban untuk seluruh attachment

Bernilai true jika Feature yang dilampirkan mendeklarasikan leaf sensitif dalam values, infra, atau provides-nya, atau slot yang diisi attachment tersebut mendeklarasikan bahwa apa pun yang mengikatnya menangani materi rahasia — slot attachment dengan nama yang sama pada Component host, atau, untuk attachment yang membawa connection, slot dengan nama tersebut yang dideklarasikan socket koneksi itu. Tidak diset jika tidak ada satu pun deklarasi tersebut.

Ini menjawab entitas itu apa, sehingga dengan sengaja tidak bervariasi menurut apa yang ditulis oleh penulis tertentu. Fakta ini membaca deklarasi Feature, bukan subset leaf sensitif yang kebetulan diisi attachment ini, karena field yang sensitif dalam satu Release dan tidak dalam Release lain tidak akan dapat digunakan oleh kebijakan yang menalar tentang entitas katalog.

Kedua bagian itu independen, dan masing-masing berlaku sendiri. Feature yang sama sekali tidak mendeklarasikan leaf sensitif tetap mengikat slot sensitif sebagai attachment sensitif, karena slot menyatakan demikian. Pengisian yang mendeklarasikan leaf sensitif adalah attachment sensitif meskipun slot tidak membuat deklarasi semacam itu, bahkan ketika ia adalah attachment bebas yang tidak mengikat slot apa pun.

sensitive_inject — satu jawaban per kunci pengiriman

Subset dari inject yang kunci provides rujukannya dideklarasikan sensitif oleh Feature yang dilampirkan, dibawa dalam bentuk inject itu sendiri: mekanisme, lalu kunci pengiriman, dengan kunci provides yang dirujuk sebagai nilainya.

Kunci pengiriman yang diisi dari kunci provides yang ditandai sensitif oleh Feature muncul di sini; kunci yang diisi dari kunci yang tidak ditandai tidak muncul, bahkan pada attachment dan mekanisme yang sama. Tidak ada jika attachment tidak mendeklarasikan mekanisme pengiriman, atau tidak merujuk kunci provides yang sensitif.

sensitive_payload_leaves — satu jawaban per leaf payload

Leaf yang dibawa payload attachment ini dan path-nya dideklarasikan sensitif oleh Feature yang dilampirkan, masing-masing sebagai path bertitik berawalan pilar yang ditempati datum tersebut: values.<path> atau infra.<path>.

Payload yang dibaca di sini adalah payload yang akhirnya dibawa attachment, bukan blok yang ditulis penulis. Leaf yang berada pada nilai yang dideklarasikan skema Feature sebagai default disebut bersama leaf yang ditulis penulis: default yang terisi adalah datum yang dibawa payload, dan penandaan yang hanya dibaca dari blok tertulis akan membiarkannya tidak disebut.

Sebuah leaf muncul di tempat path yang dideklarasikan sensitif oleh skema Feature mencakup-nya — deklarasi tersebut menyebut leaf itu, atau menyebut objek yang memuatnya. Pencocokan berjalan per segmen pada path bertitik, sehingga deklarasi pada db mencakup db.password dan tidak menjangkau leaf saudara bernama dbPassword. Tidak ada yang dibaca dari teks path itu sendiri dan tidak ada nilai yang diperiksa — apakah penulis menulis materi itu sendiri pada leaf yang ditandai, atau penunjuk ke materi itu, tidak dapat diketahui di sini dan bukan hal yang diklaim oleh penandaan.

Perbandingan dijalankan atas payload yang diratakan menjadi leaf-nya, bukan atas kunci tingkat atas pilar, sehingga leaf yang bersarang di dalam map bersarang dibandingkan seperti leaf lainnya.

Leaf tiba dalam urutan yang dipegang payload, leaf pilar values sebelum leaf pilar infra — urutan yang sama dengan yang dibawa payload itu sendiri, yang menjaga wire tetap identik per byte di seluruh eksekusi dengan input identik.

Unit ini menjawab di mana attachment ini menaruh data, yang tentu bervariasi menurut Release. Itulah sebabnya unit ini beririsan dengan apa yang ditulis, sedangkan sensitive tidak: keduanya adalah jawaban atas pertanyaan yang berbeda, dan menerapkan aturan salah satunya pada field yang lain akan merusaknya.

Membaca ketiganya bersama-sama

Seorang penulis melampirkan Feature kredensial yang mendeklarasikan leaf values literalPassword dan kunci provides password miliknya sebagai sensitif, mengisi slot credentials yang dideklarasikan, dan menulis kata sandi literal secara inline:

{
"type": "example/db-credential",
"resolved_version": "1.0.0",
"binding": "credentials",
"values": {
"secretName": "db-creds",
"literalPassword": { "aggrega_withheld": "declared" }
},
"inject": {
"env": { "DATABASE_PASSWORD": "password" }
},
"sensitive": true,
"sensitive_inject": {
"env": { "DATABASE_PASSWORD": "password" }
},
"sensitive_payload_leaves": ["values.literalPassword"]
}

Tiga pertanyaan berbeda, tiga jawaban berbeda. Attachment tersebut memang menangani materi yang dideklarasikan sensitif (sensitive). Kunci lingkungan DATABASE_PASSWORD adalah kunci yang membawanya (sensitive_inject). Dan payload attachment ini secara spesifik membawa nilai pada values.literalPassword (sensitive_payload_leaves) — sementara values.secretName, sebuah lokator yang dengan sengaja dibiarkan tidak ditandai oleh Feature, tidak ada dalam daftar itu meskipun payload juga membawanya. Kata sandi yang ditulis penulis tiba dalam keadaan ditahan, sedangkan lokator di sebelahnya tiba sebagaimana ditulis: penandaan memberi tahu kebijakan bahwa ada sebuah nilai di sana, dan nilai itu sendiri tidak pernah sampai ke kebijakan.

Aturan yang menolak rahasia literal dalam artefak hasil render membutuhkan yang ketiga. Aturan yang mewajibkan setiap attachment yang menangani kredensial membawa label kepemilikan membutuhkan yang pertama. Mengganti yang satu dengan yang lain mengubah build mana yang terhenti.

Ketiadaan bukan izin

Sebuah leaf hanya dicantumkan jika ada deklarasi yang mencakupnya. Jadi sensitive_payload_leaves yang tidak ada menyatakan bahwa attachment ini tidak menyebut leaf apa pun yang dideklarasikan sensitif oleh Feature-nya — tidak pernah bahwa payload tersebut tidak sensitif. Ketiadaan itu juga tidak membedakan attachment yang tidak memiliki leaf semacam itu untuk disebut dari producer yang sama sekali tidak melaporkan sumbu ini: keduanya tetap tidak dapat dibedakan, dan pembaca kunci yang tidak ada hanya mengetahui hal itu, tidak lebih.

Guest yang membaca daftar leaf yang tidak ada sebagai izin untuk menampilkan atau mengeluarkan nilai dalam bentuk terbuka telah membaca penandaan secara terbalik.

Kunci tersebut dihilangkan sepenuhnya dari wire jika kosong, sehingga attachment yang Feature dan slot-nya tidak mendeklarasikan apa pun membawa byte yang persis sama dengan yang akan dibawanya jika penandaan itu tidak ada. Penghilangan itulah yang membuat salah baca menjadi mudah, dan itulah sebabnya arah ini layak dinyatakan secara gamblang.

Kasus yang paling jelas adalah attachment yang sensitif dan sama sekali tidak mencantumkan leaf. Ambil attachment di atas dan ubah dua hal — penulis hanya menulis lokatornya, membiarkan leaf yang dideklarasikan sensitif tidak terisi, dan mengisi kunci environment dari kunci provides name milik Feature yang tidak ditandai, bukan dari password:

{
"type": "example/db-credential",
"resolved_version": "1.0.0",
"binding": "credentials",
"values": { "secretName": "db-creds" },
"inject": {
"env": { "DATABASE_PASSWORD": "name" }
},
"sensitive": true
}

sensitive tetap true — deklarasi Feature tidak berubah — sementara kedua unit yang lebih sempit hilang. Attachment tersebut tetap menangani materi rahasia; ia hanya tidak melakukannya melalui leaf atau kunci pengiriman yang dibawa attachment ini. Kebijakan yang berpatokan pada ringkasan menolak build ini, dan kebijakan yang berpatokan pada penandaan per leaf meloloskannya. Keduanya adalah aturan yang dapat dipertanggungjawabkan, dan mana yang diinginkan sebuah kebijakan adalah keputusan yang diambil penulis kebijakan secara sengaja.

Asimetri yang sama juga berlaku ke arah sebaliknya untuk sensitive_inject: sebuah attachment dapat menulis leaf sensitif sambil tidak merutekan apa pun yang sensitif melalui kunci pengiriman, atau merutekan kunci provides yang sensitif tanpa menulis nilai apa pun.

Apa yang tidak dilakukan oleh deklarasi sensitivitas

Penandaan ini hanya memberi anotasi; penandaan ini bukan kontrol. Mendeklarasikan sebuah leaf atau slot sebagai sensitif tidak mengenkripsi apa pun, tidak memvalidasi atau menolak suatu nilai, dan tidak memaksakan suatu mekanisme pengiriman. Tidak ada hasil build yang berubah karena sebuah deklarasi ada.

Pada sebagian besar target, penandaan ini juga tidak mengubah satu byte pun yang dirender: nilai yang dideklarasikan sensitif yang diberikan penulis secara inline dirender persis sama seperti nilai yang tidak dideklarasikan. Terraform merupakan pengecualian di antara target pustaka standar, karena Terraform memiliki primitif sensitivitas per nilai bawaan sebagai tempat deklarasi tersebut diterapkan — lihat providers/terraform.md “Declared-sensitive module inputs”. Target yang tidak memiliki konsep sensitivitas sendiri tidak memiliki apa pun yang dapat diubah oleh sebuah deklarasi.

Yang dilakukan deklarasi di mana pun adalah membuat fakta tersebut terbaca — oleh keluaran debug milik compiler sendiri, dan oleh policy pada socket ini yang memutuskan apa yang harus dilakukan terhadapnya. Mengubah sebuah penandaan menjadi hasil build adalah tugas policy, dan untuk itulah socket ini ada. Selain itu, policy diberi tahu tentang materi yang dideklarasikan sensitif tanpa diserahi materi tersebut: penandaannya tiba, sedangkan nilainya tiba dalam keadaan ditahan.

Rujukan silang

  • policy-socket.md — socket tata kelola: keempat peran, tingkat keparahan putusan, saluran input operator, mesin kebijakan yang disertakan di dalam compiler, dan cara memasang plugin ke workspace.
  • plugin-contract.md — penempatan socket dalam pipeline dan bentuk wire bertipenya.
  • referensi skema graf — kontrak per field untuk graf build, termasuk setiap field pada sebuah attachment.
  • entities/component.md “Attachment Slots” — mendeklarasikan slot, dan mendeklarasikan slot sebagai sensitif; serta featuresSchema yang dideklarasikan socket untuk koneksi yang dihubungkan melaluinya.
  • entities/aggregate.md “A connection’s own attachments” — menulis attachment pada sebuah koneksi, dan nama yang dipakainya.
  • vocabulary/compact-form-authoring.md “Declaring a leaf sensitive” — kata kunci sensitive: dan batas atas dari apa yang dicapai dengan mendeklarasikannya.
  • vocabulary/labels-and-annotations.md — permukaan label dan anotasi yang dibaca oleh sebuah kebijakan.