Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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)
instanceComponent trong catalogvai trò ở đây
memorycore/datastore/cogneebê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 đó
llmcore/ai-model/openaimộ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
embeddingscore/ai-model/teiText 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:

releaseAggregateđiều nó minh họa
release-matched.yamlaggregate-matched.yamlcả 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.yamlaggregate-mismatched.yamlgiố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.yamlaggregate-operator-wired.yamlkế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ó:

Terminal window
aggrega scaffold --example connection-credentials

Sau đó 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:

Terminal window
cd connection-credentials

Build

Mỗi lần chạy, build một release:

Terminal window
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ó:

Terminal window
aggrega pull --release release-matched.yaml # resolve, then build normally
aggrega build --release release-matched.yaml --auto-pull # or resolve during the build

Workspace 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>/dist

Hai 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.yaml

Mộ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 credential trên mỗi socket trong hai socket mô hình của nó; Component của máy chủ embedding khai báo api_key trê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-mini

Hai 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-key

Manifest 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-key

và trong container của store, từ dist/matched/helm/memory-statefulset.yaml:

- name: EMBEDDING_API_KEY
valueFrom:
secretKeyRef:
name: embedding-server-key
key: api-key

Secret đượ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: 443

Khó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.0

k8s-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:

dist/matched/helm/memory-statefulset.yaml
metadata:
name: memory
namespace: memory
# dist/matched/helm/embeddings-statefulset.yaml
metadata:
name: embeddings
namespace: memory

Vì 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-key

Mộ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: value

Khó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-key

Khi 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:

Terminal window
aggrega lint --release release-mismatched.yaml
release-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ì:

Terminal window
aggrega lint --release release-matched.yaml
conventions 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:

Terminal window
aggrega build --release release-matched.yaml --verify-determinism

Build 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_key và embeddings.credential theo tên với k8s-external-secret và đáp ứng embedding_key_secret bằ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ằng unauthenticated: true trong values củ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.