Політика, що зупиняє збирання, коли дані з обмеженим доступом досягають керованої моделі без маскування
Інфраструктура підприємства містить асистента зі страхових виплат, який обробляє дані клієнтів з обмеженим доступом, і асистента служби підтримки, який таких даних не обробляє. Обидва надсилають трафік моделі до керованого API OpenAI через AI-шлюз усередині кластера. Внутрішнє правило підприємства:
Дані одного класу не досягають компонента іншого класу маршрутом графа збирання, якщо на цьому маршруті не приєднано знекласифіковувальну Feature.
Цей робочий простір приєднує це правило як політику над графом збирання і збирає три Releases однієї сутності Aggregate. В одній із них запити асистента зі страхових виплат проходять через шлюз, який їх маскує, і збирання завершується. У двох інших вони через нього не проходять, і збирання зупиняється ще до того, як щось буде відрендерено, а політика називає обидва кінці маршруту.
Правило записано тричі, по одному разу для кожного рушія політик, на якому воно виконується, — рушіїв Rego і CEL, скомпільованих у CLI, та OPA, — і три копії дають однаковий результат на кожному збиранні тут. Скрипт поруч із Releases збирає всі дев’ять комбінацій і перевіряє кожен результат.
Що він збирає
| екземпляр | Component із каталогу | що це тут |
|---|---|---|
assistant | local/ai-agent/claims-assistant | асистент для обробки страхових вимог: агент LangGraph зі стандартної бібліотеки, оголошений у каталозі цього робочого простору з однією доданою міткою — класом даних, які він обробляє |
helpdesk | core/ai-agent/langgraph | асистент служби підтримки, який не має класу |
checkpointer | core/datastore/valkey | місце, де обидва асистенти зберігають стан виконання |
masking-gateway | core/gateway/litellm | шлюз ШІ, що обслуговує один псевдонім, chat, із приєднаним core/data-masking |
plain-gateway | core/gateway/litellm | той самий шлюз без жодних приєднань |
gpt | core/ai-model/openai | керований API OpenAI, доступний як посилання: у кластері для нього нічого не запускається |
analyzer, anonymizer | core/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 може це робити; воно не додає жодного компонента й не змінює жодного значення.
Створення прикладу
Цей приклад можна зібрати командами нижче або доручити збирання вашому ШІ-асистенту.
Запишіть приклад у нову теку, названу за ним:
aggrega scaffold --example policy-data-class-routeПотім вона виводить команди, які слід виконати далі. Перша переходить у нову теку:
cd policy-data-class-routeЗбирання
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 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 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 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 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]Саме маскування міститься в конфігурації маскувального шлюзу, у ключі 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: 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]Конфігурація звичайного шлюзу взагалі не має записів 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-classrank: 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, вкомпільований у CLI | governance-rego.yaml | policies/data-class-paths.rego, зазначений у with.sources |
| рушій CEL, вкомпільований у CLI | governance-cel.yaml | policies/data-class-paths.cel, зазначений у with.sources |
| OPA, за еталонним гостьовим адаптером | governance-opa.yaml | policies/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, цього скрипту не містить.
./check.shcheck.sh збирає три Releases під трьома рушіями через
./build-release.sh і перевіряє кожен результат на відповідність тому, що описує ця сторінка. Зупинка має завершитися з ненульовим кодом і E0005, повідомлення якої — речення вище, без жодної іншої відмови поруч; завершена збірка має вийти з кодом 0 і записати ті самі файли, байт у байт, що й той самий Release, зібраний без політики, який скрипт збирає першим як еталон. Кожен рушій перевіряється на те саме речення. Скрипт виводить
по одному рядку на збірку і завершується з кодом 1, якщо будь-який результат відрізняється, виводячи результат цієї збірки:
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.Йому потрібне те саме, що й окремій збірці: каталог стандартної бібліотеки і реєстр 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.
Спочатку модуль, з цього каталогу. Якщо назвати правило за шляхом відносно цього каталогу, у модулі залишиться саме цей шлях і нічого від машини:
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 компілює ті самі байти з того самого вихідного коду, хоч би в якому каталозі лежав цей робочий простір.
Потім гостьовий модуль, у тимчасовому каталозі $BUILD, заданому абсолютним шляхом,
де два репозиторії лежать поруч, а залежність адаптера за шляхом веде
з одного в інший. Три відображення шляхів не пускають у гостьовий модуль каталог збірки, домашній каталог cargo
і власні вихідні коди інструментарію:
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 без змін. Власний скрипт збірки адаптера також запускає необов’язковий прохід зменшення розміру, який тут пропущено: він переписує дані гостьового модуля, а без нього модуль залишається в гостьовому модулі байт у байт. Це дає змогу перевірити вміст гостьового модуля на відповідність тому, на що компілюється правило:
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— виконує всі дев’ять збирань і перевіряє кожен результат.