Polityka, która zatrzymuje budowanie, gdy dane zastrzeżone docierają do zarządzanego modelu bez maskowania
Środowisko obsługuje asystenta roszczeń, który przetwarza zastrzeżone dane klientów, oraz asystenta helpdesku, który nie przetwarza żadnych. Oba kierują ruch do modelu do zarządzanego API OpenAI przez bramę AI działającą w klastrze. Wewnętrzna zasada środowiska:
Dane jednej klasy nie docierają do komponentu innej klasy wzdłuż trasy grafu budowania, chyba że na tej trasie dołączona jest deklasyfikująca encja Feature.
Ten obszar roboczy dołącza tę zasadę jako politykę nad grafem budowania i buduje trzy Releases jednej encji Aggregate. W jednej z nich żądania asystenta roszczeń przechodzą przez bramę, która je maskuje, i budowanie kończy się powodzeniem. W pozostałych dwóch nie przechodzą i budowanie zatrzymuje się, zanim cokolwiek zostanie wyrenderowane, a polityka wskazuje oba końce trasy.
Zasada jest zapisana trzy razy, raz dla każdego silnika polityk, na którym działa — silników Rego i CEL wkompilowanych w CLI oraz OPA — i wszystkie trzy kopie dają zgodny wynik przy każdym budowaniu w tym przykładzie. Skrypt umieszczony obok encji Releases buduje wszystkie dziewięć kombinacji i sprawdza każdy wynik.
Co powstaje
| instancja | encja Component z katalogu | czym jest tutaj |
|---|---|---|
assistant | local/ai-agent/claims-assistant | asystent ds. roszczeń: agent LangGraph z biblioteki standardowej, zadeklarowany w katalogu tego obszaru roboczego z jedną dodaną etykietą — klasą danych, które obsługuje |
helpdesk | core/ai-agent/langgraph | asystent helpdesku, który nie ma żadnej klasy |
checkpointer | core/datastore/valkey | miejsce, w którym oba asystenty przechowują stan swoich przebiegów |
masking-gateway | core/gateway/litellm | bramka AI obsługująca jeden alias, chat, z dołączonym core/data-masking |
plain-gateway | core/gateway/litellm | ta sama bramka bez żadnych dołączeń |
gpt | core/ai-model/openai | zarządzane API OpenAI, osiągane jako odwołanie: nic nie działa dla niego w klastrze |
analyzer, anonymizer | core/security/presidio-analyzer, core/security/presidio-anonymizer | usługi rozpoznawania, które wywołuje maskowanie |
Obie bramki są połączone z gpt przez swoje gniazdo models, a każda przedstawia
na tym połączeniu klucz modelu. Dołączenie maskowania wymienia, co należy maskować:
wzorzec numerów roszczeń organizacji oraz typy encji PERSON i
EMAIL_ADDRESS. Oba asystenty deklarują gniazdo model, które deklaruje ich encja Component
i które przyjmuje model lub bramkę obsługującą API modelu, i pozostawiają je
niepowiązane: łączy je każda encja Release.
Trzy encje Releases
Encje Releases różnią się wyłącznie tym, przez którą bramę przechodzi ruch do modelu każdego z asystentów:
| Release | ruch asystenta ds. roszczeń | ruch asystenta helpdesku | budowanie |
|---|---|---|---|
release-masked.yaml | przez masking-gateway | przez plain-gateway | kończy się powodzeniem |
release-unmasked.yaml | przez plain-gateway | przez plain-gateway | zostaje zatrzymane |
release-masking-off-route.yaml | przez plain-gateway | przez masking-gateway | zostaje zatrzymane |
Każda encja Release wiąże gniazdo model obu asystentów z bramą zadeklarowaną
przez encję Aggregate. Jest to okablowanie krawędzi w obrębie gniazda deklarowanego przez encję Component,
na co encja Release może sobie pozwolić; nie dodaje ona żadnego komponentu ani nie zmienia żadnej wartości.
Generowanie przykładu
Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example policy-data-class-routeNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd policy-data-class-routeKompilacja
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pullaggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1Aby uruchomić tę samą regułę w innym silniku, należy zamienić governance-rego.yaml na governance-cel.yaml lub governance-opa.yaml.
--config wskazuje globalny plik konfiguracyjny dla danego uruchomienia. Jest on odczytywany
zamiast tego, który maszyna odczytałaby w przeciwnym razie — pliku wskazanego przez AGGREGA_CONFIG
lub pliku w domyślnej lokalizacji — a własny plik .aggrega-config.yaml tego obszaru roboczego
nadal jest nakładany na niego. W tym uruchomieniu nie ma więc zastosowania nic z własnego
globalnego pliku: inne podłączenie zarządzania, default_registry, ustawienie trybu offline.
Poświadczenie zapisane za pomocą aggrega login nie jest częścią tego pliku
i nadal obowiązuje. Plik obszaru roboczego deklaruje katalogi katalogu i nie ma własnego
podłączenia zarządzania; zadeklarowana w nim lista zastąpiłaby listę z
wskazanego pliku, więc uruchamiane jest podłączenie z wskazanego pliku.
Polityka zarządzania jest podłączana przez konfigurację, a nie przez encję Release — encja Release nie ma na nią pola — dlatego silnik wybiera się dla każdego budowania, a nie dla każdej encji Release.
Przed pierwszym budowaniem muszą być spełnione dwa warunki:
- Katalog biblioteki standardowej.
.aggrega-config.yamlwymienia własnycatalog/tego obszaru roboczego, który zawiera asystenta roszczeń i encję Plugin silnika OPA. Cała reszta, w tym encje Plugin silników Rego i CEL, jest rozwiązywana z opisanego niżej rejestru hub lub z kopii roboczej katalogu wskazanej za pomocą--catalog. - Rejestr hub. Realizacja maskowania danych zapisuje swoje zabezpieczenia za pomocą jednej wtyczki, która nie jest dostarczana ani z kompilatorem, ani z katalogiem — kroku konfiguracji bramy
pipeline-step/litellm-gateway-config— a budowanie pobiera ją z rejestru wskazanego przezdefault_registry, czylihub.aggrega.ai.
--auto-pull wypełnia plik blokady każdej encji Release podczas budowania; pliki blokady i
wyrenderowane wyjście są generowane, a nie dostarczane.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder Workspace nie zawiera jeszcze folderu `policy-data-class-route`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `policy-data-class-route` i bez `dir`: zapisuje ono przykład w nowym folderze `policy-data-class-route`. Następnie wywołaj narzędzie `cli-build`, które uruchamia `aggrega build` i przyjmuje jego flagę `--config`, raz dla każdej encji Release, w tej kolejności — `release-masked.yaml`, `release-unmasked.yaml` i `release-masking-off-route.yaml` — za każdym razem z `workspace_root` ustawionym na `policy-data-class-route`, `release` ustawionym na ten plik, `auto_pull` ustawionym na true i `config` ustawionym na `governance-rego.yaml`. Druga i trzecia kompilacja mają zostać odrzucone, więc odczytaj mi każdą odmowę. Powiedz mi, jakie pliki zapisała pierwsza kompilacja; znajdują się w `policy-data-class-route/dist/`.Zatrzymanie
release-unmasked.yaml w każdym z silników. Silnik 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 violationSilnik 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 violationOPA:
[… 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 violationBudowanie kończy się kodem 1 i nie zapisuje katalogu dist/: polityka jest ewaluowana na grafie budowania, zanim cokolwiek zostanie wyrenderowane. E0005 to diagnostyka, którą niesie odmowa polityki — zob. dokumentację diagnostyk.
release-masking-off-route.yaml wypisuje tę samą odmowę w każdym z silników.
Zdanie należy czytać jako znalezioną trasę. assistant przechowuje dane restricted. Jego
ruch do modelu dociera do gpt, który polityka klasyfikuje jako public, przez
plain-gateway, a nic na tej trasie — ani asystent, ani bramka,
ani model — nie niesie encji Feature, którą polityka uznaje za deklasyfikującą. Dwie klasy
o różnych rangach spotykają się na jednej trasie bez niczego pomiędzy, więc polityka
odmawia budowania.
Pobieranie również renderuje encję Release, aby znaleźć zewnętrzne dane wejściowe wymagające przypięcia, i napotyka tam tę samą odmowę; dlatego pominięte wyżej wiersze zawierają to zdanie po raz drugi. Plik lockfile i tak zostaje zapisany.
Spełnienie polityki: bramka maskująca na trasie
release-masked.yaml kieruje asystenta roszczeń przez masking-gateway i każdy silnik pozwala go zbudować, przy czym <workspace> oznacza folder tego przykładu:
[… 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>/distBramka maskująca znajduje się teraz na jedynej trasie asystenta roszczeń do modelu i polityka odczytuje ją właśnie tam: na tej trasie, w punkcie, w którym klasy się różnią, lub przed nim, komponent ma dołączenie, którego typ jest wymieniony w ustawieniu declassifying_features polityki. Trasę można odczytać z wyrenderowanego wyniku: dist/helm/assistant-deployment.yaml kieruje asystenta roszczeń do bramki maskującej, a dist/helm/helpdesk-deployment.yaml kieruje helpdesk do zwykłej bramki.
# dist/helm/assistant-deployment.yaml, the env of the assistant's containerenv: [… 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 containerenv: [… 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]Samo maskowanie znajduje się w konfiguracji bramki maskującej, w kluczu config.yaml pliku dist/helm/masking-gateway/litellm-gateway-config/configmap.yaml:
[… omitted: the routing table]litellm_settings: callbacks: - /etc/litellm-request-guard/request_field_filter.filter turn_off_message_logging: trueguardrails: - 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]Konfiguracja zwykłej bramki nie zawiera żadnych wpisów guardrail.
Polityka niczego nie zmienia w tym, co jest renderowane. Drzewo release-masked każdego silnika jest bajtowo identyczne z tą samą encją Release zbudowaną bez dołączonej polityki. Polityka jest dołączona w roli ir-verdict, roli werdyktu: zwraca akceptację albo odmowę, a ścieżka przekazująca werdykt nie ma możliwości zastosowania go jako zmiany, więc polityka w tym miejscu może zatrzymać budowanie, ale nie może go przepisać tak, by stało się zgodne.
Polityka sprawdza, czy maskowanie jest dołączone na trasie, a nie to, co maskuje. Dołączenie wymieniające wzorzec, do którego nie pasują niczyje dane, spełnia ją równie dobrze jak to. To, co wymienia dołączenie maskujące, jest własną oceną danego środowiska, dokonaną tam, gdzie dołączenie jest zapisane.
Dlaczego Releases przesuwają trasę, a nie podpięcie
Encja Release może podpiąć Feature, ale podpięcie zapisane w encji Release nie niesie
values, a core/data-masking przechowuje to, co maskuje — patterns i entities
— w values, zatrzymując podpięcie, które nie wymienia żadnego z nich. Dlatego maskowanie jest
podpięte w encji Aggregate, na masking-gateway, i znajduje się w grafie każdej
z trzech kompilacji:
- w
release-masked.yamlleży na trasie asystenta roszczeń, a kompilacja kończy się powodzeniem; - w
release-unmasked.yamlnie leży na trasie żadnego asystenta, a kompilacja zostaje zatrzymana; - w
release-masking-off-route.yamlleży na trasie helpdesku, a kompilacja znów zostaje zatrzymana.
Druga i trzecia kompilacja mają to samo podpięcie i różnią się tylko tym, na czyjej trasie się ono znajduje. Obie zostają zatrzymane, więc polityka odczytuje trasę, a nie liczy podpięć w kompilacji.
Co odczytuje polityka
Wszystko to pochodzi z grafu builda, który kompilator przekazuje dołączeniu ir-verdict,
a całe znaczenie z ustawień tego dołączenia:
- Trasy wyliczane przez kompilator,
input.precalculated_paths: każda to uporządkowana lista komponentów połączonych krawędziamiuses. Wrelease-unmasked.yamljedną z nich jestassistant → plain-gateway → gpt. Polityka odczytuje każdą trasę od jej pierwszego komponentu, co wystarcza, ponieważ kompilator wylicza trasy wychodzące z każdego komponentu. Sama niczego nie wylicza. - Klasa każdego komponentu. Wartość etykiety wskazanej przez
class_label,compliance.aggrega.ai/data-class, jeśli komponent ją ma: ma ją tylkoassistant, z wartościąrestricted. W przeciwnym razie klasa pierwszego wpisuclasses_by_label, którego etykietę i wartość ma komponent. - Dołączenia każdego komponentu,
input.graph.spec.feature_values_mapping. Własna lista trasyattached_featurescelowo nie jest odczytywana: wymienia każdą encję Feature dołączoną w dowolnym miejscu trasy, więc nie może powiedzieć, czy któraś znajduje się między dwoma rozpatrywanymi komponentami.
Komponent bez klasy jest pomijany. Podobnie kierunek, w którym narysowano trasę — połączenie przenosi żądanie w jedną stronę, a odpowiedź w drugą — oraz klasy, którym ustawienia przypisują tę samą rangę.
Klasa modelu wynika z jego etykiety hostingu. gpt nie ma etykiety klasy.
Jego encja Component, core/ai-model/openai, ma component.aggrega.ai/hosting: managed, czyli deklarację katalogu, że usługę prowadzi jej dostawca,
poza klastrem, a ustawienia przypisują temu klasę:
classes_by_label: - label: component.aggrega.ai/hosting value: managed class: publicModel zarządzany przechowuje wszystko, co się do niego wyśle, co to środowisko traktuje jako publiczne.
Model hostowany samodzielnie, taki jak core/ai-model/vllm, oraz każda z bram w tym przykładzie mają
zamiast tego self-hosted, a więc nie mają klasy.
Trasy są ograniczone. Kompilator wymienia ograniczoną liczbę tras z każdego komponentu początkowego i nie wymienia niczego ponad ten limit, więc w grafie z większą liczbą tras jakaś trasa może pozostać nieodczytana, a build przejść. Trasa, którą polityka odczytuje, jest rzeczywista; brak trasy nie dowodzi, że ona nie istnieje. Zob. role werdyktów.
Klasy należą do polityki, nie do kompilatora
Kompilator przenosi compliance.aggrega.ai/data-class do grafu budowania jako
ciąg znaków i nie przypisuje mu żadnego znaczenia. Nie wie, że restricted jest bardziej
wrażliwe niż public ani że którekolwiek z tych słów cokolwiek znaczy. Klasy i ich
uszeregowanie są ustawieniami polityki, takimi samymi we wszystkich trzech plikach silników:
class_label: compliance.aggrega.ai/data-classrank: public: 0 internal: 1 restricted: 2Środowisko z własnym słownictwem podstawia własne: swoje klasy i ich
kolejność w rank, etykietę, w której je przechowuje, w class_label, swoje
wyprowadzenia w classes_by_label oraz encje Features, które uznaje za odtajniające,
w declassifying_features. Wszystkie trzy pliki silników należy zmieniać jednakowo, ponieważ
różnica między nimi jest różnicą między werdyktami silników. Klasa, którą nosi
komponent, a której rank nie wymienia, zatrzymuje budowanie, zamiast być traktowana
jako brak klasy, dzięki czemu literówka zostaje zgłoszona, zamiast przejść. Gdy etykieta
asystenta roszczeń jest zapisana jako Restricted, każdy silnik odrzuca release-masked.yaml;
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull wypisuje poniższą odmowę, a plik każdego z pozostałych silników wypisuje
taką samą, zatytułowaną nazwą danego silnika:
[… 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 violationKlasę nosi własna encja Component tego obszaru roboczego, a nie encja
biblioteki standardowej. To, czy asystent obsługuje dane zastrzeżone, jest stwierdzeniem o tym,
jak dane środowisko go używa, a nie o LangGraph, dlatego local/ai-agent/claims-assistant
rozszerza core/ai-agent/langgraph, dziedziczy jego kontrakt i dodaje tę jedną etykietę.
Encja Aggregate nie może nadać etykiety instancji komponentu, więc klasa jest zawsze
właściwością encji Component, jako której instancja jest zadeklarowana. Gdy asystent roszczeń
jest zamiast tego zadeklarowany jako agent z biblioteki standardowej, żaden komponent nie nosi
etykiety klasy, a release-unmasked.yaml buduje się pod każdym silnikiem, bajt w bajt tak,
jak bez polityki: model nadal wyprowadza public, ale nie ma drugiej klasy, z którą mógłby się spotkać.
Trzy silniki, reguła zapisana trzy razy
| silnik | dołączany przez | reguła |
|---|---|---|
| silnik Rego wkompilowany w CLI | governance-rego.yaml | policies/data-class-paths.rego, wskazany w with.sources |
| silnik CEL wkompilowany w CLI | governance-cel.yaml | policies/data-class-paths.cel, wskazany w with.sources |
| OPA, za referencyjnym gościem adaptera | governance-opa.yaml | policies/data-class-paths-opa.rego, wkompilowany w gościa |
Trzy kopie to celowy niemal-duplikat. Każda jest napisana osobno na podstawie reguły, dzięki czemu kompilacja, co do której silniki się nie zgadzają, ujawnia tę niezgodność: sygnałem jest ta sama kompilacja zatrzymana przez jeden silnik i ukończona przez inny. Żadna nie jest generowana z innej i nie należy ich łączyć w jedną wspólną implementację, która sprawiłaby, że silniki zgadzałyby się z założenia, i ukryłaby różnicę, której wychwytywaniu to służy. Każdy plik zaczyna się od tej informacji.
Różnią się tam, gdzie różnią się silniki:
- Kopia CEL nie może powiązać nazwy z wartością ani przechodzić po pozycjach listy, więc
jej ustawienia zawierają jeden wpis więcej,
positions, czyli pozycje od 0 do 15, na których odczytywane są komponenty trasy. Dłuższa trasa zatrzymuje kompilację, ze wskazaniem miejsca, w którym się zaczyna, zamiast zostać odczytana częściowo. - Kopia OPA jest kompilowana z wyprzedzeniem własnym zestawem narzędzi OPA i wbudowywana
w gościa obok
catalog/plugin/governance/opa/1.0.0/plugin.yaml, więc jej dołączenie dostarcza ustawień, a nie pliku polityki. Adapter nie udostępnia żadnej z funkcji wbudowanych, które OPA pozostawia hostowi, dlatego ta kopia łączy komunikaty za pomocąconcat, tam gdzie kopia silnika Rego formatuje je za pomocąsprintf. Jej edycja nie zmienia żadnej kompilacji, dopóki gość nie zostanie przebudowany, jak opisano niżej.
Dołączenia Rego i CEL wskazują encje Plugin, które katalog biblioteki standardowej zawiera dla dwóch silników wkompilowanych w CLI, governance/rego:0.9.0 i governance/cel:0.9.0, a działa ten silnik, który jest wkompilowany w plik binarny wykonujący kompilację. Encja Plugin dla OPA, w catalog/plugin/governance/, to własna deklaracja tego obszaru roboczego w wersji 1.0.0, więc jej dołączenie wskazuje governance/opa:1.0.0. Nagłówkiem odmowy jest ostatni segment referencji dołączenia, bez wersji — policy plugin "rego", "cel" lub "opa" — a każda kompilacja dołącza jeden silnik, więc wypisywana przez nią odmowa wskazuje ten silnik. Gość OPA jest odczytywany spod swojej encji przy każdej kompilacji, a ponieważ nic nie zapisuje jego skrótu, każda kompilacja z nim ostrzega, że działa on bez weryfikacji.
Sprawdzanie każdej kompilacji
Ten autotest działa w kopii roboczej repozytorium dokumentacji, która zawiera używany przez niego wspólny skrypt pomocniczy budowania; kopia zapisana przez aggrega scaffold --example tego skryptu nie zawiera.
./check.shcheck.sh kompiluje trzy encje Releases w trzech silnikach za pomocą
./build-release.sh i porównuje każdy wynik z tym, który opisuje ta strona.
Zatrzymanie musi zakończyć się niezerowym kodem wyjścia z E0005, którego komunikatem jest zdanie
powyżej, i bez żadnej innej odmowy obok niego; ukończona kompilacja musi zakończyć się kodem 0 i zapisać
te same pliki, bajt w bajt, co ta sama encja Release skompilowana bez polityki, którą
skrypt kompiluje najpierw jako odniesienie. Każdy silnik jest rozliczany z tego samego zdania. Skrypt wypisuje
jeden wiersz na kompilację i kończy się kodem 1, jeśli którykolwiek wynik się różni, wypisując
wyjście tej kompilacji:
ENGINE RELEASE EXIT EXPECTED VERDICT------------------------------------------------------------------------------------------none release-masked.yaml 0 reference OKrego release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyrego release-unmasked.yaml 1 halt OK: E0005, the expected sentencerego release-masking-off-route.yaml 1 halt OK: E0005, the expected sentencecel release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policycel release-unmasked.yaml 1 halt OK: E0005, the expected sentencecel release-masking-off-route.yaml 1 halt OK: E0005, the expected sentenceopa release-masked.yaml 0 pass OK: completed, byte-identical to the build with no policyopa release-unmasked.yaml 1 halt OK: E0005, the expected sentenceopa release-masking-off-route.yaml 1 halt OK: E0005, the expected sentence
check: every build ended as expected.Potrzebuje tego samego, czego potrzebuje pojedyncza kompilacja: katalogu biblioteki standardowej i rejestru hub. Używa pliku binarnego, który wskazuje ./build-release.sh, więc wybiera go AGGREGA_BIN; argumenty po -- trafiają do każdej kompilacji, więc ./check.sh -- --offline uruchamia go bez sieci, gdy wszystko, co pobiera, jest już w pamięci podręcznej. Odmawia uruchomienia, dopóki w tym katalogu znajduje się dist/, ponieważ porównuje drzewa zapisywane przez kompilacje, i nie pozostawia żadnego po sobie. Jego kod wyjścia stanowi cały werdykt, więc potok może go uruchomić zamiast kompilować każdą encję Release osobno.
Ponowna kompilacja gościa OPA
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm to referencyjny gość adaptera OPA z zestawu do tworzenia wtyczek, rust/examples/policy-opa-wasm w repozytorium aggrega-pdk, w którym zamiast własnego modułu adaptera znajduje się moduł skompilowany przez OPA z policies/data-class-paths-opa.rego. Został zbudowany z aggrega-pdk w wersji afd9ac6c6800c34c6c47a2030f580c9681387047 oraz aggrega-abi, skrzynki ABI, względem której buduje się adapter, w wersji 2ececa8d3b598243f023a2a6c80b351c8d1411a1, przy użyciu rustc 1.97.1, wokół modułu skompilowanego przez OPA 1.21.1.
Najpierw moduł, z tego katalogu. Wskazanie reguły ścieżką względną wobec tego katalogu sprawia, że w module zostaje ta ścieżka i nic z maszyny:
opa build -t wasm -e data_class_paths/deny policies/data-class-paths-opa.rego -o bundle.tar.gztar -xzf bundle.tar.gz -O /policy.wasm > policy.wasmrm bundle.tar.gzsha256sum policy.wasm# 321e8a1f150a7ef7625e174cf636967b6c0e1f7bd39c3b7fa1010838ce35c871 policy.wasmOPA 1.21.1 kompiluje te same bajty z tego samego źródła niezależnie od katalogu, w którym znajduje się ten obszar roboczy.
Następnie gość, w katalogu tymczasowym $BUILD, podanym jako ścieżka bezwzględna,
zawierającym oba repozytoria obok siebie, tak by zależność ścieżkowa adaptera sięgała
z jednego do drugiego. Trzy mapowania ścieżek sprawiają, że katalog kompilacji, katalog domowy
cargo i własne źródła toolchainu nie trafiają do gościa:
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-wasip1a następnie skopiować $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm do
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm.
Gość to wynik kompilacji cargo w niezmienionej postaci. Własny skrypt budujący adaptera uruchamia też opcjonalny przebieg zmniejszający rozmiar, który tutaj jest pomijany: przepisuje on dane gościa, a bez niego moduł pozostaje w gościu bajt w bajt. Dzięki temu można sprawdzić, co zawiera gość, porównując to z wynikiem kompilacji reguły:
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# TrueWłasne bajty gościa zależą także od katalogu, w którym zbudowano jego skrzynki, oraz od toolchainu, więc ponowna kompilacja w innym miejscu daje równoważnego gościa o innym sha256. Dostarczony tutaj ma eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93.
Gdzie kompilator nie interpretuje
Kompilator przekazuje etykietę klasy do grafu budowania jako ciąg znaków, wylicza trasy po krawędziach uses zadeklarowanych przez encję Aggregate i encje Releases, a następnie przekazuje jedno i drugie do polityki. Nie nadaje klasie rangi, nie wie, że managed oznacza, iż dane opuszczają klaster i trafiają do dostawcy, ani nie wie, że core/data-masking cokolwiek ukrywa. Każde z tych znaczeń należy do ustawień polityki i właśnie dzięki temu środowisko z innymi klasami, innymi etykietami i innymi encjami Features usuwającymi klasyfikację może uruchamiać ten sam mechanizm bez zmian. Gniazdo, do którego dołączona jest polityka — role, ładunek, poziomy ważności werdyktów — opisano w sekcji gniazdo polityki, a miejsce polityki w produkcie — w rozdziale Zarządzanie i zgodność.
Pliki
aggregate.yaml— dwaj asystenci, ich checkpointer, dwie bramy, model i para rozpoznawaczy; maskowanie dołączone domasking-gateway; gniazdomodelżadnego z asystentów niepowiązane.manifest.yaml— wiąże każdy typ komponentu i oba typy encji Feature z ich encjami Recipes dla Kubernetes, a asystenta roszczeń z encją Recipe bazowego agenta. Współdzielony przez trzy encje Releases.release-masked.yaml,release-unmasked.yaml,release-masking-off-route.yaml— trzy warianty trasowania oraz Secret, z którego odczytywany jest klucz każdej bramy.catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml— asystent roszczeń,core/ai-agent/langgraphz dodaną etykietą klasy.catalog/plugin/governance/opa/1.0.0/plugin.yaml— encja Plugin silnika OPA, z jego gościem,governance--opa.wasm, obok.policies/data-class-paths.rego,policies/data-class-paths.cel,policies/data-class-paths-opa.rego— reguła, raz dla każdego silnika.governance-rego.yaml,governance-cel.yaml,governance-opa.yaml— jeden plik--configna silnik, każdy dołączający regułę wir-verdictz tymi samymi ustawieniami..aggrega-config.yaml— stos wyszukiwania katalogów i rejestr; bez dołączenia polityki zarządzania.build-release.sh— buduje jedną encję Release, wypisując równoważne polecenieaggrega build.check.sh— buduje wszystkie dziewięć i sprawdza każdy wynik.