Политика, которая останавливает сборку, когда данные с ограниченным доступом попадают в управляемую модель без маскирования
В инфраструктуре работают ассистент по страховым претензиям, обрабатывающий клиентские данные с ограниченным доступом, и ассистент службы поддержки, который таких данных не обрабатывает. Оба отправляют запросы к модели в управляемый 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 | AI-шлюз, обслуживающий один псевдоним, 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— стек поиска каталогов и реестр; без подключения governance.build-release.sh— собирает одну сущность Release и выводит эквивалентную командуaggrega build.check.sh— собирает все девять вариантов и проверяет каждый результат.