Thông tin xác thực trên các kết nối — một khóa cho mỗi kết nối, và một khóa ở cả hai đầu
Một kho bộ nhớ ngữ nghĩa kết nối tới hai mô hình và xuất trình một khóa khác nhau cho mỗi mô hình, được biên dịch thành các manifest Kubernetes. Kho này đọc tài liệu đã nạp bằng một mô hình được lưu trữ (hosted) và mã hóa tài liệu đó bằng một máy chủ embedding chạy cạnh nó trong cluster. Khóa mà kho xuất trình cho mô hình được lưu trữ được lấy từ một kho bí mật của cluster. Máy chủ embedding kiểm tra một khóa của riêng nó, và kho xuất trình đúng khóa đó — cả hai đầu đều đọc khóa từ một tham số duy nhất, nên hai đầu không thể bị viết lệch nhau.
Workspace này không tự định nghĩa thực thể catalog nào. Mọi Component, Feature và Recipe mà nó nhắc tới đều có sẵn trong catalog của thư viện chuẩn; các tệp ở đây — ba Aggregates, một Manifest và ba Releases — là toàn bộ những gì cần viết.
Những gì ví dụ này xây dựng
┌── extraction_model ──► llm a hosted model API │ key on the connection, fetched from a secret store memory ───┤ │ └── embedding_model ──► embeddings an embedding server that checks a key key on the connection ═══ the server's own api_key (both read one parameter)| instance | Component trong catalog | vai trò ở đây |
|---|---|---|
memory | core/datastore/cognee | bên gọi: một kho bộ nhớ ngữ nghĩa có hai socket mô hình, mỗi socket khai báo một slot credential cho khóa mà nó xuất trình trên kết nối đó |
llm | core/ai-model/openai | một mô hình được lưu trữ, gắn nhãn component.aggrega.ai/hosting: managed; được truy cập dưới dạng tham chiếu, nên không có gì chạy cho nó trong cluster |
embeddings | core/ai-model/tei | Text Embeddings Inference trong cluster, gắn nhãn self-hosted; nó yêu cầu một khóa từ mọi bên gọi và giữ khóa đó trong slot api_key của riêng nó |
Ba release dùng chung một Manifest, manifest.yaml, và mỗi release có một Aggregate riêng:
| release | Aggregate | điều nó minh họa |
|---|---|---|
release-matched.yaml | aggregate-matched.yaml | cả hai kết nối do nhà phát triển viết, hai đầu của kết nối embedding đọc cùng một tham số |
release-mismatched.yaml | aggregate-mismatched.yaml | giống như trên nhưng hai đầu đọc hai tham số: bản build thành công, và bước kiểm tra quy ước đưa ra khuyến nghị |
release-operator-wired.yaml | aggregate-operator-wired.yaml | kết nối trích xuất được để lại cho người vận hành: Release nối kết nối đó và đặt tên khóa của nó trong infra |
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 connection-credentialsSau đó 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 connection-credentialsBuild
Mỗi lần chạy, build một release:
aggrega build --release release-matched.yaml --auto-pull # → dist/matched/aggrega build --release release-mismatched.yaml --auto-pull # → dist/mismatched/aggrega build --release release-operator-wired.yaml --auto-pull # → dist/operator-wired/Mỗi release ghi vào thư mục riêng của nó, nên ba cây thư mục được kết xuất cùng tồn tại và có thể so sánh khác biệt với nhau.
Một release cần có lockfile trước khi xây dựng, và lockfile được tạo ra chứ không được phân phối sẵn. Hãy phân giải một lockfile trước, hoặc để bước build tự điền nó:
aggrega pull --release release-matched.yaml # resolve, then build normallyaggrega build --release release-matched.yaml --auto-pull # or resolve during the buildWorkspace phân giải các entity của nó từ registry mặc định mà .aggrega-config.yaml chỉ định, nên không cần cờ --catalog.
Lệnh pull in ra:
[… omitted: a warning that the declared-sensitive origin of llm.credential reaches the target with no per-key sensitivity marking, because its realization maps it through a valuesMapping]Pull complete: release-matched.lock (entities=15, source_artifacts=0, external_inputs=0)và lệnh build, với <workspace> đại diện cho thư mục của ví dụ này:
[… omitted: the same warning about llm.credential the pull printed] notice: LINT: Feature "core/referenced-secret" at core/referenced-secret:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)[… omitted: a total build time, which differs per run]Build completed: 8 files written to <workspace>/distHai release còn lại in ra các dòng tương tự, mỗi lệnh pull nêu tên lockfile riêng của nó và mỗi lệnh build ghi tám tệp. Dòng notice: nói về credential Feature mà mọi attachment ở đây sử dụng: core/referenced-secret chấp nhận tên secret của nó, origin, từ values của developer hoặc từ infra của operator, và thông báo tư vấn này cho biết một leaf được khai báo ở cả hai trụ cột. Nó không thay đổi phán quyết nào và không thay đổi byte nào được kết xuất; Credential Features giải thích vì sao leaf này nằm ở cả hai.
Ở những chỗ trang này in ra kết quả của một lần build, khối đó được sao chép từ một lần chạy thực tế — xem Đọc kết quả đầu ra trên các trang này để biết quy ước và ký hiệu dùng cho các dòng bị lược bỏ.
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ỉ sử 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 không gian làm việc chưa chứa thư mục `connection-credentials`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `connection-credentials` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `connection-credentials` mới. Sau đó gọi công cụ `build` một lần cho mỗi Release, theo thứ tự này — `release-matched.yaml`, `release-mismatched.yaml`, `release-operator-wired.yaml` — mỗi lần với `workspace_root` đặt thành `connection-credentials`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết mỗi lần build đã ghi những tệp nào; chúng nằm trong `connection-credentials/dist/`.Cây thư mục được kết xuất
dist/matched/helm/├── embeddings-default-service.yaml├── embeddings-headless-service.yaml├── embeddings-statefulset.yaml├── llm-service.yaml├── memory--llm-zdcredential--memory-externalsecret-memory-memory-llm-credential.yaml├── memory-default-service.yaml├── memory-headless-service.yaml└── memory-statefulset.yamlMột tệp được mang đến bởi một attachment chứ không phải bởi Recipe riêng của một component:
ExternalSecret lấy khóa mà store trình ra cho mô hình được lưu trữ
(hosted model). Tên tệp của nó mang tên component mà nó được gắn vào, memory, và
tên của attachment, llm.credential, được viết thành llm-zdcredential vì dấu
chấm nằm chung một chuỗi với tên riêng của tệp; xem
Đặt tên cho một tài nguyên được kết xuất.
Không tệp nào mang khóa embedding: nó nằm trong một Secret mà namespace đã
có sẵn, như các phần dưới đây cho thấy.
Tài liệu nào đã viết gì
- Danh mục khai báo các điểm liên kết. Component của kho lưu trữ khai báo
một khe
credentialtrên mỗi socket trong hai socket mô hình của nó; Component của máy chủ embedding khai báoapi_keytrên chính nó; mỗi Recipe quyết định biến mà một khóa được chuyển giao dưới dạng đó. - Aggregate — nhà phát triển — viết những mô hình mà kho lưu trữ kết nối tới, thông tin xác thực trên mỗi kết nối, khóa mà máy chủ xác minh, và một tham số duy nhất mà cả hai đầu của kết nối embedding cùng đọc.
- Manifest — cách định tuyến của người vận hành cho đích này — quyết định mỗi
thông tin xác thực trở thành gì trên Kubernetes: một tham chiếu tới một Secret mà namespace
đã có sẵn cho mọi attachment
core/referenced-secret, ngoại trừ attachment trên kết nối tới mô hình được lưu trữ, vốn được lấy từ một kho bí mật của cluster. - Release — tài liệu của người vận hành cho một môi trường — đáp ứng các tham số, đặt ranh giới vào một namespace và, trong bản release do người vận hành nối, nối kết nối trích xuất và chỉ định khóa được xuất trình trên đó.
Một khóa cho mỗi kết nối
Kho lưu trữ kết nối tới hai mô hình qua hai socket mà thực thể catalog của nó khai báo,
extraction_model và embedding_model, và mỗi socket khai báo một khe
credential. Vì vậy khóa mà kho lưu trữ xuất trình nằm trên chính kết nối mà nó được
xuất trình, và mỗi kết nối mang khóa riêng của mình. Trích từ
aggregate-matched.yaml:
memory: type: core/datastore/cognee values: # The width of the vectors the embedding model above returns. embedding_dimensions: 384 uses: extraction_model: llm: target: llm features: credential: # the key presented to the hosted model type: core/referenced-secret values: key: api-key origin: "{{ .parameters.provider_key_entry }}" embedding_model: embeddings: target: embeddings features: credential: # the key presented to the embedding server type: core/referenced-secret values: key: api-key origin: "{{ .parameters.embedding_key_secret }}"Một attachment được viết trên một kết nối sẽ trở thành một trong các attachment của chính
kho lưu trữ, được đặt tên theo alias của kết nối, một dấu chấm và tên khe:
llm.credential và embeddings.credential. Dưới đây là hai mục đầu và
bốn mục cuối trong env của container của kho lưu trữ, trích từ
dist/matched/helm/memory-statefulset.yaml:
- name: LLM_API_KEY valueFrom: secretKeyRef: name: memory-llm.credential key: api-key- name: EMBEDDING_API_KEY valueFrom: secretKeyRef: name: embedding-server-key key: api-key[… omitted: the store's own settings, HTTP_PORT to EMBEDDING_DIMENSIONS]- name: EMBEDDING_ENDPOINT value: http://embeddings-default:8080/v1- name: EMBEDDING_MODEL value: BAAI/bge-small-en-v1.5- name: LLM_ENDPOINT value: https://api.openai.com/v1- name: LLM_MODEL value: gpt-4o-miniHai mục đầu là các khóa, mỗi khóa lấy từ thông tin xác thực trên kết nối riêng của nó,
dưới biến mà Recipe của kho lưu trữ đặt cho phía đó — LLM_API_KEY cho
trích xuất, EMBEDDING_API_KEY cho embedding. Cả hai đều là tham chiếu, không phải
giá trị, và helm provider ghi các mục nó đọc từ một Secret trước
các mục thông thường. Bốn mục cuối đến từ hai kết nối: mỗi mô hình
công bố địa chỉ và tên mô hình của nó, và Recipe của kho lưu trữ đọc chúng
theo từng socket.
Component của kho lưu trữ cũng khai báo một khe khóa trên chính nó, model_api_key.
Recipe của nó chỉ đọc khe đó cho một socket không được nối, khi kho lưu trữ kết nối tới
một provider tại địa chỉ riêng của provider đó và không có kết nối nào để mang
khóa. Cả hai socket đều được nối ở đây, nên khe này không được đọc.
Một khóa ở cả hai đầu
Máy chủ embedding kiểm tra một khóa. Nó giữ khóa đó trong một slot của chính
Component của nó, api_key, và Recipe của nó chuyển bất cứ giá trị nào lấp đầy slot thành
API_KEY, biến mà Text Embeddings Inference đọc khi khởi động. Từ
aggregate-matched.yaml:
embeddings: type: core/ai-model/tei values: model: BAAI/bge-small-en-v1.5 features: api_key: # the key the server verifies type: core/referenced-secret values: key: api-key origin: "{{ .parameters.embedding_key_secret }}"Đó là một attachment trên máy chủ. Khóa mà store xuất trình là một attachment khác,
trên kết nối của store, đã trình bày ở trên. Lấp đầy slot ở một đầu không lấp đầy gì ở
đầu kia, vì vậy khai báo khóa ở cả hai đầu là mức tối thiểu chứ không phải một sự
trùng lặp. Điều giữ cho hai khóa là một là cả hai cùng đọc một tham số,
embedding_key_secret, do Aggregate khai báo và Release đáp ứng:
parameters: provider_key_entry: ai/openai-api-key embedding_key_secret: embedding-server-keyManifest gắn core/referenced-secret với k8s-existing-secret, thành phần này
đọc origin là tên của một Secret mà namespace đã có sẵn và không render
gì cả. Vì vậy cả hai đầu đều tham chiếu đến cùng một Secret đó. Trong env của container của máy chủ,
từ dist/matched/helm/embeddings-statefulset.yaml:
- name: API_KEY valueFrom: secretKeyRef: name: embedding-server-key key: api-keyvà trong container của store, từ dist/matched/helm/memory-statefulset.yaml:
- name: EMBEDDING_API_KEY valueFrom: secretKeyRef: name: embedding-server-key key: api-keySecret được tạo bên ngoài Release, bởi người triển khai nó, vì vậy nội dung của khóa không bao giờ đi qua một tệp được soạn thảo hay một artifact được render.
Vì sao máy chủ không bao giờ thấy khóa của các bên gọi đến nó
Một phần đính kèm trên một kết nối chỉ rơi vào bên gọi. Hai thông tin xác thực của kho lưu trữ là các phần đính kèm của kho: những gì chúng kết xuất nằm bên cạnh kho, và container của kho tham chiếu đến nó. Không gì liên quan đến chúng đến được component mà một kết nối trỏ tới, nên một đích được kết xuất giống hệt nhau bất kể các kết nối đến nó mang theo gì.
Mô hình được lưu trữ bên ngoài cho thấy điều này rõ ràng. Nó kết xuất một tệp, một Service ánh xạ một
tên trong cụm sang máy chủ của nhà cung cấp — toàn bộ spec của
dist/matched/helm/llm-service.yaml:
spec: type: ExternalName externalName: api.openai.com ports: - port: 443Khóa mà kho trình ra cho nó được lấy về bên cạnh kho, như phần tiếp theo
cho thấy. Máy chủ embedding cho thấy điều này qua so sánh: bản phát hành không khớp
bên dưới thay đổi khóa trên kết nối embedding của kho và giữ nguyên khóa của
máy chủ, và ba tệp của máy chủ trong dist/mismatched/ chỉ khác
với các tệp trong dist/matched/ ở nhãn aggrega.ai/aggregate-name,
nhãn này nêu tên Aggregate mà mỗi tệp được xây dựng từ đó.
Vì vậy không gì trong cấu hình của máy chủ nêu tên một khóa mà bên gọi nắm giữ. Khi chạy, một yêu cầu mang theo khóa của bên gọi và máy chủ so sánh nó với khóa mà nó nắm giữ; về phần mình, bên gọi chỉ đọc những gì máy chủ công bố: một địa chỉ và một tên mô hình.
Một khóa cho mỗi máy chủ
Text Embeddings Inference kiểm tra một khóa. Mọi bên gọi đều xuất trình cùng một khóa, bên gọi xuất trình bất kỳ khóa nào khác đều bị từ chối, và máy chủ không thể phân biệt bên gọi này với bên gọi khác, nên thu hồi quyền truy cập của một bên gọi đồng nghĩa với việc thay đổi khóa mà mọi bên gọi xuất trình. Dù có bao nhiêu kết nối đến nó, ô api_key của nó chỉ chứa một khóa. Giới hạn đó là của chính máy chủ, và core/ai-model/vllm cùng core/ai-model/tgi của catalog cũng có chung giới hạn này. Đó không phải là giới hạn của kết nối: một bên gọi kết nối đến nhiều máy chủ giữ một khóa cho mỗi kết nối, như kho lưu trữ ở đây giữ hai khóa.
Khóa của một kết nối lấy từ kho bí mật
Manifest gắn mọi attachment core/referenced-secret theo kiểu của nó, và
một trong số đó theo tên. Trích từ manifest.yaml:
features: # One realization for every core/referenced-secret attachment: the Secret # already exists in the namespace, and origin is its name. type: core/referenced-secret:1.0.0: helm/k8s-existing-secret:1.0.0 # One attachment bound differently, by its name. An attachment written on # a connection is named for the connection's alias, a dot and the slot, # so the memory store's credential on its llm connection is # llm.credential. That key is fetched from the store, and origin is the # store entry to fetch. name: llm.credential: helm/k8s-external-secret:1.0.0k8s-external-secret đọc origin như mục trong kho cần lấy. origin của
kết nối là tham số provider_key_entry, được đáp ứng bằng
ai/openai-api-key, nên attachment này kết xuất một ExternalSecret mà một
operator kho bí mật trong cluster đối chiếu thành một Secret. Toàn bộ spec
của
dist/matched/helm/memory--llm-zdcredential--memory-externalsecret-memory-memory-llm-credential.yaml:
spec: refreshInterval: "1h" secretStoreRef: name: platform-secret-store kind: ClusterSecretStore target: name: memory-llm.credential creationPolicy: Owner data: - secretKey: api-key remoteRef: key: "ai/openai-api-key"Secret mà nó điền, memory-llm.credential, được đặt tên theo kho lưu trữ và
kết nối, và đó chính là tên mà LLM_API_KEY của kho lưu trữ tham chiếu ở trên.
Cách hiện thực đọc từ một ClusterSecretStore có tên platform-secret-store.
Nội dung một tham số mang theo tùy thuộc vào cách hiện thực đọc nó: một mục trong kho cho khóa của mô hình được lưu trữ, tên một Secret cho khóa embedding. Khóa của một kết nối nhận một cách hiện thực riêng, trong khi mọi attachment khác cùng kiểu vẫn giữ cách hiện thực của kiểu đó.
Nơi hai đầu phân giải một secret
Một nền tảng đích phân giải một secret theo tham chiếu bên trong một phạm vi secret: ranh giới mà trong đó một tài nguyên có thể gọi tên một tài nguyên khác. Khi cả hai đầu của một kết nối nằm trong cùng một phạm vi, cả hai tham chiếu đến một tài nguyên secret. Khi chúng nằm ở các phạm vi khác nhau, mỗi đầu giữ một tài nguyên secret riêng, được hiện thực từ cùng một mục trong kho. Manifest chọn cách hiện thực cho mỗi đầu — theo kiểu Feature cho mọi attachment thuộc kiểu đó, hoặc cho một attachment theo tên của nó.
Mỗi nền tảng đích vạch phạm vi theo cách riêng của nó. Trên Kubernetes, nền tảng mà workspace này build cho, phạm vi là namespace: một workload chỉ tham chiếu đến một Secret trong namespace của chính nó. Mỗi release ở đây đặt ranh giới duy nhất của nó trong một namespace, aggrega.ai/namespace: memory, và mọi tài liệu được render đều mang nó — phần đầu của cả hai StatefulSet:
metadata: name: memory namespace: memory
# dist/matched/helm/embeddings-statefulset.yamlmetadata: name: embeddings namespace: memoryVì vậy cả hai đầu tham chiếu đến cùng một Secret ở trên. Nếu embedding server nằm trong một namespace riêng, Manifest gắn thông tin xác thực của cả hai đầu theo tên — api_key và embeddings.credential — với k8s-external-secret, Release đáp ứng tham số bằng mục trong kho, và mỗi đầu giữ một ExternalSecret trong namespace của chính nó, cả hai cùng lấy một mục đó. Khi đó store kết nối tới server xuyên qua các namespace, điều mà cross-boundary-networking trình bày. Trên các nền tảng đích khác, phạm vi là một dự án Compose, một cấu hình gốc Terraform và một stack CloudFormation; Mô hình thông tin xác thực mô tả từng trường hợp.
Người vận hành nối một kết nối
aggregate-operator-wired.yaml viết kết nối embedding và để socket extraction_model của store không được gắn: thực thể catalog của store khai báo nó, và nhà phát triển để việc đó lại cho người vận hành. Release nối socket này tới mô hình được lưu trữ mà Aggregate khai báo. Trích từ release-operator-wired.yaml:
memory: uses: # A connection the Aggregate does not write, into a socket the # store's catalog entity declares, to a component the Aggregate # declares. A Release writes no values, so the credential on it # names its secret in infra. extraction_model: llm: target: llm features: credential: type: core/referenced-secret infra: origin: ai/openai-api-keyMột Release có thể nối một kết nối vào một socket mà thực thể catalog khai báo và Aggregate để không gắn, tới một component mà Aggregate khai báo. Nó không thêm component nào, và không bao giờ đổi đích một kết nối mà Aggregate đã viết. Nó không viết values, nên credential trên kết nối đó đặt tên secret của nó trong infra: core/referenced-secret lấy origin từ values của nhà phát triển hoặc infra của người vận hành, đúng một trong hai, và bản dựng dừng lại với một attachment mang cả hai hoặc không mang cái nào.
Attachment được đặt tên llm.credential đúng như trong release khớp, nên tầng tên của Manifest gắn nó theo cùng cách. Ngoài nhãn đặt tên Aggregate, có hai dòng khác nhau giữa dist/operator-wired/ và dist/matched/. Phần data của ExternalSecret:
data: - secretKey: value remoteRef: key: "ai/openai-api-key"và tham chiếu của store tới Secret mà nó điền, trong dist/operator-wired/helm/memory-statefulset.yaml:
- name: LLM_API_KEY valueFrom: secretKeyRef: name: memory-llm.credential key: valueKhóa dữ liệu là value thay vì api-key vì key là một lá của values, thứ mà chỉ Aggregate viết, nên một attachment do riêng Release tạo ra sẽ đọc giá trị mặc định của Feature. Phần hiện thực công bố khóa đó và store đọc nó từ những gì đã được công bố, nên hai bên vẫn khớp nhau.
Mô hình được lưu trữ được gắn nhãn managed, nên một kết nối tới nó phải mang một credential hoặc nói trong values của chính nó rằng mô hình không cần credential nào, unauthenticated: true. Điều đó đúng bất kể tài liệu nào đã viết kết nối. Hãy xóa khối features: khỏi kết nối của Release và bản dựng sẽ dừng lại. Lỗi dừng là E0033, một assertion thất bại của Component của store, và thông báo của nó kết thúc bằng chính câu của quy tắc: the extraction_model connection llm of “memory” reaches “llm”, whose component.aggrega.ai/hosting label is managed, with no credential: attach one under credential on that connection, or set unauthenticated: true in its values (kết nối extraction_model llm của “memory” tới “llm”, có nhãn component.aggrega.ai/hosting là managed, mà không có credential: hãy gắn một credential dưới credential trên kết nối đó, hoặc đặt unauthenticated: true trong values của nó).
Khi hai đầu không khớp nhau
aggregate-mismatched.yaml cấp cho khóa của máy chủ và khóa của kho lưu trữ hai
tham số khác nhau:
parameters: provider_key_entry: type: string description: > The store entry holding the key the memory store presents to the hosted model provider. embedding_key_secret: type: string description: The Secret holding the key the embedding server verifies. # The fault: a second parameter for what is meant to be the same key. memory_embedding_key_secret: type: string description: The Secret holding the key the memory store presents to the embedding server.api_key của máy chủ đọc embedding_key_secret còn kết nối của kho lưu trữ
đọc memory_embedding_key_secret, và Release đáp ứng hai tham số này bằng hai
Secret khác nhau. Bản dựng thành công và ghi ra tám tệp: trình biên dịch
đánh giá từng attachment được cung cấp và không so sánh gì giữa hai
đầu. Máy chủ vẫn tham chiếu embedding-server-key, còn kho lưu trữ giờ
xuất trình một Secret khác, trích từ dist/mismatched/helm/memory-statefulset.yaml:
- name: EMBEDDING_API_KEY valueFrom: secretKeyRef: name: embedding-client-key key: api-keyKhi triển khai, máy chủ chỉ chấp nhận các yêu cầu của kho lưu trữ nếu hai Secret đó tình cờ chứa cùng một khóa.
Bước kiểm tra các quy ước công bố của một Release là nơi phát hiện ra điều này:
aggrega lint --release release-mismatched.yamlrelease-mismatched.yaml:warn: E0329 connection-credential-matches-target-key: connection "embeddings" on socket "embedding_model" of component "memory" carries a credential in its credential slot and its target "embeddings" holds a key in its api_key slot, but the two ends write their secret's locator differently, so they may name different secrets and the target would refuse the key this caller presents. The locators are compared as written, and neither is shown here. Reading one parameter at both ends keeps them one key; that agreement is the standard-catalog convention, and the build does not check it.conventions checked: 10 entities, 1 advisory finding(s)Cùng bước kiểm tra đó trên bản phát hành khớp nhau không báo gì:
aggrega lint --release release-matched.yamlconventions checked: 10 entities, 0 advisory finding(s)và trên bản phát hành do người vận hành nối kết cũng không báo gì.
Quy tắc tìm hai đầu theo các tên mà catalog chuẩn đặt cho chúng — api_key
của đích và credential của kết nối — rồi so sánh
origin mà mỗi đầu ghi, đúng như đã ghi: hai đầu đọc cùng một tham số được coi là
bằng nhau, và không có gì được phân giải. Quy tắc không bao giờ trích dẫn đầu nào, vì những gì được ghi
ở đó có thể chính là secret. Quy tắc không đánh giá một đích được gắn nhãn managed,
mà api_key của nó, nếu có khai báo, là khóa xuất trình cho nhà cung cấp của nó
chứ không phải khóa mà các bên gọi nó xuất trình; vì vậy kết nối tới llm không nhận cảnh báo nào
trong cả ba bản phát hành. Phát hiện này chỉ là lời khuyên: aggrega lint thoát với mã 0,
và một workspace có hai đầu cố ý khác nhau có thể tắt nó bằng
allow_connection_credential_mismatches. Một trình soạn thảo hỏi daemon cùng
câu hỏi đó, qua aggrega/lint chỉ định Release, sẽ nhận cùng phát hiện với
mã connection-credential-matches-target-key và mã ngắn E0329.
Quy tắc và những gì nó đọc được mô tả trong
Các quy tắc kỷ luật.
Tính tất định
Cả ba release đều build được với --verify-determinism, cờ này render mọi
node hai lần và so sánh các byte được xuất ra:
aggrega build --release release-matched.yaml --verify-determinismBuild lại bất kỳ release nào trong ba release từ một cây sạch đều tái tạo đầu ra đã render của nó giống hệt đến từng byte.
Điều chỉnh ví dụ
- Thêm một bên gọi thứ hai cho máy chủ embedding. Thông tin xác thực trên kết nối của nó
cũng đọc
embedding_key_secret. Máy chủ giữ một khóa cho mọi bên gọi, nên bên gọi thứ hai xuất trình cùng một khóa. - Cũng lấy khóa embedding từ kho bí mật. Liên kết
api_keyvàembeddings.credentialtheo tên vớik8s-external-secretvà đáp ứngembedding_key_secretbằng một mục trong kho thay vì tên của một Secret. Cả hai đầu cùng thay đổi vì cả hai đều đọc tham số này. - Kết nối tới một mô hình không kiểm tra khóa. Bỏ thông tin xác thực khỏi
kết nối. Khi đích được gắn nhãn
managed, hãy nêu điều đó trên kết nối bằngunauthenticated: truetrongvaluescủa nó.
Để dùng chung một khóa cho kết nối của nhiều bên gọi, xem model-api-key-sharing. Để có một bộ định tuyến giữ các khóa của nhà cung cấp thay cho các bên gọi của nó, xem ai-agent-and-model-router. Mô hình đứng sau tất cả những điều này là Mô hình thông tin xác thực.