Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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

instancjaencja Component z kataloguczym jest tutaj
assistantlocal/ai-agent/claims-assistantasystent ds. roszczeń: agent LangGraph z biblioteki standardowej, zadeklarowany w katalogu tego obszaru roboczego z jedną dodaną etykietą — klasą danych, które obsługuje
helpdeskcore/ai-agent/langgraphasystent helpdesku, który nie ma żadnej klasy
checkpointercore/datastore/valkeymiejsce, w którym oba asystenty przechowują stan swoich przebiegów
masking-gatewaycore/gateway/litellmbramka AI obsługująca jeden alias, chat, z dołączonym core/data-masking
plain-gatewaycore/gateway/litellmta sama bramka bez żadnych dołączeń
gptcore/ai-model/openaizarządzane API OpenAI, osiągane jako odwołanie: nic nie działa dla niego w klastrze
analyzer, anonymizercore/security/presidio-analyzer, core/security/presidio-anonymizerusł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:

Releaseruch asystenta ds. roszczeńruch asystenta helpdeskubudowanie
release-masked.yamlprzez masking-gatewayprzez plain-gatewaykończy się powodzeniem
release-unmasked.yamlprzez plain-gatewayprzez plain-gatewayzostaje zatrzymane
release-masking-off-route.yamlprzez plain-gatewayprzez masking-gatewayzostaje 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:

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

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd policy-data-class-route

Kompilacja

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

Aby 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.yaml wymienia własny catalog/ 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 przez default_registry, czyli hub.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 violation

Silnik 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

Budowanie 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>/dist

Bramka 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 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]

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: 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]

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.yaml leży na trasie asystenta roszczeń, a kompilacja kończy się powodzeniem;
  • w release-unmasked.yaml nie leży na trasie żadnego asystenta, a kompilacja zostaje zatrzymana;
  • w release-masking-off-route.yaml leż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ędziami uses. W release-unmasked.yaml jedną z nich jest assistant → 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ą tylko assistant, z wartością restricted. W przeciwnym razie klasa pierwszego wpisu classes_by_label, którego etykietę i wartość ma komponent.
  • Dołączenia każdego komponentu, input.graph.spec.feature_values_mapping. Własna lista trasy attached_features celowo 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: public

Model 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-class
rank:
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 violation

Klasę 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

silnikdołączany przezreguła
silnik Rego wkompilowany w CLIgovernance-rego.yamlpolicies/data-class-paths.rego, wskazany w with.sources
silnik CEL wkompilowany w CLIgovernance-cel.yamlpolicies/data-class-paths.cel, wskazany w with.sources
OPA, za referencyjnym gościem adapteragovernance-opa.yamlpolicies/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.

Terminal window
./check.sh

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

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:

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 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:

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

a 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:

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

Wł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 do masking-gateway; gniazdo model ż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/langgraph z 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 --config na silnik, każdy dołączający regułę w ir-verdict z 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 polecenie aggrega build.
  • check.sh — buduje wszystkie dziewięć i sprawdza każdy wynik.