Một policy dừng bản build khi dữ liệu bị hạn chế đến được một mô hình được quản lý mà không bị che
Một hệ thống vận hành một trợ lý xử lý yêu cầu bồi thường, xử lý dữ liệu khách hàng bị hạn chế, và một trợ lý helpdesk không xử lý loại dữ liệu nào như vậy. Cả hai gửi lưu lượng mô hình của mình đến API được quản lý của OpenAI thông qua một AI gateway trong cluster. Quy tắc nội bộ của hệ thống:
Dữ liệu thuộc một lớp không được đến một component thuộc lớp khác dọc theo một tuyến của đồ thị build, trừ khi một Feature giải phân loại được gắn trên tuyến đó.
Workspace này gắn quy tắc đó dưới dạng một policy trên đồ thị build và build ba Releases của một Aggregate. Trong một bản, các yêu cầu của trợ lý bồi thường đi qua một gateway che chúng, và bản build hoàn tất. Trong hai bản còn lại, chúng không đi qua, và bản build dừng trước khi bất cứ thứ gì được render, với policy nêu tên cả hai đầu của tuyến.
Quy tắc được viết ba lần, mỗi lần cho một policy engine mà nó chạy trên đó — các engine Rego và CEL được biên dịch vào CLI, và OPA — và ba bản sao cho kết quả giống nhau trên mọi bản build ở đây. Một script nằm cạnh các Releases build cả chín tổ hợp và kiểm tra từng kết quả.
Những gì ví dụ này xây dựng
| instance | Component trong catalog | vai trò ở đây |
|---|---|---|
assistant | local/ai-agent/claims-assistant | trợ lý xử lý yêu cầu bồi thường: agent LangGraph của thư viện chuẩn, được khai báo trong catalog của workspace này với một nhãn được thêm vào — lớp của dữ liệu mà nó xử lý |
helpdesk | core/ai-agent/langgraph | trợ lý helpdesk, không mang lớp nào |
checkpointer | core/datastore/valkey | nơi cả hai trợ lý lưu trạng thái chạy của chúng |
masking-gateway | core/gateway/litellm | một AI gateway phục vụ một alias, chat, với core/data-masking được gắn vào |
plain-gateway | core/gateway/litellm | cùng gateway đó nhưng không gắn gì |
gpt | core/ai-model/openai | API được quản lý của OpenAI, được truy cập dưới dạng tham chiếu: không có gì chạy cho nó trong cluster |
analyzer, anonymizer | core/security/presidio-analyzer, core/security/presidio-anonymizer | các dịch vụ nhận dạng mà việc che dữ liệu gọi tới |
Cả hai gateway được nối tới gpt qua socket models của chúng, mỗi gateway xuất trình khóa của model trên kết nối đó. Phần gắn che dữ liệu liệt kê những gì cần che: một mẫu cho số yêu cầu bồi thường của tổ chức, và các loại thực thể PERSON và
EMAIL_ADDRESS. Hai trợ lý khai báo socket model mà Component của chúng
khai báo, socket này chấp nhận một model hoặc một gateway phục vụ API của model, và để nó
chưa được liên kết: mỗi Release sẽ nối nó.
Ba Releases
Các Releases chỉ khác nhau ở chỗ lưu lượng mô hình của mỗi trợ lý đi qua gateway nào:
| Release | lưu lượng của trợ lý xử lý yêu cầu bồi thường | lưu lượng của trợ lý helpdesk | bản build |
|---|---|---|---|
release-masked.yaml | qua masking-gateway | qua plain-gateway | hoàn tất |
release-unmasked.yaml | qua plain-gateway | qua plain-gateway | dừng lại |
release-masking-off-route.yaml | qua plain-gateway | qua masking-gateway | dừng lại |
Mỗi Release gắn socket model của hai trợ lý vào một gateway mà
Aggregate khai báo. Đó là việc nối cạnh bên trong một socket mà Component khai báo,
điều một Release được phép làm; nó không thêm component nào và không thay đổi giá trị nào.
Tạo ví dụ
Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.
Ghi ví dụ vào một thư mục mới đặt theo tên của nó:
aggrega scaffold --example policy-data-class-routeSau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:
cd policy-data-class-routeBuild
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 1Thay governance-rego.yaml bằng governance-cel.yaml hoặc governance-opa.yaml để
chạy cùng một quy tắc trên một engine khác.
--config chỉ định tệp cấu hình toàn cục cho lần chạy đó. Tệp này được đọc
thay cho tệp mà máy lẽ ra sẽ đọc — tệp mà AGGREGA_CONFIG
chỉ định, hoặc vị trí mặc định — và .aggrega-config.yaml của chính workspace này
vẫn được xếp lớp lên trên nó. Vì vậy trong lần chạy đó, không có gì bạn giữ trong tệp
toàn cục của mình được áp dụng: một governance attachment khác, một default_registry, một thiết lập
ngoại tuyến. Thông tin xác thực bạn đã lưu bằng aggrega login không thuộc tệp đó
và vẫn được áp dụng. Tệp workspace khai báo các thư mục catalog và không có
governance attachment riêng; một danh sách mà nó khai báo sẽ thay thế danh sách mà
tệp được chỉ định mang theo, nên attachment trong tệp được chỉ định là attachment được chạy.
Một chính sách governance được gắn qua cấu hình, không qua một Release — một Release không có trường nào cho nó — đó là lý do engine được chọn theo từng bản build thay vì theo từng Release.
Hai thứ cần có sẵn trước bản build đầu tiên:
- Catalog thư viện chuẩn.
.aggrega-config.yamlliệt kêcatalog/của chính workspace này, nơi chứa trợ lý claims và thực thể Plugin của engine OPA. Mọi thứ còn lại, bao gồm cả các thực thể Plugin của engine Rego và CEL, được phân giải từ registry hub nêu dưới đây, hoặc từ một bản checkout của catalog được chỉ định bằng--catalog. - Registry của hub. Phần hiện thực hóa che dữ liệu ghi các guardrail của nó thông qua một plugin không đi kèm trong compiler lẫn catalog, đó là bước cấu hình gateway
pipeline-step/litellm-gateway-config, và bản build kéo nó từ registry màdefault_registrychỉ định,hub.aggrega.ai.
--auto-pull điền lockfile của mỗi Release trong quá trình build; các lockfile và
đầu ra được render đều được sinh ra, không được phát hành kèm.
Với trợ lý AI
Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.
Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục Workspace chưa có thư mục `policy-data-class-route`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `policy-data-class-route` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `policy-data-class-route` mới. Sau đó gọi công cụ `cli-build`, công cụ chạy `aggrega build` và nhận cờ `--config` của lệnh đó, một lần cho mỗi Release, theo thứ tự này — `release-masked.yaml`, `release-unmasked.yaml` và `release-masking-off-route.yaml` — mỗi lần với `workspace_root` đặt thành `policy-data-class-route`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `config` đặt thành `governance-rego.yaml`. Bản dựng thứ hai và thứ ba được dự định là sẽ bị từ chối, vì vậy hãy đọc cho tôi từng lời từ chối. Cho tôi biết bản dựng đầu tiên đã ghi những tệp nào; chúng nằm trong `policy-data-class-route/dist/`.Sự dừng lại
release-unmasked.yaml, dưới mỗi engine. Engine 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 violationEngine 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 violationBản build thoát với mã 1 và không ghi dist/: policy được đánh giá trên
đồ thị build trước khi bất cứ thứ gì được render. E0005 là chẩn đoán mà một lần policy
từ chối mang theo — xem tài liệu tham khảo chẩn đoán.
release-masking-off-route.yaml in ra cùng lời từ chối đó, dưới mỗi engine.
Hãy đọc câu này như tuyến đường mà policy đã tìm thấy. assistant chứa dữ liệu restricted. Lưu lượng
mô hình của nó đến gpt, mà policy xếp vào lớp public, thông qua
plain-gateway, và không có gì trên tuyến đường đó — không phải assistant, không phải gateway,
không phải mô hình — mang một Feature mà policy coi là giải phân loại. Hai lớp
có thứ hạng khác nhau gặp nhau trên một tuyến đường mà không có gì ở giữa, vì vậy policy
từ chối bản build.
Thao tác pull cũng render Release, để tìm mọi đầu vào bên ngoài cần được ghim, và gặp cùng lời từ chối ở đó; đó là lý do các dòng bị lược bỏ ở trên mang câu này lần thứ hai. Lockfile vẫn được ghi.
Đáp ứng chính sách: gateway che dữ liệu trên tuyến
release-masked.yaml định tuyến trợ lý xử lý yêu cầu bồi thường qua masking-gateway, và
mọi engine đều cho phép build, với <workspace> đại diện cho thư mục của ví dụ này:
[… 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>/distGateway che dữ liệu giờ nằm trên tuyến duy nhất từ trợ lý xử lý yêu cầu bồi thường đến mô hình,
và chính sách đọc thấy nó ở đó: trên tuyến đó, một component mang một attachment
có kiểu được thiết lập declassifying_features của chính sách liệt kê, tại hoặc trước
điểm mà các lớp khác nhau. Tuyến này đọc được từ đầu ra đã render:
dist/helm/assistant-deployment.yaml gửi trợ lý xử lý yêu cầu bồi thường đến gateway che
dữ liệu, và dist/helm/helpdesk-deployment.yaml gửi helpdesk đến gateway
thông thường.
# 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]Bản thân việc che dữ liệu nằm trong cấu hình của gateway che dữ liệu, tức khóa config.yaml
của 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]Cấu hình của gateway thông thường hoàn toàn không có mục guardrail nào.
Chính sách không thay đổi gì trong những gì được render. Cây release-masked
của mỗi engine giống hệt từng byte với cùng Release đó khi build mà không gắn chính sách nào. Chính
sách được gắn ở vai trò ir-verdict, một vai trò phán quyết: nó trả về chấp nhận
hoặc từ chối, và đường xử lý phát phán quyết không có cách nào áp dụng phán quyết như
một thay đổi, nên một chính sách ở đó có thể dừng một bản build nhưng không thể viết lại nó cho
tuân thủ.
Chính sách kiểm tra rằng việc che dữ liệu được gắn trên tuyến, chứ không kiểm tra nó che những gì. Một attachment liệt kê một mẫu không khớp với dữ liệu của ai cũng đáp ứng chính sách ngang với attachment này. Những gì một attachment che dữ liệu liệt kê là phán đoán riêng của hệ thống, được đưa ra tại nơi attachment được viết.
Vì sao các Releases di chuyển tuyến chứ không di chuyển phần gắn kèm
Một Release có thể gắn một Feature, nhưng phần gắn kèm được viết trong một Release không mang
values, còn core/data-masking giữ những gì nó che — patterns và entities
— trong values, và dừng một phần gắn kèm không liệt kê thứ nào trong hai thứ đó. Vì vậy việc che dữ liệu được
gắn trong Aggregate, trên masking-gateway, và nó nằm trong đồ thị của cả
ba bản build:
- trong
release-masked.yaml, nó nằm trên tuyến của trợ lý xử lý yêu cầu bồi thường, và bản build hoàn tất; - trong
release-unmasked.yaml, nó không nằm trên tuyến của trợ lý nào, và bản build bị dừng; - trong
release-masking-off-route.yaml, nó nằm trên tuyến của helpdesk, và bản build lại bị dừng.
Bản build thứ hai và thứ ba mang cùng một phần gắn kèm và chỉ khác nhau ở chỗ nó nằm trên tuyến của ai. Cả hai đều bị dừng, nên policy đang đọc tuyến, chứ không đếm các phần gắn kèm trong bản build.
Những gì policy đọc
Tất cả đều đến từ đồ thị build mà trình biên dịch trao cho một attachment ir-verdict,
và toàn bộ ý nghĩa của chúng đến từ các thiết lập của attachment đó:
- Các tuyến mà trình biên dịch liệt kê,
input.precalculated_paths: mỗi tuyến là một danh sách có thứ tự các component nối với nhau bằng các cạnhuses. Trênrelease-unmasked.yamlmột trong số đó làassistant → plain-gateway → gpt. Policy đọc mỗi tuyến từ component đầu tiên của nó, như vậy là đủ vì trình biên dịch liệt kê các tuyến rời khỏi mọi component. Bản thân policy không liệt kê gì. - Lớp của mỗi component. Giá trị của nhãn mà
class_labelchỉ định,compliance.aggrega.ai/data-class, ở nơi một component mang nhãn đó: chỉassistantmang, vớirestricted. Nếu không, đó là lớp của mụcclasses_by_labelđầu tiên có nhãn và giá trị mà component mang. - Các attachment của mỗi component,
input.graph.spec.feature_values_mapping. Danh sáchattached_featurescủa chính tuyến được cố ý không đọc: nó liệt kê mọi Feature được gắn ở bất kỳ đâu trên tuyến, nên nó không thể cho biết liệu một Feature có nằm giữa hai component đang xét hay không.
Một component không có lớp sẽ được bỏ qua. Cũng vậy với hướng vẽ một tuyến — một kết nối mang yêu cầu theo một chiều và phản hồi theo chiều kia — và các lớp mà thiết lập xếp hạng ngang nhau.
Lớp của mô hình đến từ nhãn hosting của nó. gpt không mang nhãn lớp nào.
Component của nó, core/ai-model/openai, mang component.aggrega.ai/hosting: managed, tức là tuyên bố của catalog rằng dịch vụ được nhà cung cấp vận hành,
bên ngoài cluster, và các thiết lập ánh xạ điều đó thành một lớp:
classes_by_label: - label: component.aggrega.ai/hosting value: managed class: publicMột mô hình được quản lý giữ bất cứ thứ gì được gửi đến nó, điều mà hệ thống này coi là công khai.
Một mô hình tự host như core/ai-model/vllm, và cả hai gateway ở đây, mang
self-hosted thay vào đó, và do đó không có lớp.
Các tuyến có giới hạn. Trình biên dịch liệt kê một số lượng tuyến có giới hạn từ mỗi component khởi đầu và không liệt kê gì vượt quá giới hạn đó, nên trên một đồ thị có nhiều tuyến hơn thế, một tuyến có thể không được đọc và build vẫn qua. Một tuyến mà policy đọc là có thật; việc không có một tuyến không phải là bằng chứng rằng nó không tồn tại. Xem các vai trò verdict.
Các lớp là của policy, không phải của trình biên dịch
Trình biên dịch mang compliance.aggrega.ai/data-class vào đồ thị build dưới dạng
một chuỗi và không gán ý nghĩa nào cho nó. Nó không biết rằng restricted nhạy cảm
hơn public, hay rằng từ nào trong hai từ đó có ý nghĩa gì. Các lớp và thứ hạng của
chúng là thiết lập của policy, giống nhau trong cả ba tệp engine:
class_label: compliance.aggrega.ai/data-classrank: public: 0 internal: 1 restricted: 2Một hệ thống có bộ từ vựng riêng sẽ thay bằng bộ của mình: các lớp và thứ tự của
chúng dưới rank, nhãn dùng để giữ chúng dưới class_label, các cách suy ra
dưới classes_by_label, và các Features mà nó chấp nhận là giải phân loại
dưới declassifying_features. Hãy thay đổi cả ba tệp engine như nhau, vì một
khác biệt giữa chúng là một khác biệt giữa các phán quyết của các engine. Một lớp mà
một component mang nhưng rank không liệt kê sẽ dừng build thay vì được hiểu
là không có lớp, nên một lỗi chính tả được báo cáo thay vì lọt qua. Khi nhãn của
trợ lý xử lý yêu cầu bồi thường được viết là Restricted, mọi engine đều từ chối release-masked.yaml;
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull in ra lời từ chối dưới đây, và tệp của mỗi engine khác in ra
cùng lời từ chối đó, mở đầu bằng tên của engine đó:
[… 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 violationLớp được mang bởi Component riêng của workspace này, không phải bởi Component của thư viện
chuẩn. Việc một trợ lý có xử lý dữ liệu hạn chế hay không là một nhận định về cách
một hệ thống sử dụng nó, không phải về LangGraph, nên local/ai-agent/claims-assistant
mở rộng core/ai-agent/langgraph, kế thừa hợp đồng của nó, và thêm một nhãn duy nhất.
Một Aggregate không thể gắn nhãn lên một instance component, nên một lớp luôn là một
thuộc tính của Component mà instance được khai báo theo. Nếu trợ lý xử lý yêu cầu bồi thường
được khai báo là agent của thư viện chuẩn, không component nào mang nhãn lớp,
và release-unmasked.yaml build được dưới mọi engine, giống từng byte với kết quả
build khi không có policy: mô hình vẫn suy ra public, nhưng không có
lớp thứ hai nào để nó gặp.
Ba engine, quy tắc được viết ba lần
| engine | được gắn bằng | quy tắc |
|---|---|---|
| engine Rego được biên dịch sẵn trong CLI | governance-rego.yaml | policies/data-class-paths.rego, được khai báo dưới with.sources |
| engine CEL được biên dịch sẵn trong CLI | governance-cel.yaml | policies/data-class-paths.cel, được khai báo dưới with.sources |
| OPA, phía sau guest adapter tham chiếu | governance-opa.yaml | policies/data-class-paths-opa.rego, được biên dịch vào guest |
Ba bản sao là một sự gần trùng lặp có chủ ý. Mỗi bản được viết riêng từ quy tắc, nên một bản build mà các engine không thống nhất sẽ cho thấy sự bất đồng đó: cùng một bản build bị dừng dưới một engine và hoàn tất dưới engine khác chính là tín hiệu. Không bản nào được sinh ra từ bản khác, và không nên gộp chúng thành một hiện thực dùng chung, vì điều đó sẽ khiến các engine đồng ý theo cấu trúc và che giấu chính sự khác biệt mà cơ chế này tồn tại để phát hiện. Mỗi tệp đều mở đầu bằng việc nói rõ điều này.
Chúng khác nhau ở những chỗ các engine khác nhau:
- Bản sao CEL không thể gán một tên cho một giá trị hay duyệt qua các vị trí của một danh sách, nên
phần thiết lập của nó có thêm một mục,
positions, là các vị trí từ 0 đến 15 mà tại đó các component của một route được đọc. Một route dài hơn thế sẽ dừng bản build, nêu rõ nơi nó bắt đầu, thay vì chỉ được đọc một phần. - Bản sao OPA được biên dịch trước bằng bộ công cụ riêng của OPA và đóng gói
vào guest bên cạnh
catalog/plugin/governance/opa/1.0.0/plugin.yaml, nên phần gắn kết của nó cung cấp thiết lập mà không có tệp policy nào. Adapter không cung cấp builtin nào trong số những builtin mà OPA để lại cho host, nên bản sao này nối các thông điệp bằngconcatở chỗ bản sao của engine Rego định dạng chúng bằngsprintf. Việc chỉnh sửa nó không thay đổi bản build nào cho đến khi guest được build lại, như bên dưới.
Các phần gắn kết Rego và CEL nêu tên các thực thể Plugin mà catalog thư viện chuẩn chứa cho hai engine được biên dịch vào CLI, governance/rego:0.9.0 và governance/cel:0.9.0, và engine chạy là engine được biên dịch vào binary đang chạy bản build. Thực thể Plugin của OPA, trong catalog/plugin/governance/, là khai báo riêng của workspace này ở phiên bản 1.0.0, nên phần gắn kết của nó nêu governance/opa:1.0.0. Một lời từ chối được mở đầu bằng phân đoạn cuối của tham chiếu của phần gắn kết, bỏ phần phiên bản — policy plugin "rego", "cel" hoặc "opa" — và mỗi bản build gắn một engine, nên lời từ chối mà nó in ra nêu tên engine đó. Guest OPA được đọc từ bên cạnh thực thể của nó ở mọi bản build, và vì không có gì ghi lại digest của nó, mọi bản build dùng nó đều cảnh báo rằng nó chạy mà không được xác minh.
Kiểm tra mọi bản build
Bước tự kiểm tra này chạy trong một bản checkout của kho tài liệu, nơi chứa script trợ giúp build dùng chung mà nó sử dụng; một bản sao do aggrega scaffold --example ghi ra không có script trợ giúp đó.
./check.shcheck.sh build ba Releases dưới ba engine thông qua
./build-release.sh, và đối chiếu từng kết quả với kết quả mà trang này
mô tả. Một lần dừng phải thoát với mã khác 0 cùng E0005 có thông điệp là câu
ở trên, và không có lần từ chối nào khác bên cạnh nó; một bản build hoàn tất phải thoát với mã 0 và ghi
ra đúng những tệp, giống hệt từng byte, như cùng Release đó khi build không có policy, bản mà nó
build trước tiên để làm tham chiếu. Mọi engine đều được đối chiếu với cùng một câu. Nó in ra
một dòng cho mỗi bản build và thoát với mã 1 nếu có kết quả nào khác biệt, đồng thời in
đầu ra của bản build đó:
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.Nó cần những gì một bản build đơn lẻ cần: catalog thư viện chuẩn và registry của hub. Nó dùng binary mà ./build-release.sh phân giải, nên AGGREGA_BIN chọn binary đó; các đối số sau -- được chuyển tới mọi bản build, nên ./check.sh -- --offline chạy nó mà không cần mạng khi mọi thứ nó tải về đã được lưu cache. Nó từ chối khởi chạy khi có một dist/ nằm trong thư mục này, vì nó so sánh các cây thư mục mà các bản build ghi ra, và nó không để lại cây nào. Trạng thái thoát của nó là toàn bộ kết luận, nên một pipeline có thể chạy nó thay cho việc build riêng từng Release.
Build lại guest OPA
catalog/plugin/governance/opa/1.0.0/governance--opa.wasm là guest adapter OPA tham chiếu từ bộ công cụ plugin, rust/examples/policy-opa-wasm trong kho aggrega-pdk, với module mà OPA biên dịch từ policies/data-class-paths-opa.rego thay cho module riêng của adapter. Nó được build từ aggrega-pdk tại afd9ac6c6800c34c6c47a2030f580c9681387047 và aggrega-abi, crate ABI mà adapter build dựa vào, tại 2ececa8d3b598243f023a2a6c80b351c8d1411a1, với rustc 1.97.1, bao quanh module mà OPA 1.21.1 biên dịch.
Đầu tiên là module, từ thư mục này. Gọi tên quy tắc bằng đường dẫn tương đối so với đây giúp giữ đường dẫn đó, và không có gì của máy, trong module:
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 biên dịch ra cùng các byte từ cùng mã nguồn, bất kể workspace này nằm ở thư mục nào.
Sau đó là guest, trong một thư mục tạm $BUILD, được cho dưới dạng đường dẫn tuyệt đối, chứa hai kho đặt cạnh nhau, với phụ thuộc đường dẫn của adapter nối từ kho này sang kho kia. Ba ánh xạ đường dẫn giữ thư mục build, thư mục home của cargo và mã nguồn riêng của toolchain nằm ngoài guest:
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-wasip1rồi sao chép $BUILD/target/wasm32-wasip1/release/policy_opa_wasm_rust.wasm sang catalog/plugin/governance/opa/1.0.0/governance--opa.wasm.
Guest là đầu ra của bản build cargo, giữ nguyên như khi tạo ra. Script build riêng của adapter còn chạy một bước giảm kích thước tùy chọn, bước này được bỏ qua ở đây: nó viết lại dữ liệu của guest, và khi không có nó, module được giữ nguyên từng byte trong guest. Điều đó cho phép bạn đối chiếu những gì một guest mang theo với những gì quy tắc biên dịch ra:
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# TrueCác byte riêng của guest còn phụ thuộc vào thư mục nơi các crate của nó được build, và vào toolchain, nên một lần build lại ở nơi khác là một guest tương đương với sha256 khác. Guest được cung cấp ở đây là eb53965efd7e812ecc933c7b681936c87aa0d242b28628a957f44a6a8072ec93.
Nơi trình biên dịch không diễn giải
Trình biên dịch định tuyến nhãn lớp tới đồ thị build dưới dạng một chuỗi, liệt kê các tuyến qua các cạnh uses mà Aggregate và các Releases đã khai báo, rồi chuyển cả hai cho chính sách. Nó không xếp hạng một lớp, không biết rằng managed có nghĩa là dữ liệu rời khỏi cụm để tới một nhà cung cấp, và không biết rằng core/data-masking che giấu bất cứ thứ gì. Mỗi ý nghĩa trong số đó đều là thiết lập của chính sách, và chính điều này cho phép một hệ thống với các lớp khác, các nhãn khác và các Features giải mật khác chạy cùng một cơ chế mà không cần thay đổi. Về socket mà chính sách được gắn vào — các vai trò, payload, các mức độ nghiêm trọng của phán quyết — xem socket chính sách, và về vị trí của chính sách trong sản phẩm, xem Quản trị và Tuân thủ.
Các tệp
aggregate.yaml— hai trợ lý, checkpointer của chúng, hai gateway, mô hình và cặp recognizer; phần che dữ liệu được gắn vàomasking-gateway; socketmodelcủa cả hai trợ lý đều không được liên kết.manifest.yaml— liên kết mọi loại component và cả hai loại Feature với các Recipes Kubernetes của chúng, trợ lý claims với Recipe của agent cơ sở. Được dùng chung bởi ba Releases.release-masked.yaml,release-unmasked.yaml,release-masking-off-route.yaml— ba cách định tuyến, và Secret mà khóa của mỗi gateway được đọc từ đó.catalog/component/local/ai-agent/claims-assistant/1.0.0/component.yaml— trợ lý claims,core/ai-agent/langgraphvới nhãn lớp được thêm vào.catalog/plugin/governance/opa/1.0.0/plugin.yaml— thực thể Plugin của engine OPA, với guest của nó,governance--opa.wasm, nằm bên cạnh.policies/data-class-paths.rego,policies/data-class-paths.cel,policies/data-class-paths-opa.rego— quy tắc, mỗi engine một lần.governance-rego.yaml,governance-cel.yaml,governance-opa.yaml— mỗi engine một tệp--config, mỗi tệp gắn quy tắc tạiir-verdictvới cùng các thiết lập..aggrega-config.yaml— ngăn xếp tìm kiếm catalog và registry; không có phần gắn governance.build-release.sh— build một Release, in ra lệnhaggrega buildtương đương.check.sh— build cả chín bản và kiểm tra từng kết quả.