ガバナンスポリシーが読み取るアタッチメントの事実
ir-verdict ロールにアタッチされたガバナンスプラグインはビルドグラフ全体を受け取り、ビルド内のすべての Feature アタッチメントもそれとともに届きます。各アタッチメントは、自身に関する決まった事実の集合を持ちます。どの Feature を指すか、どのスロットを埋めるか、接続上に書かれた場合はどの接続上に書かれたか、どの FeatureRecipe がそれを実現するか、カタログ作成者がそれについて何を宣言したか、作成者がそこに何を書いたか、そして誰かが機密と宣言した素材を扱うかどうかです。書かれたとおりには届かないものが 1 つあります。作成者が機密と宣言した値は伏せられた状態で届きます。Declared-sensitive values arrive withheld(機密と宣言された値は伏せられて届く)を参照してください。
このページでは、これらの事実を列挙し、それぞれが何を主張し、何を主張しないかを説明します。
ソケット自体(4 つのロール、判定の重大度、オペレーター入力チャネル、コンパイラに同梱される 2 つのポリシーエンジン)については、policy-socket.md を参照してください。
型と必須性を含むフィールドごとの表については、生成されたグラフスキーマリファレンスを参照してください。このページは事実の読み方を説明するものであり、契約はあちらのページです。
ペイロード内でアタッチメントが置かれる場所
アタッチメントはビルドグラフの feature_values_mapping の下にぶら下がり、ノード ID、次に作成者が各アタッチメントに付けたインスタンス名をキーとします。
input.graph.spec.feature_values_mapping[<node id>][<attachment name>]アタッチメント名は装飾ではなく、意味を担うものです。作成者がスロットを埋める際のキーであり、したがってコンパイラがホストの Component で宣言されたスロットと照合する対象でもあります。
コンポーネントの接続のいずれか(Aggregate または Release 内の uses エントリの features: の下)に記述されたアタッチメントは、消費側コンポーネントのアタッチメントの一つであるため、同じバケット内、消費側コンポーネントのノード上に置かれます。そのキーはコンパイラが付ける名前で、接続のエイリアスとスロットをドットで結合したものです。エイリアス gpt の下に記述された接続の credential スロットであれば gpt.credential となります。作成者が記述する名前にドットが現れることはないため、このキーがノード自身のアタッチメントの名前と一致することはありません。ただし、ポリシーはキーから接続を読み取るのではありません。エントリは接続をデータとして、後述の connection に保持しています。
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])}これらのファクトを参照できるのは ir-verdict だけです。 render-verdict ポリシーはレンダリングされたアーティファクトを受け取り、グラフは受け取りません。label-transform ポリシーはノードのラベルと値の射影を受け取ります。そこでは機密と宣言された値がここと同様に伏せられ、アタッチメントは一切含まれません。annotation-transform ポリシーは注釈を付けられるコンポーネントを受け取ります。アタッチメントのファクトを読み取るルールは ir-verdict に置くべきものであり、別のロールに移すとエラーにはならず、決して発火しないルールになります。存在しないパスは単に未定義となるためです。
1 つのバケット、すべてのアタッチメントファミリー
ノード上のすべてのアタッチメントは、その Feature が何を生成するか(運用の Feature、認証情報の Feature、アイデンティティの Feature)にかかわらず、同じバケットに置かれます。 どのファミリーも他のファミリーより狭い射影を受けることはないため、バケットを走査するポリシーはそのすべてを参照でき、ファクトを読む前にどのファミリーを見ているかを知る必要はありません。
アイデンティティ: type と resolved_version
type は、アタッチメントが指定するカタログの Feature の URI です。
resolved_version は、このビルドで解決の結果として確定した正確なバージョンです。
どちらも常に存在します。
そのまま運ばれるカタログメタデータ: labels と catalog_annotations
labels は、アタッチされた Feature エンティティ自身の metadata.labels です。
catalog_annotations は、そのエンティティ自身の metadata.annotations です。どちらも
カタログエンティティが宣言した順序で運ばれ、フィルタリング、正規化、
プレフィックスの除去はいずれも行われません。カタログ作成者独自の名前空間にあるキーは
書かれたとおりに届き、コンパイラはそのいずれも読み取りません。
このようにそのまま運ばれるからこそ、コンパイラが存在を知る理由のないラベルを キーにしてポリシーを書くことができます。認証情報の Features に独自に考案した ラベルを付けるカタログ作成者は、そのラベルに対して直接ルールを書くことができます。
Feature が何も宣言していない場合、およびその type がどのカタログエンティティにも解決されない場合、どちらもアタッチメントに存在しません。
catalog_annotations は、アタッチメントが指すエンティティを記述します。これは
後述の annotation_key および annotation_source とは別の問いであり、それらは
アタッチメントがどのように存在するに至ったかを記述します。
features: ブロックに書かれたアタッチメントは、カタログアノテーションを運びますが、
他の 2 つはどちらも運びません。
アタッチメントが埋めるスロット: binding
binding には 3 つの答えがあり、3 つ目は 2 つ目の変種ではありません:
| 値 | 意味 |
|---|---|
| スロット名 | アタッチメントは、その名前で宣言されたアタッチメントスロットを埋めます。 |
free | アタッチメントは宣言されたどのスロットも埋めません。これは確定した所見です。スロットセットは解決されており、宣言されたスロットのいずれもこの名前を持っていません。 |
| 存在しない | ホストの Component が宣言したスロットセットを解決できなかったため、どのスロットが埋められるかは不明です。 |
名前がどの宣言済みスロットセットに由来するかは、アタッチメントが書かれた場所によって決まります。ノード自身のブロックのアタッチメントは、ホストの Component が自身の featuresSchema で宣言するスロットを埋めます。接続上に書かれたアタッチメント、
つまり後述の connection を持つものは、その接続のソケットが宣言するスロットを、
ホストの Component 上のそのソケットの featuresSchema において埋めます。したがって同じ値
credential が、あるアタッチメントでは Component のスロットを、別のアタッチメントではソケットのスロットを指し、両者を区別するのが connection です。
対応付けは名前によります。Feature がスロットの名前でアタッチされたとき、
それがコンポーネントのブロック上であれ接続上であれ、アタッチメントはそのスロットを埋めます。そのため
値は宣言済みスロットセットの正確なキーです。アタッチメントのキーからは何も読み取りません。接続のアタッチメントのキーは gpt.credential ですが、
報告されるのは credential です。単なるフラグではなくスロット名を持たせているのは、
どのスロットが埋められたかのほうが、答えのより有用な半分だからです。
接続上に書かれたアタッチメントが free を報告することはありません。ソケットのスロットは、
そのソケットを通る接続が持てる唯一の名前であり、それ以外の名前を持つ接続は
ビルドの読み込み時に拒否されます。そのため、ポリシーに到達するグラフ内のそのようなアタッチメントはすべて、宣言されたスロットを埋めます。
存在しない binding を free として扱うポリシーは、不明な状態を
所見として報告してしまいます。free を明示的に判定してください。
アタッチメントがどの接続に書かれたか: connection
connection は、ノードの接続のいずれかに書かれたすべてのアタッチメントに存在し、ノード自身のブロックのすべてのアタッチメントには存在しません。
これは 2 つのフィールド、つまりノード上でのその接続の座標を持ちます。
| フィールド | 意味 |
|---|---|
socket | 接続が経由して配線されるソケット。 |
alias | 接続が書かれているエイリアス。 |
この組はグラフのエッジの 1 つを指します。すなわち、source がアタッチメントを持つノードであり、socket と alias がこれらであるエッジです。そのエッジの
target が、アタッチメントが提示されるコンポーネントです。したがってポリシーは、アタッチメントをその到達先と結合できます。アタッチメントは消費側のノードにあるため、これはアタッチメント単独のどのファクトも示せないことです。
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])}connection が示すこと、および示さないこと:
- 作成者がアタッチメントをどこに書いたかを記録します。 これはアタッチメントが書かれた接続から埋められ、アタッチメントのキーから解析されることはありません。そのため、エイリアスに加えて、キーが持たないソケットも保持します。
- スロットは持ちません。 アタッチメントがソケットのどのスロットを埋めるかは
bindingであり、他のアタッチメントと同じように読み取ります。スロットはそこで一度だけ報告されます。 - ターゲットは記述しません。 ターゲット、そのラベル、そしてエッジを配線したのが誰か(開発者、Release、または Feature)は、エッジとターゲットノードのファクトであり、結合後にそちらで読み取ります。
- Feature が引く接続はアタッチメントを持ちません。 そのため、そのようなエッジを指す
connectionを持つアタッチメントはありません。Feature 自身の接続が必要とする資格情報は、その Feature が宣言するスロットを埋めるアタッチメントであり、connectionを持ちません。 - 存在しない場合はノード自身のブロックを意味します。
connectionのないアタッチメントは、コンポーネント自身のfeatures:に書かれたもの(または、より広いスコープから、あるいはアノテーション駆動の展開によって到達したもの)です。これは、アタッチメントが他のどのコンポーネントにも提示されないというファクトではありません。コンポーネント自身の資格情報がどこに到達するかは、その配信がどう配線されているかで決まり、このフィールドはそれを記述しません。
binding と sensitive のスロット部分をどの宣言済みスロットセットから読み取るかを決めること以外に、connection はアタッチメントについて何も変えません。その FeatureRecipe、provides 契約、その他のファクト、バケット内での位置は、ノードが持つ他のアタッチメントと同じです。
どの FeatureRecipe がアタッチメントを実現するか: realization
realization は、Release の Manifest がアタッチメントにバインドする FeatureRecipe を <name>:<version> の形式で示します。Manifest は、その name 層がアタッチメント自身の名前をマッピングしている場合はその名前(接続上に記述されたアタッチメントであれば修飾名、上の例では gpt.credential)でバインドし、そうでない場合はアタッチメントが示す Feature の型でバインドします。示される FeatureRecipe は、同じドキュメントのビルドがそのアタッチメントのレンダリングに使うものと同じです。グラフは何かがレンダリングされる前にバインディングを記録し、レンダリングも同じ方法でアタッチメントをバインドします。
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])}realization が示すことと、示さないこと:
- 現れるすべての場所で同じペアです。
aggrega inspectはこれをアタッチメントの実現として出力します。また、ターゲットがレンダリング結果にプロベナンスを付与する場合、その FeatureRecipe がレンダリングするドキュメントはこれをaggrega.ai/recipe-uriの値として持ちます。そのため、ポリシーは形式間の変換を行わずに、アタッチメントとそのレンダリング結果を結び付けられます。 - FeatureRecipe を名前とバージョンで示し、ケイパビリティでは示しません。 2 つのケイパビリティがそれぞれ同じ名前とバージョンで FeatureRecipe を公開することがあります。どちらがバインドされるかは Manifest のマッピングによって決まり、マッピングは名前だけでは曖昧になる場合にケイパビリティを指定します。このフィールドはそれを繰り返しません。
- Release の境界自身のアタッチメントもこれを持ちます。これは
boundary_featuresの下にあり、同じ方法で読み取ります。境界レベルのアタッチメントは、境界が保持する各コンポーネントにも届き、そこでも同じ実現を持ちます。 - 存在しない場合は、何にもバインドされていないことを意味します。 Manifest がカタログ内のどの FeatureRecipe にもバインドしないアタッチメントは、
realizationを持ちません。このような構成のビルドは、マッピングされていないアタッチメントを示してレンダリング前に停止します。ただし、このロールのポリシーはその停止より前に呼び出されるため、これを持たないアタッチメントに出会うことがあります。上のルールは、本体が最初にrealizationをバインドするため、このようなアタッチメントを素通りさせます。これを報告したいルールは、キーの欠落を明示的にテストします。
アタッチメントが生じた経緯: origin とその 2 つの付随フィールド
origin は、開発者が記述したアタッチメントと、アノテーション駆動の展開によって生成されたアタッチメントを区別します。
| 値 | 意味 |
|---|---|
explicit | features: ブロック内で記述されたもの。 |
annotation | アノテーション駆動の展開によって生成されたもの。 |
mixed | アタッチメントの value または infra のリーフに両方が混在しています。リーフごとの詳細は provenance マップにあります。 |
annotation_key は合成アタッチメントをトリガーしたアノテーションを示し、annotation_source はその宣言の位置を <release-file-path>:<dotted-yaml-key-path> の形式で示します。origin が explicit の場合、どちらも存在しません。
記述されたペイロード: values、infra、inject
values はアタッチメントの運用設定であり、開発者の領域です。infra はインスタンスごとの物理的なサイジングであり、オペレーターの領域です。inject
は配信キーに依存しないインジェクションのルーティングで、配信キーをその値の供給元となる provides キーに対応付け、まず配信メカニズムをキーとして分類されます。
認証情報アタッチメントの values に何を持たせるかは作成者の選択であり、コンパイラはどちらも解決せずに、記述されたほうをそのまま運びます。参照による認証情報はシークレットストアへのポインタを運び、値による認証情報はその素材そのものを運びます。いずれの場合も、アタッチされた Feature が sensitive と宣言したリーフは、次のセクションで説明するとおり、伏せられた状態でポリシーに届きます。公開されたロケーターのように宣言されていないリーフは、記述されたとおりに届きます。
機密と宣言された値は秘匿された状態で届く
グラフが機密と宣言されたものとしてマークするすべてのリーフは、作成者が書いた値ではなく、秘匿マーカーとしてこのソケットに届きます。マーカーは、値が存在しない理由を保持する単一キーのオブジェクトです。
{ "aggrega_withheld": "declared" }declared は、宣言がそのリーフを対象としていることを意味します。まったく読み取れなかったペイロードは、その中のどのリーフも判定できないため、理由 unreadable とともに全体が秘匿されます。
秘匿はグラフ自身のマーキングに従うため、マーキングが指定するリーフに、それがどこにあっても正確に及びます。
- すべてのアタッチメントの
valuesとinfra。どのスコープが書いたか(コンポーネント自身のブロック、サブシステム、境界または Release、アノテーション駆動の展開)を問わず、またノード自身のブロックに書かれたか、その接続の 1 つに書かれたかを問わず、そのsensitive_payload_leavesが指定するリーフによって秘匿されます。 - 境界レベルのアタッチメントの
infra。boundary_featuresの下にあり、 それ自身のマーキングによって秘匿されます。 - ノード自身の
valuesとinfra。values_mappingとinfra_mappingの下にあり、ノード自身のsensitive_payload_leavesによって秘匿されます; - 接続自身の
valuesとinfra。エッジ上と、消費側ノードのusesエントリ内にあり、エッジのsensitive_payload_leavesによって秘匿されます。これは、消費側コンポーネントのソケットが機密と宣言しているリーフを示します。
ポリシーが推論に用いる内容は損なわれません。type、解決済みバージョン、ラベル、カタログアノテーション、binding、connection、realization、origin とその来歴マップ、3 つの機密性ファクトのすべて、そしてどの宣言もマークしないすべてのリーフは、書かれたとおりに届きます。秘匿されたリーフのキーも残るため、ポリシーはペイロードがどのリーフを保持し、そのうちどれが宣言されたマテリアルを保持するかを引き続き確認できます。存在しないのは値だけです。したがって、機密と宣言されたマテリアルがどこへ、どの経路で移動するかに関するルールは完全に表現できますが、マテリアルの内容に関するルールは、設計上表現できません。
ノードの作成済み uses ブロックは、ノード上でそのエッジと並んで保持され、接続上に書かれた各アタッチメントをその type と description に限定して保持します。アタッチメントの値は、アタッチメント自体の上に 1 回だけ保持され、そこで秘匿が適用されます。
秘匿されたリーフと作成されたリーフを区別したいポリシーは、マーカーのキーの有無を検査します。
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])}これは、コマンドがグラフを出力するときに --ir-graph が適用し、デーモンがクライアントに応答するときに aggrega/irGraph が適用するのと同じ秘匿であるため、ポリシーとグラフを読む人は同じリーフが秘匿されているのを目にします。これらのサーフェスは、--unredacted で値を要求した人には値を返します。ポリシーが受け取るペイロードにはそのような要求はなく、ノード自身の宣言された値もアタッチメントの値と同じ条件でポリシーから秘匿されます。この秘匿はポリシーが受け取るペイロードにのみ適用され、それ以外には適用されません。ビルドがレンダリングの元とするグラフは変更されないため、秘匿によってレンダリングされるバイトが変わることはありません。render-verdict ポリシーが受け取るものからは何も秘匿されません。そのロールが判定するのはレンダリングされた成果物だからです。
各リーフの出どころ: values_provenance と infra_provenance
それぞれはピラー内のドット区切りのリーフパスをキーとし、各エントリはそのリーフの origin を記録します。これは同じ explicit / annotation の区別を、リーフ 1 つずつに適用したものです。アノテーションによって追加されたリーフは、さらに、宣言されたオーサリング面、そのリーフを追加したアノテーションキー、およびその宣言のソース位置を持ちます。明示的なリーフがアノテーションによって追加されたリーフを上書きした場合、エントリは置き換えられた抑制済みの追加内容も持つため、ポリシーは優先された内容だけでなく、何が上書きされたかも確認できます。
3 つの機密性の単位
ペイロードは 3 つの機密性に関する事実を持ち、それらは 3 つの異なる単位に位置します。1 つのアタッチメント全体、1 つの配信キー、1 つのペイロードリーフです。
それぞれは独自の入力から計算されます。どれも他から導出されることはなく、特にアタッチメント単位の答えがより狭い単位へ波及することは決してありません。いずれか 2 つを混同すると、気づかれないまま誤った方向に失敗するポリシーができあがるため、いずれかに対してルールを書く前に 3 つを個別に理解しておく価値があります。
いずれも作成者が宣言した内容から導出されます。Feature のスキーマリーフ上の sensitive: true、または Component が自身のアタッチメント用もしくはそのソケットの 1 つに宣言するアタッチメントスロット上の sensitive: true です。値の内容が検査されることはなく、フィールド名から意味が読み取られることもありません。
sensitive — アタッチメント全体に対する 1 つの答え
アタッチされた Feature がその values、infra、または provides に機密リーフを宣言している場合、またはアタッチメントが埋めるスロットが、そこにバインドされるものは秘密情報を扱うと宣言している場合に true になります。このスロットとは、ホスト Component の同名のアタッチメントスロット、または connection を持つアタッチメントの場合はその接続のソケットが宣言する同名のスロットです。どちらの宣言も存在しない場合は未設定です。
これはそのエンティティが何であるかに答えるものであり、特定の作成者が書いた内容によって変化しないよう意図的に設計されています。このアタッチメントがたまたま埋めた機密リーフの部分集合ではなく Feature の宣言を読むのは、ある Release では機密で別の Release ではそうでないフィールドは、カタログエンティティについて推論するポリシーにとって使いものにならないためです。
2 つの条件は独立しており、それぞれ単独で成立します。機密リーフをまったく宣言しない Feature でも、機密スロットにバインドすれば機密アタッチメントになります。スロットがそう宣言しているためです。機密リーフを宣言するものを埋めたアタッチメントは、スロットがそのような宣言をしていない場合でも、またスロットにバインドしない自由なアタッチメントである場合でも、機密アタッチメントです。
sensitive_inject — 配信キーごとの 1 つの答え
inject のうち、参照する provides キーをアタッチされた Feature が機密と宣言しているものの部分集合で、inject 自体の形状で格納されます。メカニズム、次に配信キーの順で、値には参照される provides キーが入ります。
Feature が機密とマークした provides キーから埋められる配信キーはここに現れます。マークされていないキーから埋められるものは、同じアタッチメント、同じメカニズムであっても現れません。アタッチメントが配信メカニズムを宣言しない場合、または機密の provides キーを参照しない場合は存在しません。
sensitive_payload_leaves — ペイロードリーフごとの 1 つの答え
このアタッチメントのペイロードが持つリーフのうち、そのパスをアタッチされた Feature が機密と宣言しているものです。それぞれ、データが占める柱の接頭辞付きドット区切りパス values.<path> または infra.<path> として示されます。
ここで読まれるペイロードは、作成者が書いたブロックではなく、アタッチメントが最終的に持つものです。Feature のスキーマが default として宣言する値にあるリーフも、作成者が書いたリーフと同様に挙げられます。埋められたデフォルトはペイロードが持つデータであり、書かれたブロックだけから読み取ったマーキングではそれが挙げられないままになるためです。
リーフが現れるのは、Feature のスキーマが機密と宣言するパスがそれをカバーする場合、つまり宣言がそのリーフを指すか、それを含むオブジェクトを指す場合です。照合はドット区切りパスのセグメント単位で行われるため、db での宣言は db.password をカバーし、dbPassword という名前の兄弟リーフには及びません。パス自体のテキストからは何も読み取られず、値も検査されません。作成者がマークされたリーフに情報そのものを書いたのか、それへのポインタを書いたのかはここでは知り得ず、マーキングが主張する内容でもありません。
比較は柱のトップレベルキーではなく、リーフまで平坦化されたペイロードに対して行われるため、ネストされたマップの中にあるリーフも他と同様に比較されます。
リーフはペイロードが保持する順序で届き、values の柱のものが infra の柱のものより先になります。これはペイロード自体が持つ順序と同じであり、同一の入力に対する実行間でワイヤをバイト単位で同一に保つものです。
この単位はこのアタッチメントがどこにデータを置いたかに答えるもので、必然的に Release ごとに変わります。だからこそ、sensitive とは異なり、作成された内容との共通部分をとります。両者は異なる問いへの答えであり、どちらかのルールをもう一方のフィールドに適用すると壊れてしまいます。
3 つを合わせて読む
作成者が、literalPassword の values リーフと password の provides キーを機密と宣言する認証情報 Feature をアタッチし、宣言された credentials スロットを埋め、リテラルのパスワードをインラインで記述する場合:
{ "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"]}3 つの異なる問いに、3 つの異なる答えがあります。このアタッチメントはそもそも機密と宣言された情報を扱います(sensitive)。DATABASE_PASSWORD 環境キーはそれを運ぶキーです(sensitive_inject)。そしてこのアタッチメントのペイロードは特に values.literalPassword に値を持ちます(sensitive_payload_leaves)。一方、Feature が意図的にマークしないままにしているロケーターである values.secretName は、ペイロードがそれも持っているにもかかわらず、そのリストにはありません。作成者が書いたパスワードは伏せられて届き、その隣のロケーターは書かれたとおりに届きます。マーキングはポリシーに値がそこにあることを伝えますが、値そのものがポリシーに届くことはありません。
レンダリングされた成果物内のリテラルの秘密を拒否するルールには 3 つ目が必要です。認証情報を扱うすべてのアタッチメントに所有者ラベルを求めるルールには 1 つ目が必要です。一方を他方で代用すると、どのビルドが停止するかが変わります。
不在は許可ではない
リーフが列挙されるのは、宣言がそれをカバーする場合だけです。したがって sensitive_payload_leaves が存在しないことは、このアタッチメントがその Feature が機密と宣言するリーフを 1 つも挙げないことを示すものであり、ペイロードが機密でないことを示すものでは決してありません。 また、挙げるべきそのようなリーフを持たないアタッチメントと、この軸をまったく報告しないプロデューサーも区別しません。この 2 つは区別できないままであり、キーの不在を読む側が知り得るのはそれだけです。
リーフリストの不在を、値を平文で表示または出力してよいという許可と読むゲストは、マーキングを逆に読んでいます。
キーは空になる場合にはワイヤから完全に省略されるため、Feature とスロットが何も宣言しないアタッチメントは、マーキングが存在しなかった場合とまったく同じバイトを持ちます。この省略こそが誤読を招きやすくしており、だからこそ向きを明確に述べておく価値があります。
最もわかりやすいのは、機密でありながらリーフを 1 つも列挙しないアタッチメントです。上のアタッチメントの 2 点を変えます。作成者はロケーターだけを書き、機密と宣言されたリーフは埋めないままにし、環境キーを password ではなく Feature のマークされていない name provides キーから埋めます:
{ "type": "example/db-credential", "resolved_version": "1.0.0", "binding": "credentials", "values": { "secretName": "db-creds" }, "inject": { "env": { "DATABASE_PASSWORD": "name" } }, "sensitive": true}sensitive は依然として true です。Feature の宣言は変わっていないためです。一方、より狭い 2 つの単位はどちらも消えます。このアタッチメントは依然として秘密情報を扱いますが、このアタッチメントが持つリーフや配信キーを通じて扱っていないだけです。集約値をキーとするポリシーはこのビルドを拒否し、リーフ単位のマーキングをキーとするポリシーは通します。どちらも妥当なルールであり、ポリシーがどちらを求めるかはポリシー作成者が意図して下す判断です。
sensitive_inject についても同じ非対称性が逆方向に成り立ちます。アタッチメントは、配信キーを通じて機密なものを何も渡さずに機密リーフを記述することも、値をまったく記述せずに機密の provides キーを渡すこともできます。
機密性の宣言が行わないこと
このマーキングは注釈であり、制御ではありません。リーフやスロットを機密として宣言しても、何かが暗号化されることはなく、値が検証または拒否されることもなく、配信メカニズムが強制されることもありません。宣言が存在することによってビルドの結果が変わることはありません。
ほとんどのターゲットでは、レンダリングされるバイトも一切変わりません。作成者がインラインで指定した機密宣言済みの値は、宣言されていない値とまったく同じようにレンダリングされます。標準ライブラリのターゲットのうち Terraform は例外です。Terraform には、宣言の受け皿となる値ごとのネイティブな機密性プリミティブがあるためです。providers/terraform.md の「Declared-sensitive module
inputs」を参照してください。独自の機密性の概念を持たないターゲットでは、宣言によって変わるものは何もありません。
宣言がどこでも行うのは、その事実を読み取れるようにすることです。対象は、コンパイラ自身のデバッグ出力と、それについてどう対処するかを判断するこのソケットのポリシーです。マーキングをビルドの結果に変えるのはポリシーの役割であり、このソケットはそのために存在します。そしてポリシーは、機密宣言済みの素材そのものを渡されることなく、その存在を知らされます。マーキングは届き、値は伏せられた状態で届きます。
相互参照
policy-socket.md— ガバナンスソケット:4 つのロール、判定の重大度、オペレーター入力チャネル、コンパイラに同梱されるポリシーエンジン、およびワークスペースへのプラグインのアタッチ。plugin-contract.md— このソケットのパイプライン上の位置と、その型付きワイヤ形式。- グラフスキーマリファレンス — ビルドグラフのフィールドごとの契約。アタッチメント上のすべてのフィールドを含みます。
entities/component.md「Attachment Slots」 — スロットの宣言、スロットを sensitive として宣言する方法、およびソケットが自身を介して配線される接続に対して宣言するfeaturesSchema。entities/aggregate.md「A connection’s own attachments」 — 接続上にアタッチメントを記述する方法と、それが取る名前。vocabulary/compact-form-authoring.md「Declaring a leaf sensitive」 —sensitive:キーワードと、それを宣言することで達成できる範囲の上限。vocabulary/labels-and-annotations.md— ポリシーが読み取るラベルとアノテーションの面。