コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

制限付きデータがマスクされないままマネージドモデルに到達したときにビルドを停止するポリシー

ある環境では、制限付きの顧客データを扱う請求アシスタントと、そうしたデータを一切扱わないヘルプデスクアシスタントを運用しています。どちらもモデルへのトラフィックを、クラスタ内の AI ゲートウェイ経由で OpenAI のマネージド API に送ります。この環境の社内ルールは次のとおりです。

あるクラスのデータは、ビルドグラフのルート上で別のクラスのコンポーネントに到達しません。ただし、そのルート上に機密区分を解除する Feature がアタッチされている場合を除きます。

このワークスペースでは、このルールをビルドグラフに対するポリシーとしてアタッチし、1 つの Aggregate の 3 つの Releases をビルドします。1 つ目では、請求アシスタントのリクエストがそれをマスクするゲートウェイを経由し、ビルドは完了します。残りの 2 つではそうならず、何もレンダリングされる前にビルドが停止し、ポリシーがルートの両端を示します。

ルールは、実行されるポリシーエンジンごとに 1 回ずつ、計 3 回記述されています。CLI に組み込まれた Rego エンジンと CEL エンジン、そして OPA です。3 つのコピーは、ここでのすべてのビルドで同じ結果になります。Releases と同じ場所にあるスクリプトが 9 通りの組み合わせをすべてビルドし、それぞれの結果を確認します。

構築されるもの

インスタンスカタログの Componentここでの役割
assistantlocal/ai-agent/claims-assistant請求アシスタント:標準ライブラリの LangGraph エージェントで、このワークスペースのカタログにラベルを 1 つ追加して宣言されています。そのラベルは、扱うデータのクラスです
helpdeskcore/ai-agent/langgraphヘルプデスクアシスタント。クラスを持ちません
checkpointercore/datastore/valkey両アシスタントが実行状態を保持する場所
masking-gatewaycore/gateway/litellm1 つのエイリアス chat を提供し、core/data-masking がアタッチされた AI ゲートウェイ
plain-gatewaycore/gateway/litellm何もアタッチされていない同じゲートウェイ
gptcore/ai-model/openaiOpenAI のマネージド API。参照として到達し、クラスタ内ではそのために何も実行されません
analyzer, anonymizercore/security/presidio-analyzer, core/security/presidio-anonymizerマスキングが呼び出す認識サービス

両ゲートウェイは models ソケットを通じて gpt に接続され、それぞれがその接続でモデルのキーを提示します。マスキングのアタッチメントはマスクする対象を列挙します。エステートの請求番号のパターンと、エンティティタイプ PERSON および EMAIL_ADDRESS です。2 つのアシスタントは、その Component が宣言する model ソケットを宣言します。このソケットはモデル、またはモデル API を提供するゲートウェイを受け入れ、未バインドのままにされます。各 Release がこれを接続します。

3 つの Releases

Releases の違いは、各アシスタントのモデルトラフィックがどのゲートウェイを経由するかだけです。

Release請求アシスタントのトラフィックヘルプデスクアシスタントのトラフィックビルド
release-masked.yamlmasking-gateway 経由plain-gateway 経由完了する
release-unmasked.yamlplain-gateway 経由plain-gateway 経由停止する
release-masking-off-route.yamlplain-gateway 経由masking-gateway 経由停止する

各 Release は、2 つのアシスタントの model ソケットを、Aggregate が宣言するゲートウェイにバインドします。これは Component が宣言するソケット内でのエッジの配線であり、Release が行ってよいものです。コンポーネントを追加することも、値を変更することもありません。

サンプルを生成する

このサンプルは以下のコマンドでビルドできます。または、AI アシスタントにビルドを任せることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example policy-data-class-route

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd policy-data-class-route

ビルド

Terminal window
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull
aggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1
aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1

同じルールを別のエンジンで実行するには、governance-rego.yaml を governance-cel.yaml または governance-opa.yaml に置き換えます。

--config は、その実行で使うグローバル設定ファイルを指定します。 このファイルは、マシンが通常読み込むファイル(AGGREGA_CONFIG が指定するファイル、またはデフォルトの場所)の代わりに読み込まれ、このワークスペース自身の .aggrega-config.yaml は引き続きその上に重ねられます。したがって、その実行では、自分のグローバルファイルに置いている設定(別のガバナンスのアタッチメント、default_registry、オフライン設定)は適用されません。aggrega login で保存した認証情報はそのファイルには含まれないため、引き続き適用されます。ワークスペースのファイルはカタログのディレクトリを宣言し、独自のガバナンスのアタッチメントは宣言しません。ワークスペースのファイルがリストを宣言すると、指定されたファイルが持つリストを置き換えるため、実行されるのは指定されたファイル内のアタッチメントです。

ガバナンスポリシーは Release ではなく設定を通じてアタッチされます(Release にはそのためのフィールドがありません)。そのため、エンジンは Release ごとではなくビルドごとに選択されます。

最初のビルドの前に、次の 2 つを用意しておく必要があります。

  • 標準ライブラリのカタログ。 .aggrega-config.yaml は、このワークスペース自身の catalog/ を列挙します。ここには claims アシスタントと OPA エンジンの Plugin エンティティが含まれます。Rego と CEL のエンジンの Plugin エンティティを含め、それ以外のすべては、後述の hub レジストリ、または --catalog で指定したカタログのチェックアウトから解決されます。
  • hub レジストリ。 データマスキングの実現は、コンパイラにもカタログにも同梱されていない 1 つのプラグイン、ゲートウェイ設定ステップ pipeline-step/litellm-gateway-config を通じてガードレールを書き出します。ビルドはこれを default_registry が指定するレジストリ hub.aggrega.ai から取得します。

--auto-pull はビルド中に各 Release のロックファイルを埋めます。ロックファイルとレンダリングされた出力は生成物であり、同梱されません。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールのみを使用し、フォルダーは自分で作成しないでください。Workspace フォルダーにまだ `policy-data-class-route` フォルダーがない場合は、`example` を `policy-data-class-route` に設定し、`dir` を指定せずに `scaffold` ツールを 1 回呼び出してください。これにより、新しい `policy-data-class-route` フォルダーに例が書き込まれます。次に、`aggrega build` を実行してその `--config` フラグを受け付ける `cli-build` ツールを、各 Release について 1 回ずつ、`release-masked.yaml`、`release-unmasked.yaml`、`release-masking-off-route.yaml` の順に呼び出してください。毎回、`workspace_root` を `policy-data-class-route`、`release` をそのファイル、`auto_pull` を true、`config` を `governance-rego.yaml` に設定します。2 回目と 3 回目は拒否されることを意図しているので、それぞれの拒否内容を読み上げてください。最初のビルドが書き込んだファイルを教えてください。それらは `policy-data-class-route/dist/` の下にあります。

停止

各エンジンでの release-unmasked.yaml です。Rego エンジン:

[… omitted: the pull's lines, and a lint notice about core/referenced-secret]
[POLICY_ERROR E0005]
policy plugin "rego" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them
caused by: policy violation

CEL エンジン:

[… omitted: the pull's lines, and a lint notice about core/referenced-secret]
[POLICY_ERROR E0005]
policy plugin "cel" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them
caused by: policy violation

OPA:

[… omitted: a warning that the OPA guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret]
[POLICY_ERROR E0005]
policy plugin "opa" rejected the build: assistant (restricted) reaches gpt (public) with no declassifying Feature attached between them
caused by: policy violation

ビルドは 1 で終了し、dist/ を書き出しません。ポリシーは、何かがレンダリングされる前にビルドグラフに対して評価されます。E0005 はポリシーによる拒否が持つ診断です。診断リファレンスを参照してください。 release-masking-off-route.yaml も、各エンジンで同じ拒否を出力します。

この文は、ポリシーが見つけた経路として読んでください。assistant は restricted のデータを保持しています。そのモデルトラフィックは plain-gateway を経由して、ポリシーが public に分類する gpt に到達し、その経路上のいずれも(アシスタントも、ゲートウェイも、モデルも)ポリシーが機密解除とみなす Feature を持っていません。異なるランクの 2 つの分類が、間に何もないまま 1 つの経路上で出会うため、ポリシーはビルドを拒否します。

pull も、固定が必要な外部入力を見つけるために Release をレンダリングし、そこで同じ拒否に遭遇します。上で省略した行にこの文が 2 回目に現れるのはそのためです。それでも lockfile は書き出されます。

満たす方法:ルート上のマスキングゲートウェイ

release-masked.yaml はクレームアシスタントを masking-gateway 経由でルーティングし、どのエンジンでもビルドが通ります。<workspace> はこの例のフォルダーを表します。

[… omitted: the pull's lines, a lint notice, under OPA a warning that its guest runs unverified, and the total build time]
Build completed: 17 files written to <workspace>/dist

マスキングゲートウェイはクレームアシスタントからモデルへの唯一のルート上にあり、ポリシーはそこでそれを読み取ります。つまり、そのルート上で、クラスが異なる地点またはそれより前にあるコンポーネントが、ポリシーの declassifying_features 設定に列挙された型のアタッチメントを持っています。ルートはレンダリングされた出力から読み取れます。dist/helm/assistant-deployment.yaml はクレームアシスタントをマスキングゲートウェイへ送り、dist/helm/helpdesk-deployment.yaml はヘルプデスクを通常のゲートウェイへ送ります。

# dist/helm/assistant-deployment.yaml, the env of the assistant's container
env:
[… omitted: the recursion limit]
- name: OPENAI_BASE_URL
value: http://masking-gateway-default:4000/v1
[… omitted: the alias, the checkpointer's address and the graph's entrypoint]
# dist/helm/helpdesk-deployment.yaml, the env of the helpdesk's container
env:
[… omitted: the recursion limit]
- name: OPENAI_BASE_URL
value: http://plain-gateway-default:4000/v1
[… omitted: the alias, the checkpointer's address and the graph's entrypoint]

マスキング自体はマスキングゲートウェイの設定、つまり dist/helm/masking-gateway/litellm-gateway-config/configmap.yaml の config.yaml キーにあります。

[… omitted: the routing table]
litellm_settings:
callbacks:
- /etc/litellm-request-guard/request_field_filter.filter
turn_off_message_logging: true
guardrails:
-
guardrail_name: masking-gateway-masking
litellm_params:
default_on: true
guardrail: litellm_content_filter
mode: pre_call
patterns:
-
action: MASK
name: claim_number
pattern: "\\bCLM-[0-9]{8}\\b"
pattern_type: regex
skip_tool_message_in_guardrail: true
[… omitted: three more guardrail entries masking the same pattern and the two entity types, and the request guard's settings]

通常のゲートウェイの設定には、ガードレールのエントリが一切ありません。

ポリシーはレンダリングされる内容を何も変更しません。 各エンジンの release-masked ツリーは、ポリシーをアタッチせずにビルドした同じ Release とバイト単位で同一です。ポリシーは判定ロールである ir-verdict ロールにアタッチされます。このロールは受理か拒否を返し、判定をディスパッチする経路にはそれを変更として適用する手段がありません。そのため、ここにあるポリシーはビルドを停止できますが、ビルドを書き換えて準拠させることはできません。

ポリシーが確認するのは、マスキングがルート上にアタッチされていることであり、何をマスクするかではありません。 誰のデータにも一致しないパターンを列挙したアタッチメントも、このアタッチメントと同様にポリシーを満たします。マスキングのアタッチメントが何を列挙するかは、そのアタッチメントを書く場所で下される、その環境自身の判断です。

Releases がアタッチメントではなくルートを動かす理由

Release は Feature をアタッチできますが、Release に書かれたアタッチメントは values を持ちません。一方、core/data-masking はマスクする対象である patterns と entities を values に保持し、どちらも列挙しないアタッチメントは停止させます。そのため、マスキングは Aggregate の masking-gateway にアタッチされ、3 つのビルドのいずれのグラフにも含まれます。

  • release-masked.yaml では、マスキングは請求アシスタントのルート上にあり、ビルドは 完了します。
  • release-unmasked.yaml では、マスキングはどのアシスタントのルート上にもなく、ビルドは停止します。
  • release-masking-off-route.yaml では、マスキングはヘルプデスクのルート上にあり、 ビルドはやはり停止します。

2 番目と 3 番目のビルドは同じアタッチメントを持ち、違いはそれが誰の ルート上にあるかだけです。どちらも停止するので、ポリシーはビルド内のアタッチメントを数えているのではなく、ルートを読んでいることがわかります。

ポリシーが読み取るもの

そのすべてはコンパイラが ir-verdict アタッチメントに渡すビルドグラフから得られ、その意味はすべてアタッチメントの設定から得られます。

  • コンパイラが列挙するルート、input.precalculated_paths:それぞれが uses エッジで結ばれたコンポーネントの順序付きリストです。release-unmasked.yaml では、そのうちの 1 つが assistant → plain-gateway → gpt です。ポリシーは各ルートを その最初のコンポーネントから読み取ります。コンパイラはすべてのコンポーネントから出るルートを列挙するため、これで十分です。ポリシー自身は何も列挙しません。
  • 各コンポーネントのクラス。 コンポーネントが class_label の指すラベル compliance.aggrega.ai/data-class を持つ場合はその値です。これを持つのは assistant のみで、値は restricted です。それ以外の場合は、コンポーネントがラベルと値を持つ最初の classes_by_label エントリのクラスです。
  • 各コンポーネントのアタッチメント、input.graph.spec.feature_values_mapping。 ルート自体の attached_features リストは意図的に読み取りません。これはルート上のどこかにアタッチされたすべての Feature を挙げるため、 対象の 2 つのコンポーネントの間に Feature があるかどうかを示せないからです。

クラスを持たないコンポーネントは無視されます。ルートが描かれる向き(接続はリクエストを一方向に、その応答を逆方向に運びます)と、 設定で同じ順位とされるクラスも同様に無視されます。

モデルのクラスはホスティングラベルから得られます。 gpt はクラスラベルを持ちません。 その Component である core/ai-model/openai は component.aggrega.ai/hosting: managed を持ちます。これは、サービスがクラスタ外でその提供元によって運用されているというカタログの記述であり、設定はこれをクラスに対応付けます。

classes_by_label:
- label: component.aggrega.ai/hosting
value: managed
class: public

マネージドモデルは送られたものを何でも保持し、この環境ではそれを public として扱います。 core/ai-model/vllm のようなセルフホストモデルや、ここにある 2 つのゲートウェイは、代わりに self-hosted を持つため、クラスを持ちません。

ルートには上限があります。 コンパイラは各開始コンポーネントから上限のある数のルートを列挙し、上限を超えたものは列挙しません。そのため、それより多くのルートを持つグラフでは、 ルートが読み取られないままビルドが通ることがあります。ポリシーが読み取るルートは実在しますが、ルートがないことはそれが存在しない証明にはなりません。 verdict ロールを参照してください。

クラスはコンパイラのものではなく、ポリシーのもの

コンパイラは compliance.aggrega.ai/data-class を文字列としてビルドグラフに渡し、そこに意味を読み取りません。restricted が public より機密性が高いことも、どちらの語が何かを意味することも、コンパイラは知りません。クラスとその順位はポリシーの設定であり、3 つのエンジンファイルすべてで同じです。

class_label: compliance.aggrega.ai/data-class
rank:
public: 0
internal: 1
restricted: 2

独自の語彙を持つ環境は、それを独自のものに置き換えます。クラスとその順序を rank に、クラスを保持するラベルを class_label に、導出を classes_by_label に、機密解除として受け入れる Features を declassifying_features に記述します。3 つのエンジンファイルは同じように変更してください。ファイル間の違いはエンジンの判定の違いになるためです。component が持つクラスのうち rank に列挙されていないものは、クラスなしとして読まれるのではなくビルドを停止させるため、綴りの誤りは見過ごされずに報告されます。claims assistant のラベルを Restricted と書くと、すべてのエンジンが release-masked.yaml を拒否します。aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull は以下の拒否を出力し、他の各エンジンのファイルも、そのエンジン名を見出しにした同じ拒否を出力します。

[… omitted: under OPA a warning that its guest runs unverified, the pull's lines, and a lint notice about core/referenced-secret]
[POLICY_ERROR E0005]
policy plugin "rego" rejected the build: assistant carries the data class "Restricted", which the policy's rank setting does not list; correct the class or rank it
caused by: policy violation

クラスを持つのは標準ライブラリの Component ではなく、このワークスペース自身の Component です。アシスタントが制限付きデータを扱うかどうかは、環境がそれをどう使うかについての記述であり、LangGraph についての記述ではありません。そのため local/ai-agent/claims-assistant は core/ai-agent/langgraph を拡張し、その契約を継承して、ラベルを 1 つ追加します。Aggregate は component インスタンスにラベルを付けられないため、クラスは常に、インスタンスが宣言される Component のプロパティです。代わりに claims assistant を標準ライブラリのエージェントとして宣言すると、クラスラベルを持つ component はなくなり、release-unmasked.yaml はすべてのエンジンでビルドされ、その結果はポリシーなしでビルドしたものとバイト単位で同一になります。モデルは引き続き public を導出しますが、それと出会う 2 つ目のクラスが存在しないためです。

3 つのエンジン、3 回書かれたルール

エンジンアタッチ方法ルール
CLI に組み込まれた Rego エンジンgovernance-rego.yamlwith.sources で指定する policies/data-class-paths.rego
CLI に組み込まれた CEL エンジンgovernance-cel.yamlwith.sources で指定する policies/data-class-paths.cel
リファレンスアダプターのゲストの背後にある OPAgovernance-opa.yamlゲストにコンパイルされた policies/data-class-paths-opa.rego

3 つのコピーは意図的なほぼ重複です。 それぞれがルールから独立して書かれているため、エンジン間で判定が食い違うビルドではその食い違いが現れます。同じビルドがあるエンジンでは停止し、別のエンジンでは完了することがそのシグナルです。どれも他から生成されたものではなく、1 つの共有実装に統合すべきものでもありません。統合すると構造上エンジンの判定が一致してしまい、これが検出するために存在する差異が隠れてしまいます。各ファイルの冒頭にもそのことが書かれています。

コピー同士は、エンジンが異なる箇所で異なります。

  • CEL のコピーは名前を値に束縛することも、リストの位置を走査することもできないため、設定に positions という項目が 1 つ多く含まれます。これはルートの component を読み取る位置 0 ~ 15 です。これより長いルートは、一部だけ読み取られるのではなく、その開始位置を示してビルドを停止させます。
  • OPA のコピーは OPA 自身のツールチェーンで事前にコンパイルされ、catalog/plugin/governance/opa/1.0.0/plugin.yaml の隣にあるゲストに組み込まれています。そのため、このアタッチメントは設定を提供し、ポリシーファイルは提供しません。アダプターは OPA がホストに委ねる組み込み関数を一切提供しないため、Rego エンジンのコピーが sprintf でメッセージを整形する箇所を、このコピーは concat で連結します。これを編集しても、後述のとおりゲストを再ビルドするまではどのビルドも変わりません。

Rego と CEL のアタッチメントは、CLI に組み込まれた 2 つのエンジンのために標準ライブラリのカタログが含む Plugin エンティティ、governance/rego:0.9.0 と governance/cel:0.9.0 を指定し、実際に動くエンジンはビルドを実行しているバイナリに組み込まれたものです。OPA の Plugin エンティティは catalog/plugin/governance/ にあり、このワークスペース独自のバージョン 1.0.0 の宣言であるため、そのアタッチメントは governance/opa:1.0.0 を指定します。拒否メッセージの見出しには、アタッチメントの参照の最後のセグメントがバージョンを除いて付きます(policy plugin "rego"、"cel" または "opa")。各ビルドは 1 つのエンジンをアタッチするため、出力される拒否メッセージにはそのエンジン名が示されます。OPA のゲストはビルドのたびにエンティティの隣から読み込まれ、そのダイジェストはどこにも記録されないため、それを使うビルドでは毎回、検証されずに実行される旨の警告が出ます。

すべてのビルドの確認

このセルフチェックは、使用する共有ビルドヘルパーを含むドキュメントリポジトリのチェックアウトで実行されます。aggrega scaffold --example が書き出したコピーには、そのヘルパーは含まれません。

Terminal window
./check.sh

check.sh は ./build-release.sh を通じて 3 つの Releases を 3 つのエンジンでビルドし、それぞれの結果をこのページが説明する結果と照合します。停止の場合は、メッセージが上記の文である E0005 でゼロ以外の終了コードを返し、それ以外の拒否が並んでいてはなりません。完了したビルドの場合は、終了コード 0 で終了し、ポリシーなしでビルドした同じ Release と 1 バイト単位で同一のファイルを書き出す必要があります。このポリシーなしのビルドは、基準として最初に行われます。どのエンジンにも同じ文が求められます。ビルドごとに 1 行を出力し、いずれかの結果が異なる場合はそのビルドの出力を表示して終了コード 1 で終了します。

ENGINE RELEASE EXIT EXPECTED VERDICT
------------------------------------------------------------------------------------------
none release-masked.yaml 0 reference OK
rego release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
rego release-unmasked.yaml 1 halt OK: E0005, the expected sentence
rego release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
cel release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
cel release-unmasked.yaml 1 halt OK: E0005, the expected sentence
cel release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
opa release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policy
opa release-unmasked.yaml 1 halt OK: E0005, the expected sentence
opa release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
check: every build ended as expected.

必要なものは単一のビルドと同じで、標準ライブラリのカタログと hub レジストリです。./build-release.sh が解決するバイナリを使うため、AGGREGA_BIN でそれを選択できます。-- 以降の引数はすべてのビルドに渡されるため、取得するものがすべてキャッシュされていれば、./check.sh -- --offline でネットワークなしに実行できます。ビルドが書き出すツリーを比較するため、このディレクトリに dist/ がある間は開始を拒否し、終了後にも何も残しません。終了ステータスが判定のすべてであるため、パイプラインでは各 Release を個別にビルドする代わりにこれを実行できます。

OPA ゲストの再ビルド

catalog/plugin/governance/opa/1.0.0/governance--opa.wasm は、プラグインキットに含まれるリファレンスの OPA アダプターゲスト(aggrega-pdk リポジトリの rust/examples/policy-opa-wasm)で、アダプター自身のモジュールの代わりに、OPA が policies/data-class-paths-opa.rego からコンパイルしたモジュールを組み込んだものです。これは aggrega-pdk の afd9ac6c6800c34c6c47a2030f580c9681387047 と、アダプターがビルド時に依存する ABI クレートである aggrega-abi の 2ececa8d3b598243f023a2a6c80b351c8d1411a1 から、rustc 1.97.1 を使い、OPA 1.21.1 がコンパイルしたモジュールを組み込んでビルドされました。

まず、このディレクトリでモジュールをビルドします。ルールをここからの相対パスで指定すると、モジュールにはそのパスだけが残り、マシンに関する情報は何も含まれません。

Terminal window
opa build -t wasm -e data_class_paths/deny policies/data-class-paths-opa.rego -o bundle.tar.gz
tar -xzf bundle.tar.gz -O /policy.wasm > policy.wasm
rm bundle.tar.gz
sha256sum policy.wasm
# 321e8a1f150a7ef7625e174cf636967b6c0e1f7bd39c3b7fa1010838ce35c871 policy.wasm

OPA 1.21.1 は、このワークスペースがどのディレクトリにあっても、同じソースから同じバイト列をコンパイルします。

次に、絶対パスで指定したスクラッチディレクトリ $BUILD でゲストをビルドします。このディレクトリには 2 つのリポジトリを並べて置き、アダプターのパス依存関係が一方から他方を参照するようにします。3 つのパスマップにより、ビルドディレクトリ、cargo のホーム、ツールチェーン自身のソースがゲストに含まれないようにします。

Terminal window
mkdir -p "$BUILD/aggrega-pdk" "$BUILD/aggrega-abi"
git -C <aggrega-pdk checkout> archive afd9ac6c6800c34c6c47a2030f580c9681387047 | tar -x -C "$BUILD/aggrega-pdk"
git -C <aggrega-abi checkout> archive 2ececa8d3b598243f023a2a6c80b351c8d1411a1 | tar -x -C "$BUILD/aggrega-abi"
cp policy.wasm "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm/policy.wasm"
cd "$BUILD/aggrega-pdk/rust/examples/policy-opa-wasm"
SRC="$(rustc +stable --print sysroot)/lib/rustlib/src/rust"
HASH="$(rustc +stable -vV | awk '/^commit-hash: /{print $2}')"
RUSTFLAGS="--remap-path-prefix=$BUILD=/build --remap-path-prefix=${CARGO_HOME:-$HOME/.cargo}=/cargo --remap-path-prefix=$SRC=/rustc/$HASH" \
CARGO_TARGET_DIR="$BUILD/target" \
cargo +stable build --locked --release --target wasm32-wasip1

そして $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm を catalog/plugin/governance/opa/1.0.0/governance--opa.wasm にコピーします。

ゲストは cargo ビルドの出力をそのまま使います。アダプター自身のビルドスクリプトはオプションのサイズ削減処理も実行しますが、ここではスキップしています。この処理はゲストのデータを書き換えるため、これを行わなければモジュールはバイト単位でそのままゲスト内に残ります。これにより、ゲストが含むものを、ルールのコンパイル結果と照合できます。

Terminal window
python3 -c 'import sys; print(open(sys.argv[1], "rb").read() in open(sys.argv[2], "rb").read())' \
policy.wasm catalog/plugin/governance/opa/1.0.0/governance--opa.wasm
# True

ゲスト自体のバイト列は、クレートをビルドしたディレクトリとツールチェーンにも依存するため、別の場所で再ビルドすると、sha256 の異なる同等のゲストになります。ここで同梱しているものは eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93 です。

コンパイラが解釈しない箇所

コンパイラはクラスラベルを文字列としてビルドグラフに渡し、Aggregate と Releases が宣言した uses エッジ上のルートを列挙し、その両方をポリシーに渡します。コンパイラはクラスに順位を付けず、managed がデータがクラスタを出て provider へ向かうことを意味するとは知らず、core/data-masking が何かを隠すことも知りません。こうした意味はすべてポリシーの設定であり、そのため、別のクラス、別のラベル、別の機密解除 Features を持つ環境でも、同じ仕組みを変更せずに実行できます。ポリシーがアタッチされるソケット(ロール、ペイロード、判定の重大度)についてはポリシーソケットを、製品の中でポリシーが占める位置についてはガバナンスとコンプライアンスを参照してください。

ファイル

  • aggregate.yaml — 2 つのアシスタント、それらのチェックポインター、2 つのゲートウェイ、 モデル、認識器のペア。マスキングは masking-gateway にアタッチされ、 どちらのアシスタントの model ソケットもバインドされていません。
  • manifest.yaml — すべてのコンポーネント型と両方の Feature 型をそれぞれの Kubernetes Recipes にバインドし、請求アシスタントをベースエージェントの Recipe にバインドします。3 つの Releases で 共有されます。
  • release-masked.yaml、release-unmasked.yaml、 release-masking-off-route.yaml — 3 つのルーティングと、各 ゲートウェイのキーの読み取り元となる Secret。
  • catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml — 請求アシスタント。クラスラベルを追加した core/ai-agent/langgraph です。
  • catalog/plugin/governance/opa/1.0.0/plugin.yaml — OPA エンジンの Plugin エンティティ。その隣にゲスト governance--opa.wasm があります。
  • policies/data-class-paths.rego、policies/data-class-paths.cel、 policies/data-class-paths-opa.rego — ルールをエンジンごとに 1 つずつ記述したもの。
  • governance-rego.yaml、governance-cel.yaml、governance-opa.yaml — エンジンごとに 1 つの --config ファイル。それぞれが同じ設定でルールを ir-verdict に アタッチします。
  • .aggrega-config.yaml — カタログ検索スタックとレジストリ。ガバナンスの アタッチメントはありません。
  • build-release.sh — 1 つの Release をビルドし、同等の aggrega build コマンドを表示します。
  • check.sh — 9 つすべてをビルドし、それぞれの結果を確認します。