Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Політика, що зупиняє збирання, коли дані з обмеженим доступом досягають керованої моделі без маскування

Інфраструктура підприємства містить асистента зі страхових виплат, який обробляє дані клієнтів з обмеженим доступом, і асистента служби підтримки, який таких даних не обробляє. Обидва надсилають трафік моделі до керованого API OpenAI через AI-шлюз усередині кластера. Внутрішнє правило підприємства:

Дані одного класу не досягають компонента іншого класу маршрутом графа збирання, якщо на цьому маршруті не приєднано знекласифіковувальну Feature.

Цей робочий простір приєднує це правило як політику над графом збирання і збирає три Releases однієї сутності Aggregate. В одній із них запити асистента зі страхових виплат проходять через шлюз, який їх маскує, і збирання завершується. У двох інших вони через нього не проходять, і збирання зупиняється ще до того, як щось буде відрендерено, а політика називає обидва кінці маршруту.

Правило записано тричі, по одному разу для кожного рушія політик, на якому воно виконується, — рушіїв Rego і CEL, скомпільованих у CLI, та OPA, — і три копії дають однаковий результат на кожному збиранні тут. Скрипт поруч із Releases збирає всі дев’ять комбінацій і перевіряє кожен результат.

Що він збирає

екземплярComponent із каталогущо це тут
assistantlocal/ai-agent/claims-assistantасистент для обробки страхових вимог: агент LangGraph зі стандартної бібліотеки, оголошений у каталозі цього робочого простору з однією доданою міткою — класом даних, які він обробляє
helpdeskcore/ai-agent/langgraphасистент служби підтримки, який не має класу
checkpointercore/datastore/valkeyмісце, де обидва асистенти зберігають стан виконання
masking-gatewaycore/gateway/litellmшлюз ШІ, що обслуговує один псевдонім, chat, із приєднаним core/data-masking
plain-gatewaycore/gateway/litellmтой самий шлюз без жодних приєднань
gptcore/ai-model/openaiкерований API OpenAI, доступний як посилання: у кластері для нього нічого не запускається
analyzer, anonymizercore/security/presidio-analyzer, core/security/presidio-anonymizerсервіси розпізнавання, які викликає маскування

Обидва шлюзи під’єднано до gpt через їхній сокет models, і кожен передає ключ моделі в цьому з’єднанні. Приєднання маскування перелічує, що маскувати: шаблон для номерів страхових вимог організації та типи сутностей PERSON і EMAIL_ADDRESS. Обидва асистенти оголошують сокет model, який оголошує їхній Component і який допускає модель або шлюз, що обслуговує API моделі, і залишають його неприв’язаним: його під’єднує кожен Release.

Три Releases

Releases відрізняються лише тим, через який шлюз проходить трафік моделі кожного асистента:

Releaseтрафік асистента з претензійтрафік асистента служби підтримкизбирання
release-masked.yamlчерез masking-gatewayчерез plain-gatewayзавершується
release-unmasked.yamlчерез plain-gatewayчерез plain-gatewayзупиняється
release-masking-off-route.yamlчерез plain-gatewayчерез masking-gatewayзупиняється

Кожен Release прив’язує сокет model обох асистентів до шлюзу, який оголошує сутність Aggregate. Це з’єднання ребер у межах сокета, який оголошує сутність Component, і Release може це робити; воно не додає жодного компонента й не змінює жодного значення.

Створення прикладу

Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.

Запишіть приклад у нову теку, названу за ним:

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 цього робочого простору все одно накладається поверх нього. Тож для цього запуску ніщо з вашого власного глобального файлу не діє: ні інше підключення governance, ні default_registry, ні налаштування офлайн-режиму. Облікові дані, які ви зберегли за допомогою aggrega login, не є частиною цього файлу й далі діють. Файл робочого простору оголошує каталоги каталогу сутностей і не має власного підключення governance; список, який він оголосив би, замінив би список з зазначеного файлу, тож виконується саме підключення із зазначеного файлу.

Політика governance підключається через конфігурацію, а не через сутність Release, — у сутності Release немає для неї поля, — саме тому рушій обирають для кожного збирання, а не для кожної сутності Release.

Перед першим збиранням мають бути готові дві речі:

  • Каталог стандартної бібліотеки. .aggrega-config.yaml перелічує власний catalog/ цього робочого простору, що містить асистента зі страхових вимог і сутність Plugin рушія OPA. Усе інше, зокрема сутності Plugin рушіїв Rego і CEL, розв’язується з реєстру hub, описаного нижче, або з локальної копії каталогу, вказаної через --catalog.
  • Реєстр hub. Реалізація маскування даних записує свої обмеження через один плагін, що не постачається ні з компілятором, ні з каталогом, — крок конфігурації шлюзу pipeline-step/litellm-gateway-config, — і збирання завантажує його з реєстру, який задає default_registry, — hub.aggrega.ai.

--auto-pull заповнює lock-файл кожної сутності Release під час збирання; lock-файли та згенерований результат створюються автоматично й не постачаються.

З ШІ-асистентом

ШІ-асистент, налаштований з інструментами Aggrega, може зробити те саме: вставте йому цей промпт.

Використовуйте лише інструменти Aggrega і не створюйте жодної теки самостійно. Якщо тека Workspace ще не містить теки `policy-data-class-route`, викличте один раз інструмент `scaffold`, задавши для `example` значення `policy-data-class-route` і не задаючи `dir`: він запише приклад у нову теку `policy-data-class-route`. Потім викличте інструмент `cli-build`, який запускає `aggrega build` і приймає його прапорець `--config`, один раз для кожної сутності Release у такому порядку — `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`. Друга й третя збірки мають бути відхилені, тож прочитайте мені кожну відмову. Скажіть мені, які файли записала перша збірка; вони розташовані в `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. Його трафік до моделі досягає gpt, яку політика відносить до класу public, через plain-gateway, і ніщо на цьому маршруті — ні асистент, ні шлюз, ні модель — не несе сутності Feature, яку політика вважає такою, що знімає класифікацію. Два класи з різним рангом зустрічаються на одному маршруті, і між ними нічого немає, тож політика відмовляє у збиранні.

Підтягування також рендерить сутність Release, щоб знайти зовнішні вхідні дані, які потрібно закріпити, і натрапляє там на ту саму відмову; саме тому пропущені вище рядки містять це речення вдруге. 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]

Саме маскування міститься в конфігурації маскувального шлюзу, у ключі config.yaml файлу 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]

Конфігурація звичайного шлюзу взагалі не має записів guardrail.

Політика нічого не змінює в тому, що рендериться. Дерево release-masked кожного рушія побайтно ідентичне тій самій сутності Release, зібраній без приєднаної політики. Політику приєднано до ролі ir-verdict, ролі вердикту: вона повертає прийняття або відмову, а шлях, що передає вердикт, не має способу застосувати його як зміну, тож політика там може зупинити збірку, але не може переписати її так, щоб вона відповідала вимогам.

Політика перевіряє, що маскування приєднано на маршруті, а не те, що воно маскує. Приєднання, яке перелічує шаблон, що не збігається з нічиїми даними, задовольняє її так само, як і це. Те, що перелічує маскувальне приєднання, — власне судження середовища, винесене там, де це приєднання написано.

Чому сутності Releases змінюють маршрут, а не підключення

Сутність Release може підключити Feature, але підключення, записане в Release, не несе values, а core/data-masking зберігає те, що маскує, — patterns і entities — у values і зупиняє підключення, яке не перелічує жодного з них. Тому маскування підключено в Aggregate, на masking-gateway, і воно є в графі кожної з трьох збірок:

  • у release-masked.yaml воно стоїть на маршруті асистента зі страхових вимог, і збірка завершується;
  • у release-unmasked.yaml воно не стоїть на маршруті жодного асистента, і збірка зупиняється;
  • у release-masking-off-route.yaml воно стоїть на маршруті служби підтримки, і збірка знову зупиняється.

Друга й третя збірки несуть те саме підключення й відрізняються лише тим, на чиєму маршруті воно стоїть. Обидві зупиняються, отже політика читає маршрут, а не рахує підключення у збірці.

Що читає політика

Усе це надходить із графа збірки, який компілятор передає приєднанню ir-verdict, а все його значення — з налаштувань приєднання:

  • Маршрути, які перелічує компілятор, input.precalculated_paths: кожен — це впорядкований список компонентів, з’єднаних ребрами uses. У release-unmasked.yaml один із них — 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, приєднану будь-де на маршруті, тож не може сказати, чи стоїть вона між двома компонентами, про які йдеться.

Компонент без класу пропускається. Так само не враховуються напрямок, у якому накреслено маршрут, — з’єднання несе запит в один бік, а відповідь в інший, — і класи, яким налаштування надають однаковий ранг.

Клас моделі походить від її мітки розміщення. gpt не має мітки класу. Її сутність Component, core/ai-model/openai, має component.aggrega.ai/hosting: managed — твердження каталогу, що сервіс експлуатує його постачальник поза кластером, а налаштування зіставляють це з класом:

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

Керована модель зберігає все, що їй надсилають, і цей ландшафт вважає це публічним. Модель із власним розміщенням, як-от core/ai-model/vllm, і будь-який шлюз тут мають натомість self-hosted, а отже, жодного класу.

Маршрути обмежені. Компілятор перелічує обмежену кількість маршрутів від кожного початкового компонента і нічого понад цю межу, тож на графі з більшою кількістю маршрутів маршрут може залишитися непрочитаним, а збірка — пройти. Маршрут, який політика читає, справжній; відсутність маршруту не доводить, що його не існує. Див. ролі вердиктів.

Класи належать політиці, а не компілятору

Компілятор переносить compliance.aggrega.ai/data-class у граф збірки як рядок і не вкладає в нього жодного значення. Він не знає, що restricted чутливіший за public, чи що будь-яке з цих слів щось означає. Класи та їхнє ранжування — це налаштування політики, однакові в усіх трьох файлах рушіїв:

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

Середовище з власним словником підставляє власні значення: свої класи та їхній порядок у rank, мітку, у якій воно їх зберігає, у class_label, свої виведення в classes_by_label і Features, які воно визнає такими, що знімають класифікацію, у declassifying_features. Змінюйте всі три файли рушіїв однаково, адже різниця між ними — це різниця між вердиктами рушіїв. Клас, який має компонент, але якого немає в rank, зупиняє збірку, а не вважається відсутністю класу, тож про помилку в написанні буде повідомлено, а не пропущено її. Якщо мітку асистента з обробки страхових вимог записано як 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 цього робочого простору, а не сутність стандартної бібліотеки. Те, чи обробляє асистент дані з обмеженим доступом, — це твердження про те, як середовище його використовує, а не про LangGraph, тому local/ai-agent/claims-assistant розширює core/ai-agent/langgraph, успадковує його контракт і додає одну мітку. Сутність Aggregate не може поставити мітку на екземпляр компонента, тож клас завжди є властивістю сутності Component, якою оголошено екземпляр. Якщо асистента з обробки страхових вимог оголосити натомість як агента стандартної бібліотеки, жоден компонент не матиме мітки класу, і release-unmasked.yaml збирається з кожним рушієм, байт у байт так само, як без політики: модель і далі отримує клас public, але немає другого класу, з яким він міг би зустрітися.

Три рушії, правило написане тричі

рушійчим під’єднаноправило
рушій Rego, вкомпільований у CLIgovernance-rego.yamlpolicies/data-class-paths.rego, зазначений у with.sources
рушій CEL, вкомпільований у CLIgovernance-cel.yamlpolicies/data-class-paths.cel, зазначений у with.sources
OPA, за еталонним гостьовим адаптеромgovernance-opa.yamlpolicies/data-class-paths-opa.rego, вкомпільований у гостьовий модуль

Три копії — навмисний майже-дублікат. Кожну написано окремо за правилом, тож збірка, щодо якої рушії розходяться, показує цю розбіжність: сигналом є та сама збірка, що зупиняється під одним рушієм і завершується під іншим. Жодну не згенеровано з іншої, і їх не слід об’єднувати в одну спільну реалізацію, бо тоді рушії погоджувалися б за побудовою і приховували б саме ту різницю, яку це має виявляти. Кожен файл починається з цього застереження.

Вони відрізняються там, де відрізняються рушії:

  • Копія CEL не може прив’язати ім’я до значення чи пройти позиціями списку, тому її налаштування містять ще один запис, positions, — позиції від 0 до 15, на яких читаються компоненти маршруту. Довший маршрут зупиняє збірку із зазначенням, де він починається, замість того щоб бути прочитаним частково.
  • Копія OPA компілюється заздалегідь власним інструментарієм OPA і вбудовується в гостьовий модуль поруч із catalog/plugin/governance/opa/1.0.0/plugin.yaml, тож її під’єднання постачає налаштування, а не файл політики. Адаптер не надає жодної з вбудованих функцій, які OPA залишає своєму хосту, тому ця копія з’єднує свої повідомлення через concat, тоді як копія рушія Rego форматує їх через sprintf. Її редагування не змінює жодної збірки, доки гостьовий модуль не перебудовано, як описано нижче.

Під’єднання Rego і CEL називають сутності Plugin, які каталог стандартної бібліотеки містить для двох рушіїв, вкомпільованих у CLI, — governance/rego:0.9.0 і governance/cel:0.9.0, а працює той рушій, що вкомпільований у бінарний файл, який виконує збірку. Сутність Plugin для OPA в catalog/plugin/governance/ — власне оголошення цього робочого простору версії 1.0.0, тож її під’єднання називає governance/opa:1.0.0. Відмова має заголовок з останнього сегмента посилання під’єднання, без версії — policy plugin "rego", "cel" або "opa", — а кожна збірка під’єднує один рушій, тож відмова, яку вона виводить, називає цей рушій. Гостьовий модуль OPA читається з місця поруч із його сутністю під час кожної збірки, і оскільки його дайджест ніде не записано, кожна збірка з ним попереджає, що він працює неперевіреним.

Перевірка кожної збірки

Ця самоперевірка виконується в робочій копії репозиторію документації, яка містить потрібний їй спільний допоміжний скрипт збирання; копія, записана aggrega scaffold --example, цього скрипту не містить.

Terminal window
./check.sh

check.sh збирає три Releases під трьома рушіями через ./build-release.sh і перевіряє кожен результат на відповідність тому, що описує ця сторінка. Зупинка має завершитися з ненульовим кодом і E0005, повідомлення якої — речення вище, без жодної іншої відмови поруч; завершена збірка має вийти з кодом 0 і записати ті самі файли, байт у байт, що й той самий Release, зібраний без політики, який скрипт збирає першим як еталон. Кожен рушій перевіряється на те саме речення. Скрипт виводить по одному рядку на збірку і завершується з кодом 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 з набору для розробки плагінів, rust/examples/policy-opa-wasm у репозиторії aggrega-pdk, у якому замість власного модуля адаптера стоїть модуль, що його OPA компілює з policies/data-class-paths-opa.rego. Його зібрано з aggrega-pdk на коміті afd9ac6c6800c34c6c47a2030f580c9681387047 і aggrega-abi, crate 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, заданому абсолютним шляхом, де два репозиторії лежать поруч, а залежність адаптера за шляхом веде з одного в інший. Три відображення шляхів не пускають у гостьовий модуль каталог збірки, домашній каталог 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

Власні байти гостьового модуля залежать також від каталогу, у якому збиралися його crate, і від інструментарію, тож повторна збірка деінде дає рівноцінний гостьовий модуль з іншим sha256. Модуль, що постачається тут, має eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93.

Де компілятор не інтерпретує

Компілятор передає мітку класу до графа збирання як рядок, перелічує маршрути по ребрах uses, які оголосили сутність Aggregate і сутності Releases, і передає і те, і інше політиці. Він не ранжує клас, не знає, що managed означає, що дані залишають кластер і йдуть до постачальника, і не знає, що core/data-masking щось приховує. Кожне з цих значень визначається налаштуваннями політики, і саме це дає змогу середовищу з іншими класами, іншими мітками та іншими Features, що знімають класифікацію, запускати той самий механізм без змін. Про сокет, до якого приєднано політику, — ролі, корисне навантаження, рівні серйозності вердиктів — див. сокет політики, а про місце політики в продукті — Управління та відповідність вимогам.

Файли

  • aggregate.yaml — два асистенти, їхній checkpointer, два шлюзи, модель і пара розпізнавачів; маскування, приєднане до masking-gateway; сокет model жодного з асистентів не прив’язаний.
  • manifest.yaml — прив’язує кожен тип компонента й обидва типи Feature до їхніх Kubernetes Recipes, а асистента зі страхових вимог — до Recipe базового агента. Спільний для трьох сутностей Releases.
  • release-masked.yaml, release-unmasked.yaml, release-masking-off-route.yaml — три маршрутизації та 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 — сутність Plugin рушія OPA, поруч із якою лежить його гостьовий модуль governance--opa.wasm.
  • policies/data-class-paths.rego, policies/data-class-paths.cel, policies/data-class-paths-opa.rego — правило, по одному разу для кожного рушія.
  • governance-rego.yaml, governance-cel.yaml, governance-opa.yaml — по одному файлу --config на рушій, кожен приєднує правило в ir-verdict з однаковими налаштуваннями.
  • .aggrega-config.yaml — стек пошуку каталогів і реєстр; без приєднання політик керування.
  • build-release.sh — збирає одну сутність Release і виводить еквівалентну команду aggrega build.
  • check.sh — виконує всі дев’ять збирань і перевіряє кожен результат.