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.

Mô hình thông tin xác thực

Một họ đính kèm duy nhất

Trong Aggrega, một thông tin xác thực là một Feature. Nó được đính kèm trên cùng bề mặt, dưới cùng từ khóa, theo cùng hình dạng như mọi Feature khác. Ở đây nhà phát triển đính kèm thông tin xác thực của cơ sở dữ liệu trong Aggregate, ghi bộ định vị của nó trong values:

# the Aggregate — its parameters and the components' own values left out
spec:
components:
api:
type: core/compute/server
db:
type: core/datastore/mariadb
features:
root_password: # a credential Feature
type: core/secret-value:1.0.0
values:
key: MARIADB_ROOT_PASSWORD
origin: "{{ .parameters.db_root_pass }}"

và người vận hành đính kèm một đích thu thập số liệu vào máy chủ trong Release, vì mọi đầu vào mà core/prometheus-exporter nhận — cổng, đường dẫn và khoảng thời gian thu thập — đều mang tính vận hành, nên được ghi trong infra:

# the Release — the api's own infra and the db's entry left out
spec:
components:
api:
features:
metrics: # an operational Feature
type: core/prometheus-exporter:1.0.0
infra:
port: http # the named port of the api's Service

Có một từ khóa đính kèm (features:), một hình dạng ngữ cảnh render (.features.<name>, và cùng hình dạng đó dưới một kết nối, .context.uses.<alias>.features.<slot>, cho một đính kèm được viết trên kết nối), một thứ tự thực thi, và một bộ tọa độ đầu ra — với một đính kèm trên một thành phần, đó là thành phần mà nó được đính kèm rồi đến tên mà nó được đính kèm dưới đó, dù bố cục của đích mang hai thông tin này dưới dạng thư mục <component>--<instance>/ bên cạnh thư mục của chính thành phần hay dưới dạng tiền tố tên tệp <component>--<instance>--. Điều khác nhau giữa các đính kèm là thứ chúng tạo ra — một giá trị được tiêm, một tài nguyên có thể tham chiếu, một sidecar, một danh tính đám mây — chứ không phải bề mặt mà chúng được khai báo trên đó.

Một Feature thông tin xác thực mang nhãn feature.aggrega.ai/kind: secret trên thực thể danh mục của nó. Nhãn đó là siêu dữ liệu mô tả: nó cho người đọc, trang danh mục và bộ chọn nhãn biết Feature dùng để làm gì. Không nhánh nào của trình biên dịch đọc nó, và không hành vi nào phụ thuộc vào nó. Hành vi đến từ FeatureRecipe mà người vận hành ánh xạ kiểu Feature tới.

Mô hình tư duy trong một câu: chỉ có một loại đính kèm; điều khác nhau là thứ nó tạo ra.

Slot và đính kèm tự do

Một Component hoặc Feature có thể khai báo slot trong featuresSchema:

spec:
featuresSchema:
root_password:
required: true
inject: [] # blackbox — the Recipe delivers it
selector: "feature.aggrega.ai/kind=secret"
user_password:
inject: [env, file] # transparent — the developer may dictate delivery

Một đính kèm có tên phiên bản khớp với một slot đã khai báo sẽ lấp đầy slot đó. Một đính kèm dưới bất kỳ tên nào khác là một đính kèm tự do: thực thể không yêu cầu nó, và nó được render cùng với mọi thứ mà thực thể đã yêu cầu. Schema được sinh cho một slot đã khai báo vẫn mở, nên việc khai báo một slot không bao giờ đóng khối với các đính kèm tự do. Chỉ một hình dạng gây dừng thay vì render: một đính kèm được viết trên chính thành phần mà Feature của nó thỏa mãn selector của một slot không có gì ràng buộc ở đó, tức là một lần lấp đầy được viết sai tên chứ không phải một đính kèm tự do.

Hai điều một slot có thể ràng buộc:

  • inject — các cơ chế phân phối mà một Workload có thể chọn cho thứ lấp đầy slot. Một danh sách rỗng là một slot hộp đen: cơ chế riêng của Recipe phân phối nó (ví dụ tùy chọn existingSecret của một chart), và một Workload không được tham chiếu nó từ một container.
  • selector — một chuỗi bộ chọn nhãn mà các nhãn của Feature lấp đầy phải thỏa mãn. Đây là nơi nhãn kind=secret phát huy tác dụng: tác giả thực thể muốn một slot chỉ được lấp đầy bởi thông tin xác thực sẽ nói điều đó bằng một bộ chọn, và việc kiểm tra là một phép đánh giá tập nhãn mà trình biên dịch thực hiện trong quá trình phân tích tĩnh.

Điều thứ ba một slot có thể làm là yêu cầu cuối cùng phải được ràng buộc. required: true khiến tên của slot trở thành bắt buộc: trình biên dịch dừng trong quá trình phân tích tĩnh khi không có gì ràng buộc nó, với một chẩn đoán nêu tên slot và kiểu thành phần đã khai báo nó. Yêu cầu này được đối chiếu với tập đính kèm mà thành phần có sau khi mọi phạm vi đã được áp dụng theo tầng, nên một đính kèm được đóng góp ở trên thành phần ràng buộc slot y hệt như một lần lấp đầy được viết trên thành phần.

Một bề mặt thứ hai thể hiện một yêu cầu khác. Chú thích Component có thể lặp lại features.aggrega.ai/requiredType.<label> khai báo một yêu cầu hiện diện: ít nhất một đính kèm phải mang kiểu Feature mà chú thích nêu tên, dưới bất kỳ tên nào và ở bất kỳ phạm vi nào, và một yêu cầu không được thỏa mãn sẽ dừng trong cùng lần phân tích tĩnh đó với chẩn đoán riêng của nó. Hai cơ chế này không bao giờ thay thế cho nhau — một slot hỏi liệu một điểm ràng buộc có tên đã được ràng buộc chưa, một yêu cầu hiện diện hỏi liệu có đính kèm nào mang một kiểu có tên hay không — nên một thực thể cần Recipe của nó đọc thứ đã được đính kèm sẽ khai báo một slot, còn một thực thể có hợp đồng chỉ đơn giản đòi hỏi một năng lực phải hiện diện sẽ khai báo một yêu cầu hiện diện.

Những gì trình biên dịch đảm bảo và không đảm bảo

Phần này là phần chịu lực. Aggrega là một trình biên dịch ahead-of-time, và các đảm bảo của nó hẹp hơn những gì từ “secret” khiến người đọc giả định.

Trình biên dịch không bao giờ phân giải một thông tin xác thực. Nó không xác thực với API đám mây, không đọc vault, và không lấy vật liệu trong aggrega build. values và infra của một đính kèm thông tin xác thực đi qua đồ thị và vào ngữ cảnh render dưới dạng các giá trị vô hướng mờ đục, và một FeatureRecipe render chúng vào bất kỳ tạo phẩm nào mà nền tảng đích mong đợi. Việc phân giải xảy ra sau đó, trong cluster hoặc trình quản lý trạng thái IaC, dựa trên bất cứ thứ gì mà tạo phẩm đã render trỏ tới.

Trình biên dịch không thể phân biệt một con trỏ với một giá trị vật liệu. Nó không phụ thuộc vào ý nghĩa của một giá trị vô hướng (xem 05-invariants.md). Một đính kèm thông tin xác thực có bộ định vị mang tọa độ kho (path, key, một ARN) sẽ render một tham chiếu tới tọa độ đó; một đính kèm thông tin xác thực có bộ định vị mang chính vật liệu sẽ render vật liệu, nguyên văn, vào tệp đầu ra. Cả hai đều hợp lệ, và trình biên dịch xử lý chúng giống hệt nhau vì nó không có cách nào phân biệt chúng.

Vì vậy, phát biểu trung thực về đảm bảo là:

Aggrega đảm bảo rằng trình biên dịch không thực hiện bất kỳ phân giải nào. Nó không đảm bảo rằng đầu ra đã render không chứa vật liệu — điều đó hoàn toàn phụ thuộc vào Feature thông tin xác thực nào được đính kèm và tác giả của nó đã đưa gì vào, nhà phát triển trong values hay người vận hành trong infra.

Hai hệ quả đáng ghi nhớ:

  • Một cây tạo phẩm đã render nhạy cảm ngang với đính kèm mang nhiều vật liệu nhất của nó. Hãy xử lý dist/ cho phù hợp: nếu bất kỳ đính kèm nào mang vật liệu nội tuyến, cây đó chứa vật liệu.
  • Các họ core/secret-value và core/referenced-secret của chính danh mục bao gồm các dạng chấp nhận trực tiếp một giá trị. Chúng tồn tại vì các bản triển khai thực cần một con đường cho phát triển cục bộ, và chúng thẳng thắn về điều đó: các ví dụ đi kèm dùng giá trị giữ chỗ hiển nhiên (dev-root-pw-change-me) chính để vật liệu trong một ví dụ đã render rõ ràng không phải thông tin xác thực thật. Với một bản triển khai không được mang vật liệu, hãy đính kèm một Feature thông tin xác thực dựa trên kho có FeatureRecipe phát ra một tài nguyên truy xuất (một ExternalSecret, một tài nguyên tùy chỉnh truy xuất từ vault, một tham chiếu secret gốc của provider) thay vì một tài nguyên phát ra dữ liệu.

Quy ước của thư viện chuẩn là một thông tin xác thực được yêu cầu dưới dạng đính kèm thay vì được ghi vào khối values, để việc thay một lần lấp đầy cho phát triển cục bộ bằng một lần lấp đầy dựa trên kho là một thay đổi Manifest chứ không phải chỉnh sửa ý định của nhà phát triển. Đó là một quy ước mà danh mục tuân theo, không phải một quy tắc mà trình biên dịch áp đặt.

Độ nhạy cảm được khai báo

Trình biên dịch không thể phân biệt một con trỏ với một giá trị vật liệu, theo phần trên — nhưng một tác giả thì có thể, và có thể nói ra điều đó. Độ nhạy cảm trong Aggrega là một chú thích trên một khai báo: tác giả của một thực thể danh mục nêu rõ thứ gì mang vật liệu bí mật, và trình biên dịch suy ra phần còn lại từ phát biểu đó cộng với phần nối dây mà nó đã xây dựng. Không có gì được suy luận từ một giá trị, và không có gì được đoán từ tên của một trường.

Nó được viết ở đúng hai nơi, và hai nơi đó mang những khẳng định thực sự khác nhau.

Trên một lá schema — dữ liệu này là vật liệu bí mật. Một lá values, infra hoặc provides khai báo sensitive: true:

spec:
schema:
values:
origin:
type: string
required: true
sensitive: true # the material
key:
type: string
default: value # a data key — a locator, not material

Trên một slot đính kèm — bất cứ thứ gì ràng buộc điểm này đều xử lý vật liệu bí mật. Một slot featuresSchema khai báo sensitive: true:

spec:
featuresSchema:
password:
selector: "feature.aggrega.ai/kind=secret"
sensitive: true
inject: [env]

Hai cấp độ này không phải là bản sao cho tiện của nhau, và hình dạng thông tin xác thực có thể tham chiếu là trường hợp cụ thể cho thấy lý do. Một thông tin xác thực có thể tham chiếu công bố provides.name và provides.key — bộ định vị của tài nguyên và khóa dữ liệu bên trong nó — và không cái nào nhạy cảm: tên của một Kubernetes Secret là công khai, và khóa bên trong nó cũng vậy. Cả hai đều được render dạng rõ vào manifest của chính bên tiêu thụ dưới dạng secretKeyRef. Tuy vậy, slot mà thông tin xác thực đó lấp đầy chắc chắn xử lý vật liệu bí mật. Một cấp độ duy nhất không thể diễn đạt cả hai sự thật: đánh dấu các bộ định vị đã công bố để slot được đọc là nhạy cảm sẽ khẳng định điều sai về chúng và mang lỗi đó tới mọi nơi khai báo được đọc.

Từ hai khai báo đó, trình biên dịch suy ra, cho từng đính kèm, liệu đính kèm có xử lý vật liệu được khai báo nhạy cảm hay không — đúng khi Feature được đính kèm khai báo một lá nhạy cảm, hoặc khi slot mà nó ràng buộc khai báo một lá như vậy, chỉ cần một trong hai là đủ. Nó suy ra điều này từ đính kèm ở trạng thái sau khi mọi phạm vi soạn thảo đã được gộp lại, nên một khai báo ở phạm vi rộng hơn đã bị một lần lấp đầy hẹp hơn thay thế sẽ không còn lưu lại, và yêu cầu của một slot áp dụng cho lần lấp đầy thực sự thắng. Một Feature thông tin xác thực hoàn toàn không khai báo lá nhạy cảm nào — vì engine đích sở hữu vật liệu và tác giả không viết gì — vẫn tạo ra một đính kèm nhạy cảm khi nó ràng buộc một slot nhạy cảm.

Giới hạn trên, nói rõ ràng

Từ “nhạy cảm” khiến người đọc mong đợi một cơ chế bảo mật. Nó không phải vậy, và đảm bảo hẹp hơn những gì cái tên gợi ý theo năm cách cụ thể:

  • Nó không mã hóa. Không có gì được bọc, niêm phong hay biến đổi.
  • Nó không thay đổi phán quyết của bản build, với một ngoại lệ. Không bản build nào dừng vì thiếu một khai báo, và một danh mục có các thực thể thông tin xác thực không mang khai báo nào vẫn build thành công. Không giá trị nào được chấp nhận hay từ chối vì có một khai báo, ngoại trừ khi valuesMapping của một Recipe hoặc FeatureRecipe CloudFormation đọc một giá trị được khai báo nhạy cảm để điền các tham số của một template có nguồn: ở đó mọi literal mà ánh xạ ràng buộc đều bị từ chối, nên việc thêm một khai báo có thể biến một bản build đang thành công thành một bản build bị dừng — xem A secret bound to a CloudFormation parameter would be written into the template (Một secret được ràng buộc với một tham số CloudFormation sẽ bị ghi vào template). Ở mọi nơi khác, thêm khai báo vào một danh mục hiện có vẫn giữ mọi bản build từng thành công tiếp tục thành công.
  • Nó không đảm bảo rằng đầu ra đã render không có vật liệu. Đảm bảo nêu ở trên không thay đổi: việc một tạo phẩm có mang vật liệu hay không phụ thuộc vào lần lấp đầy nào được đính kèm và tác giả của nó đã đưa gì vào. Một giá trị được khai báo nhạy cảm được cung cấp nội tuyến sẽ được render y hệt một giá trị không khai báo ở bất cứ đâu bản build render nó — sự từ chối của CloudFormation ở trên chặn một literal thay vì render nó, và một hàm nội tại được ghi đúng như đã cho, kể cả văn bản của nó — và dist/ vẫn nhạy cảm ngang với đính kèm mang nhiều vật liệu nhất của nó.
  • Nó không ép buộc một cơ chế phân phối. Một khai báo không thể chuyển một giá trị nội tuyến thành tham chiếu kho, và nó không thu hẹp những gì danh sách cho phép inject của một slot cho phép. Ép buộc phân phối có nghĩa là phát ra một tài nguyên mà tác giả chưa bao giờ khai báo, đó chính xác là điều mà bất biến không có hạ tầng ma cấm — xem 05-invariants.md.
  • Nó không thay đổi byte nào được render trên hầu hết các đích, và trên những đích đó sẽ không bao giờ thay đổi. Hai đường render đi kèm hành động theo khai báo trong những gì chúng tạo ra (các provider Helm, Helm-Chart và Compose cũng đọc nó, chỉ để giữ một giá trị đã đánh dấu ngoài văn bản của một lỗi): provider Terraform đánh dấu đầu vào của một module được vendor mang vật liệu được khai báo nhạy cảm bằng thuộc tính nhạy cảm của chính Terraform — xem language-reference/providers/terraform.md “Đầu vào module được khai báo nhạy cảm”; khi valuesMapping của một Recipe, hoặc của FeatureRecipe thuộc một Feature được đính kèm vào một thành phần, tự đặt tên đầu vào, không đầu vào nào có thể mang thuộc tính đó và bản build in ra một cảnh báo nói như vậy, xem A declared-sensitive value reaches the target through a values mapping (Một giá trị được khai báo nhạy cảm tới đích thông qua một ánh xạ giá trị) — và provider CloudFormation từ chối các ràng buộc literal được mô tả ở trên, điều này dừng một bản build thay vì thay đổi byte của nó. Ở mọi nơi khác, thêm khai báo trong một danh mục hiện có giữ mọi tạo phẩm đã render y hệt. Giới hạn trên vượt ra ngoài đó mang tính cấu trúc chứ không phải vấn đề về những gì đã được xây dựng: một khai báo chỉ có thể tới được một tạo phẩm đã render trên một nền tảng đích mà ngôn ngữ riêng của nó có khái niệm nhạy cảm — một khai báo mà nền tảng đó hiểu, quy định cách nó hiển thị một giá trị chứ không phải cách nó lưu trữ. Trên một đích không có khái niệm như vậy, không có gì để một khai báo trở thành, nên đầu vào giống hệt được render giống hệt dù có hay không có nó, vĩnh viễn.

Một điều mà khai báo có thay đổi là những gì CLI in ra cho con người đọc. Một giá trị được khai báo nhạy cảm được thay bằng một giá trị giữ chỗ cố định trong vết theo từng lượt và trong các bố cục inspect, giữ lại khóa và chỉ giấu giá trị. Đó là một quyết định hiển thị trên những bề mặt không ai triển khai, và các tạo phẩm đã render được phát ra nguyên văn vì chúng là thứ được triển khai.

Khi trình biên dịch có thể nhận diện giá trị theo khóa — một lá đã khai báo, hoặc một khóa phân phối mang vật liệu từ một khóa provides đã khai báo — việc thay thế là chính xác. Một giá trị mà template đã ghi vào một tài liệu khác không mang khóa nào để thay thế tại đó, vì một tài liệu đã render không ghi lại gì về việc mỗi ký tự đến từ khai báo nào, và khôi phục điều đó có nghĩa là kiểm tra nội dung. Vì vậy vết hiển thị một tài liệu như thế bằng cách đánh giá cùng template lần thứ hai với một ngữ cảnh mà dữ liệu được khai báo nhạy cảm đã được đọc là giá trị giữ chỗ, và gắn nhãn kết quả là một lần render lại chứ không phải thứ đã được render: một template rẽ nhánh theo nội dung của một giá trị sẽ render khác đi với giá trị giữ chỗ, và một dữ liệu không được khai báo nào nêu tên sẽ được chuyển qua không đổi. Các bề mặt, cách gắn nhãn đó và giới hạn của nó có tại language-reference/vocabulary/compact-form-authoring.md “Khai báo một lá là nhạy cảm”.

Vì vậy, phát biểu trung thực về những gì trục này mang lại:

Một khai báo nhạy cảm là một phát biểu về ý định của tác giả đi cùng thực thể, để công cụ và chính sách có thể suy luận về những gì một bản triển khai xử lý. Nó không phải là một cơ chế bảo vệ điều đó.

Bảo vệ vật liệu vẫn là việc của kho secret, cluster và pipeline xử lý cây đã render — như phần còn lại của chương này nói.

Cách một thông tin xác thực tới được container

Hai hình dạng phân phối, do FeatureRecipe của đính kèm chọn chứ không phải nhà phát triển:

Giá trị được tiêm. FeatureRecipe khai báo một injectMapping và không có tài nguyên nào. Đầu ra của nó được hợp nhất sâu vào đường ống phân phối của thành phần tiêu thụ trước khi Recipe cơ sở render, nên một Recipe đọc .context.inject.env.<KEY> sẽ nhận được giá trị. Không có gì độc lập được phát ra.

Hai thông tin xác thực được phân phối dưới cùng một khóa sẽ dừng bản build, nêu tên cả hai đính kèm: một ánh xạ ghi một khóa mà một Feature được đính kèm khác đã phân phối — qua ánh xạ riêng của Feature đó hoặc khối inject: riêng của nó — bị từ chối thay vì được hợp nhất, nên một thông tin xác thực không bao giờ được trình ra thay cho một thông tin khác. Quy tắc này như nhau cho mọi đính kèm, dù nó được đính kèm ở đâu và dù nó lấp đầy một slot trên thành phần hay trên một kết nối. Một ánh xạ thay thế một khóa mà khối inject: riêng của thành phần hoặc một trong các kết nối của nó đã phân phối là sự chặn bắt mà các Features định tuyến dựa vào, và vẫn hợp lệ.

Tài nguyên có thể tham chiếu. FeatureRecipe khai báo source, workload, artifacts và/hoặc valuesMapping, nên nó phát ra một tài nguyên — thường là một Secret gốc của nền tảng. Nó công bố danh tính của tài nguyên đó qua provides của mình, và bên tiêu thụ đọc lại dưới dạng .features.<name>.provides.name / .provides.key. Tên riêng của tài nguyên được suy ra từ cùng provides đã công bố, nên tên mà bên tiêu thụ đọc và tên mà tài nguyên mang là một chuỗi được đánh giá duy nhất chứ không phải hai phép suy ra có thể lệch nhau.

Workload của một Recipe tiêu thụ một lần lấp đầy có thể tham chiếu thông qua map attachments: của một container:

workload: |
containers:
main:
attachments:
DB_PASSWORD:
from: root_password # a slot the Component declares
as: env

Bộ tổng hợp phân giải tham chiếu từ provides đã công bố của slot — một secretKeyRef của Kubernetes cho as: env, một volume dựa trên secret cho as: file. Tác giả Recipe chỉ viết tên slot và cơ chế.

Một FeatureRecipe có thể làm cả hai: viết lại đường ống phân phối và phát ra một tài nguyên. Nó cũng có thể khai báo một pipeline gồm các bước Wasm, chạy như nhau cho mọi họ đính kèm — một đính kèm thông tin xác thực có thể biến đổi các tài liệu đã render của thành phần chủ khi được mời, y hệt như một đính kèm vận hành có thể làm.

Ai đặt tên cho thông tin xác thực

Bộ định vị của một thông tin xác thực — tên của secret, mục kho cần truy xuất, giá trị cần phân phối — được viết bởi người biết nó, và đó không phải lúc nào cũng là nhà phát triển. Một kết nối mà Release nối dây không có mục nào trong Aggregate, và Release không viết values ở đâu cả, nên một thông tin xác thực chỉ lấy bộ định vị từ values sẽ không bao giờ được đặt tên trên một kết nối như vậy, cũng như trên bất kỳ đính kèm nào mà Release tạo ra.

Vì vậy, mỗi Feature thông tin xác thực của thư viện chuẩn mang bộ định vị của bên gọi — core/referenced-secret, core/referenced-secret-set, core/secret-value và core/secret-provided — chấp nhận nó từ một trong hai tác giả: nhà phát triển trong values của đính kèm, trong Aggregate, hoặc người vận hành trong infra của nó, trong Release. Lá đó có một tên, một hình dạng và một khai báo sensitive: true ở cả hai trụ cột, và mọi hiện thực hóa đọc trụ cột nào mang nó. Lệnh cấm values: của Release vẫn giữ nguyên: bộ định vị của người vận hành là infra. Các Features không nhận bộ định vị — core/random-password, core/generated-secret — không bị ảnh hưởng.

Đúng một, do Feature đảm bảo. Một đính kèm mang bộ định vị ở một trụ cột, không bao giờ ở cả hai và không bao giờ ở không cái nào. Schema của không trụ cột nào có thể nói điều đó, vì mỗi trụ cột được xác thực riêng; chính khối assertions riêng của mỗi Feature làm điều đó, và một đính kèm vi phạm nó sẽ dừng bản build, nêu tên Feature, đính kèm và thành phần. Đó là hợp đồng của thực thể danh mục, được duy trì theo cách mọi khẳng định của Feature được duy trì: trình biên dịch đánh giá template mà tác giả Feature đã viết và không có quy tắc riêng nào về thông tin xác thực, trụ cột hay bộ định vị.

Những gì vẫn ở nguyên chỗ cũ. Mọi trường khác giữ nguyên trụ cột của nó — khóa dữ liệu của một thông tin xác thực có thể tham chiếu vẫn được viết trong values, nên một đính kèm chỉ do Release tạo ra sẽ đọc giá trị mặc định của nó — và core/secret-provided vẫn chỉ phân phối qua khối inject: riêng của đính kèm, thứ chỉ Aggregate viết và đính kèm của một kết nối không bao giờ mang.

Chia sẻ một thông tin xác thực giữa nhiều bên tiêu thụ

Bên tiêu thụ có thể giữ thông tin xác thực. Một slot thuộc về thực thể cần thông tin xác thực, và thực thể đó thường là bên gọi chứ không phải thứ được gọi: một thành phần trình ra một khóa khi kết nối ra ngoài sẽ khai báo slot cho khóa đó trên thực thể catalog của chính nó, trên socket mà nó dùng để kết nối, nhờ đó khóa được giữ trên kết nối mà nó được trình ra — và không có gì ở một cạnh uses buộc đích phải cung cấp khóa. core/ai-agent/crewai là hình dạng có sẵn — socket model của nó khai báo một slot credential tùy chọn mang selector feature.aggrega.ai/kind=secret, inject: [env] và sensitive: true, và một Aggregate điền slot đó dưới kết nối, tại uses.model.<alias>.features.credential. Những gì các thành phần mô hình của thư viện chuẩn công bố cho bên tiêu thụ đọc là một vị trí phục vụ và một tên mô hình, không phải thông tin xác thực, vì vậy khóa mà agent trình ra khi gọi endpoint đó được agent khai báo và giữ trên kết nối của nó. Slot là tùy chọn, nhưng một kết nối đến một mô hình mà catalog của nó gắn nhãn component.aggrega.ai/hosting: managed mà không mang thông tin xác thực nào sẽ làm dừng bản build, trừ khi chính values của kết nối nói rằng mô hình không cần thông tin xác thực, unauthenticated: true — một assertion mà thực thể catalog của agent mang, được trình biên dịch đánh giá như mọi assertion khác, đọc nhãn như một chuỗi. Thành phần mô hình mà nó kết nối tới có thể giữ một khóa riêng cho các bên gọi của chính nó — core/ai-model/vllm khai báo một slot api_key chính vì mục đích đó — và hai thứ này là các điểm ràng buộc riêng biệt: một phần đính kèm ràng buộc một slot theo tên tại nơi slot được khai báo, trên thành phần hoặc trên kết nối, nên việc điền một slot không nói lên điều gì về slot kia.

Chính cách đặt đó khiến hai hình thức dưới đây thực sự trở thành lựa chọn triển khai: khi slot nằm ở bên tiêu thụ, một bản build có thể cấp cho mỗi bên tiêu thụ một khóa riêng và một bản build khác có thể cấp cho tất cả cùng một khóa, mà không có thực thể catalog nào thay đổi giữa chúng.

Cùng một thực thể catalog phục vụ cả hai hình thức, và tác giả chọn hình thức nào:

  • Theo từng bên tiêu thụ. Mỗi bên tiêu thụ điền slot của riêng mình bằng phần đính kèm thông tin xác thực của riêng mình — trên thành phần, hoặc trên kết nối của nó khi slot thuộc về một socket. Mỗi bên nhận tài nguyên được kết xuất của riêng mình.
  • Dùng chung. Với một slot do thành phần khai báo, một thông tin xác thực được đính kèm một lần ở một phạm vi dùng chung — một hệ thống con trong Aggregate, một ranh giới trong Release — và lan truyền theo tầng tới mọi thành phần trong phạm vi đó. Một slot do socket khai báo được điền theo từng kết nối, và không có gì lan truyền theo tầng vào trong một kết nối, nên ở đó hình thức dùng chung được viết trên từng kết nối: thông tin xác thực của mỗi kết nối đọc cùng một tham số. Khi các bên tiêu thụ phải tham chiếu một tài nguyên vật lý duy nhất, tham số đó đặt tên cho nó — core/referenced-secret được ràng buộc với cách hiện thực existing-Secret trỏ mọi kết nối tới một Secret duy nhất theo tên, và một thông tin xác thực được sinh ra là một yêu cầu và nhiều tham chiếu, như bên dưới.

Hãy nói chính xác cách hình thức dùng chung được kết xuất, vì rất dễ giả định khác đi: một phần đính kèm dùng chung kết xuất một tài nguyên cho mỗi bên tiêu thụ, mỗi tài nguyên mang cùng một dữ liệu bí mật từ một khai báo duy nhất. Việc kết xuất chạy theo từng thành phần, và do đó tên tài nguyên được suy ra từ {{ .context.instance_id }}-{{ .attachment_name }} khác nhau cho mỗi bên tiêu thụ. Thứ được dùng chung là khai báo duy nhất; các tài nguyên được phát ra không được gộp trùng thành một. Một tham số được đọc trên mỗi kết nối cũng kết xuất theo cách đó dưới một cách hiện thực có kết xuất tài nguyên — một tài nguyên cho mỗi kết nối, với tên phần đính kèm là bí danh của kết nối, một dấu chấm và slot.

Nếu một bản triển khai cần đúng một Secret vật lý mà nhiều bên tiêu thụ cùng đọc, hãy biểu đạt điều đó bằng một Feature thông tin xác thực có FeatureRecipe chạy ở phạm vi ranh giới (executionScope: boundary), kết xuất một lần cho ranh giới thay vì một lần cho mỗi thành phần.

Một khóa mà cả hai đầu của kết nối đều giữ

Một máy chủ kiểm tra khóa và thành phần gọi nó đều giữ khóa đó, mỗi bên ở phía của mình. Máy chủ giữ khóa mà nó xác minh trong một slot của chính Component của nó — core/ai-model/vllm, core/ai-model/tei và core/ai-model/tgi đều khai báo api_key, cũng như mô hình và gateway LiteLLM cho khóa mà LiteLLM gọi là master key — và Recipe của nó chuyển giao bất cứ thứ gì điền vào slot dưới dạng biến mà máy chủ đọc. Bên gọi giữ khóa mà nó trình ra ở phía của mình: trên kết nối mà nó trình khóa, trong một slot do socket của nó khai báo — như socket model của core/ai-agent/crewai khai báo credential — hoặc, khi Component của nó khai báo khóa trên chính nó, trong slot đó, cho mọi kết nối mà nó tạo. Không đầu nào thấy các phần đính kèm của đầu kia: một phần đính kèm trên kết nối chỉ rơi vào bên gọi, và đầu ra được kết xuất của máy chủ vẫn như nhau bất kể các kết nối tới nó mang gì. Máy chủ không bao giờ biết bên gọi giữ khóa nào, và 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. Hai đầu khớp nhau vì Aggregate cấp cho cả hai từ cùng một tham số:

spec:
parameters:
model_key_secret: { type: string }
components:
model:
type: core/ai-model/vllm
values: { model: Qwen/Qwen2.5-0.5B-Instruct }
features:
api_key: # the key the server verifies
type: core/referenced-secret
values:
origin: "{{ .parameters.model_key_secret }}"
key: api-key
router:
type: local/gateway/model-router # its `models` socket declares a `credential` slot
uses:
models:
local:
target: model
features:
credential: # the key the caller presents
type: core/referenced-secret
values:
origin: "{{ .parameters.model_key_secret }}"
key: api-key

Đó là một secret hay hai tùy thuộc vào nơi hai đầu phân giải secret. Một provider phân giải một secret bằng tham chiếu trong một phạm vi secret: một namespace Kubernetes trên helm, một dự án Compose trên compose, cấu hình gốc của một ranh giới trên terraform, và trên cloudformation là một stack, trong tài khoản và vùng AWS mà nó triển khai vào. Khi cả hai đầu nằm trong một phạm vi, chúng tham chiếu một tài nguyên secret duy nhất. 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 kho. Manifest chọn cách hiện thực của mỗi đầu — theo loại Feature, hoặc với một phần đính kèm cụ thể là theo tên của nó, mà với phần đính kèm của một kết nối là <alias>.<slot> (local.credential ở trên). Vì một tham số cấp cho cả hai, hai cách hiện thực đọc origin như cùng một loại bộ định vị: cả hai là tên của một Secret, cả hai là khóa của một mục kho, hoặc cả hai là chính giá trị.

Trên helm với cả hai đầu trong một namespace, việc ràng buộc core/referenced-secret với helm/k8s-existing-secret và đáp ứng tham số bằng tên của một Secret mà namespace đó chứa, model-keys, khiến cả hai đầu tham chiếu nó theo tên và không kết xuất Secret nào. Container của máy chủ mang:

- name: VLLM_API_KEY
valueFrom:
secretKeyRef:
name: model-keys
key: api-key

và Recipe của router đọc cùng tên và khóa từ kết nối của nó, tại .context.uses.local.features.credential.provides. Khi hai đầu ở các namespace khác nhau, việc ràng buộc nó với helm/k8s-external-secret và đáp ứng tham số bằng khóa của một mục kho sẽ cho mỗi đầu một ExternalSecret riêng, trong namespace riêng của nó, cả hai đều lấy cùng một mục đó. Trên compose, cả hai đầu mang cùng một tham chiếu ${VAR}, được Docker Compose thay thế từ môi trường mà dự án duy nhất đó được khởi động cùng. Cách đặt này là một quy ước mà catalog của thư viện chuẩn tuân theo; trình biên dịch không so sánh gì giữa hai đầu.

Một khóa phục vụ mọi bên gọi. vLLM, TEI và TGI mỗi cái kiểm tra một khóa duy nhất, nên mọi bên gọi trình ra cùng một khóa 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, dù có bao nhiêu kết nối tới nó. Đó là giới hạn của chính máy chủ. TGI so khớp khóa của nó mà không phân biệt chữ hoa chữ thường, nên hai khóa chỉ khác nhau về chữ hoa chữ thường là một khóa đối với nó. Mô hình và gateway LiteLLM cũng chấp nhận các khóa do chính chúng cấp, trong khi cơ sở dữ liệu sổ sách của chúng được đính kèm.

Thông tin xác thực do đích sinh ra

Khi một Release không cung cấp thông tin xác thực, một thực thể catalog thường quay về một giá trị mặc định cho phát triển — một giá trị nội tuyến trong một Recipe, một giá trị mặc định trên tham số của một module. Giá trị đó giống nhau với mọi người đọc catalog, điều có thể chấp nhận cho việc đánh giá và không cho gì khác. core/random-password loại bỏ nhu cầu đó: không ai viết thông tin xác thực, vì đích sinh ra nó.

Bản build không thể là nơi tạo ra mật khẩu. Đầu ra của nó là một hàm thuần túy của đầu vào và không bao giờ mang giá trị của secret, nên một mật khẩu được rút ra lúc build sẽ thay đổi sau mỗi lần build và nằm trong các tệp được kết xuất. Thay vào đó, FeatureRecipe kết xuất một yêu cầu — một tài nguyên generator đặt tên cho tài nguyên secret mà nó điền — và đích rút ra giá trị lúc triển khai:

  • trên helm, một controller trong cụm: bộ sinh mật khẩu của External Secrets Operator, được đối soát qua một ExternalSecret, hoặc controller kubernetes-secret-generator, đối soát một StringSecret;
  • trên terraform, random_password của provider random, được rút ra khi cấu hình được áp dụng;
  • trên cloudformation, một secret Secrets Manager tự sinh chuỗi của nó khi stack tạo ra nó.

Trong mọi trường hợp, đầu ra được kết xuất đặt tên cho generator và tài nguyên secret và không mang giá trị nào. Đó là một đặc tính của những gì bản build có, không phải một lớp bảo vệ mà nó thêm vào: giá trị không bao giờ tồn tại cho đến khi đích tạo ra nó. Đích giữ nó ở đâu sau đó là việc của đích — Terraform giữ nó trong plan và state, một cụm giữ trong một Secret.

Đích cần chạy những gì. Một yêu cầu chỉ được đáp ứng ở nơi có thứ đáp ứng nó. Trên helm đó là controller, và trình biên dịch không thể kiểm tra cụm để biết có controller nào đang chạy hay không, nên các FeatureRecipes helm sẽ dừng bản build trừ khi Release khẳng định điều kiện tiên quyết bằng infra.control_plane_present: true trên phần đính kèm. Trên terraform và cloudformation, lệnh apply hoặc stack tự sinh giá trị và không cần gì chạy từ trước.

Nơi không thể dùng. Compose không chạy controller nào và không có tài nguyên nào sinh giá trị, nên không FeatureRecipe nào hiện thực core/random-password ở đó, và một bản build ràng buộc nó trên compose sẽ dừng vì thiếu FeatureRecipe như vậy. Một Release nhắm tới compose cung cấp thông tin xác thực của mình qua core/secret-value, thường dưới dạng một tham chiếu biến mà Docker Compose thay thế khi stack khởi động.

Cách bên tiêu thụ đọc nó. core/random-password công bố cùng provides.name và provides.key như core/referenced-secret, và mang cùng nhãn feature.aggrega.ai/kind: secret, nên một slot chọn họ thông tin xác thực sẽ chấp nhận nó và bên tiêu thụ đọc một thông tin xác thực được sinh ra đúng như cách đọc một thông tin xác thực đã tồn tại.

Cách nhiều bên tiêu thụ dùng chung một thông tin xác thực. Một generator rút ra giá trị mới cho mỗi yêu cầu, nên quy tắc dùng chung của phần trước áp dụng một cách khắt khe hơn: một thông tin xác thực được sinh ra, đính kèm ở một phạm vi dùng chung — hoặc trên từng bên tiêu thụ — sẽ kết xuất một yêu cầu cho mỗi bên tiêu thụ, và mỗi yêu cầu rút ra một mật khẩu khác nhau, điều mà một cơ sở dữ liệu và các client của nó không thể dùng. Một thông tin xác thực được sinh ra dùng chung bởi nhiều bên tiêu thụ được biểu đạt thành một yêu cầu và nhiều tham chiếu: core/random-password trên một thành phần, với giá trị name của nó cố định Secret mà nó điền, và core/referenced-secret trên các thành phần khác, được ràng buộc với cách hiện thực existing-Secret và trỏ tới cùng tên đó. Khi được viết từ cùng một tham số, hai thứ này không thể lệch nhau, và kết quả kết xuất mang đúng một yêu cầu mà mọi bên tiêu thụ tham chiếu.

core/random-password không phải là core/generated-secret. Feature đó trao thông tin xác thực cho một engine vốn đã sở hữu toàn bộ vòng đời của nó — một cơ sở dữ liệu được quản lý, một controller cơ sở dữ liệu — và không kết xuất gì. core/random-password kết xuất chính yêu cầu, cho một workload có Recipe mong đợi được trao một thông tin xác thực.

Thứ tự ưu tiên của phần đính kèm

Một phần đính kèm có thể được khai báo ở nhiều phạm vi cùng lúc. Quyền sở hữu một trường bị tranh chấp được giải quyết bằng ba quy tắc, áp dụng theo thứ tự này:

  1. Nguồn gốc. Một trường được viết tường minh thắng một trường do phép mở rộng dựa trên annotation đóng góp, bất kể mỗi trường đến từ phạm vi nào.
  2. Thẩm quyền kết hợp. Một khai báo trong Aggregate mà bạn đang triển khai thắng một khai báo bên trong một Aggregate mà nó kết hợp, ngay cả khi tài liệu được kết hợp đã khai báo ở phạm vi hẹp hơn.
  3. Độ cụ thể. Trong cùng một cấp soạn thảo, phạm vi hẹp hơn tinh chỉnh phạm vi rộng hơn theo từng trường: một phần điền ở cấp thành phần ghi đè một phần đính kèm cấp hệ thống con hoặc cấp ranh giới có cùng tên instance chỉ đối với các trường mà nó nêu, và các trường mà nó bỏ qua giữ giá trị của phạm vi rộng hơn.

Phía nhà phát triển cung cấp values và phía vận hành cung cấp infra, nên hai bên không bao giờ tranh chấp cùng một trường. Một Feature thông tin xác thực lấy bộ định vị từ một trong hai phía khai báo nó thành hai trường, mỗi trụ cột một trường, và chính assertion của nó từ chối một phần đính kèm mang cả hai, nên ở đó thứ tự ưu tiên cũng không có thế hòa nào cần phân xử. Thứ tự ưu tiên chỉ chi phối giá trị của các trường; nó không sắp xếp lại việc đánh giá, vốn tuân theo trình tự lan truyền theo tầng trong 10-compilation-pipeline.md.

Chart cũ đòi hỏi một chuỗi đã định dạng

Một chart đôi khi muốn một chuỗi kết nối duy nhất có nhúng dữ liệu bí mật — oracle://admin:PASSWORD@HOST:1521/DB. Một trình biên dịch ahead-of-time không thể dựng chuỗi đó từ một tọa độ kho, vì nó không bao giờ giữ dữ liệu bí mật. Hai hướng được hỗ trợ:

Tạo template phía cụm. FeatureRecipe thông tin xác thực phát ra một tài nguyên định dạng chuỗi trong cụm, dùng cơ chế template riêng của operator vault. Ứng dụng sau đó tham chiếu Secret nền tảng thu được theo tên, và trình biên dịch đã nối mối quan hệ mà không bao giờ giữ dữ liệu bí mật:

{
"apiVersion": "external-secrets.io/v1beta1",
"kind": "ExternalSecret",
"metadata": { "name": "oracle-dsn-secret" },
"spec": {
"target": {
"name": "oracle-formatted-dsn",
"template": {
"engineVersion": "v2",
"data": { "ORACLE_DSN": "oracle://admin:{{ .password }}@10.0.5.55:1521/PROD_DB" }
}
},
"data": [
{ "secretKey": "password", "remoteRef": { "key": "arn:aws:secretsmanager:prod/oracle" } }
]
}
}

Đưa tham số lên trên. Aggregate khai báo một tham số có kiểu và pipeline CI bao quanh cung cấp giá trị lúc build thông qua parameters: của Release — chẳng hạn một tệp mà pipeline ghi ra và Release nhập bằng parameters: { $import: ./ci-parameters.yaml }. Đây là lối thoát tường minh, và nó làm sự đánh đổi trở nên rõ ràng: dữ liệu bí mật giờ đi qua bản build, nên đầu ra được kết xuất mang nó và phải được xử lý tương ứng.

Phát triển cục bộ

Lộ trình chuẩn cho phát triển cục bộ giữ nguyên ý định của nhà phát triển và hoán đổi ràng buộc. Aggregate vẫn đính kèm cùng loại Feature thông tin xác thực; Manifest cục bộ ánh xạ loại đó tới một FeatureRecipe cục bộ thay vì FeatureRecipe dựa trên kho. Trình biên dịch vẫn không lấy gì — FeatureRecipe cục bộ chỉ đơn giản chuyển giao cú pháp gốc của provider mà runtime cục bộ phân giải: với Compose, một tham chiếu biến như ${SECRET_NAME} được ghi vào môi trường của dịch vụ, được Docker Compose thay thế từ môi trường shell hoặc tệp .env khi stack khởi động. Chuyển đổi môi trường là một lần chỉnh sửa Manifest.

Quản trị dữ liệu xung quanh thông tin xác thực

Aggrega không mô hình hóa lược đồ dữ liệu — hàng, cột, tệp là mối quan tâm của ứng dụng. Nó mô hình hóa danh tính quản trị của dữ liệu bằng nhãn, và quy ước của thư viện chuẩn là:

  • Dữ liệu nằm trong các thành phần có nhãn ontology đánh dấu chúng là có trạng thái hoặc giống tài nguyên (component.aggrega.ai/type: stateful-server, resource). Một message broker giữ các payload trong hàng đợi cũng là một trong số đó: nó mang stateful-server khi sở hữu ổ đĩa riêng và resource khi Release nối tới một broker được lưu trữ, và kệ messaging mà nó được duyệt dưới đó là trục riêng component.aggrega.ai/category.
  • compliance.aggrega.ai/data-class (public, internal, restricted) cho dữ liệu đó một danh tính ngữ nghĩa. Quy ước cố định khóa và các giá trị của nó, chứ không cố định thành phần nào mang nó: không Component nào của thư viện chuẩn mang nó, vì lớp dữ liệu mà một thành phần giữ là một nhận định về cách một tổ chức sử dụng thành phần đó chứ không phải một thuộc tính của sản phẩm, nên tổ chức tự khai báo nó trên các Components của mình. Đây là một nhãn bình thường: các label selector đánh giá nó, và một plugin quản trị mà bên vận hành đính kèm có thể đọc nó và từ chối một bản build. Bản thân trình biên dịch không diễn giải nó và không xếp lớp nào trên lớp nào — có những lớp nào và chúng xếp hạng ra sao là thiết lập riêng của chính sách được đính kèm, như trong ../language-reference/examples/policy-data-class-route/.

data-class và sensitive là hai trục, và gộp chúng lại sẽ làm mất thông tin. Chúng nằm cạnh nhau và dễ bị nhầm là một bề mặt, nên hãy giữ rõ sự phân biệt:

compliance.aggrega.ai/data-classsensitive
Hình dạngphân cấp — public / internal / restrictedboolean
Độ chi tiếttoàn bộ một nodemột lá lược đồ, hoặc một slot đính kèm
Nói lêndữ liệu mà một thành phần giữ có danh tính quản trị nàorằng dữ liệu này là dữ liệu bí mật, hoặc rằng điểm ràng buộc này xử lý nó
Được viết dưới dạngmột nhãn trong metadata.labelsmột từ khóa trên một khai báo

Không cái nào thay thế được cái kia: ép tính nhạy cảm vào nhãn phân cấp sẽ áp đặt một thứ tự lên một sự thật không có thứ tự, và ép một lớp dữ liệu lên một lá sẽ áp đặt một độ chi tiết mà phân loại không có. Một thực thể có thể mang cả hai, và một thành phần giữ dữ liệu restricted có slot thông tin xác thực được khai báo sensitive đang nêu hai điều đúng riêng biệt. Các từ khóa cho lá và slot được trình bày tại ../language-reference/vocabulary/compact-form-authoring.md “Khai báo một lá là nhạy cảm” và ../language-reference/entities/component.md “Khai báo một slot là nhạy cảm”.

Mã hóa dữ liệu lưu trữ được cố ý đặt ngoài ý định của nhà phát triển và ngoài trình biên dịch. Nó thuộc về Recipe của Ops cho thành phần có trạng thái, và thuộc về plugin kết xuất đọc nhãn của node và phát ra cấu hình lưu trữ được mã hóa. Cách đặt đó là hướng dẫn thiết kế về nơi mối quan tâm này thuộc về — trình biên dịch không kiểm tra xem có Recipe nào tuân thủ nó hay không.

Điều gì là đặc trưng ở đây, và điều gì không

Định vị công khai nên được nêu rõ ràng và hẹp, để người đọc có thể đánh giá đúng mức.

Đặc trưng: hợp đồng socket được công bố, không được khai báo inline. Hợp đồng mà một thông tin xác thực phải thỏa mãn — slot, danh sách cho phép phân phối của nó, bộ chọn nhãn của nó — được viết trên thực thể danh mục bởi người đã công bố thực thể đó, và nằm trong một danh mục do bên thứ ba duy trì. Bên tiêu thụ không mô tả hợp đồng inline trong cấu hình của riêng mình; nó điền vào một hợp đồng do người khác công bố, và trình biên dịch kiểm tra phần điền đó so với khai báo đã công bố. Bên tiêu thụ và tác giả hợp đồng là những người khác nhau, làm việc trong các kho mã khác nhau, theo nhịp phát hành khác nhau.

Đặc trưng: việc điền bị ràng buộc bởi bộ chọn nhãn. Một slot có thể nói loại thứ gì được phép điền vào nó (selector: "feature.aggrega.ai/kind=secret") thay vì chỉ định một triển khai cụ thể. Phép kiểm tra là một phép đánh giá tập nhãn, vì vậy một thực thể có thể chấp nhận một họ các phần điền mà nó chưa từng biết đến, và một phần điền mới trở nên hợp lệ bằng cách mang đúng các nhãn.

Không đặc trưng: ánh xạ inject. Ánh xạ “tên biến môi trường cục bộ này nhận giá trị được tạo ra kia” là một mẫu quen thuộc; nhiều công cụ cấu hình và triển khai thể hiện cùng ý tưởng đó bằng cú pháp riêng của chúng. Phiên bản của Aggrega là một ánh xạ được đánh giá trước và được hợp nhất vào một đường ống phân phối, nhưng ý tưởng thuộc về hệ sinh thái, không phải của chúng tôi.

Không đặc trưng: sinh tĩnh trước (ahead-of-time). Sinh tĩnh các tạo phẩm triển khai từ một mô tả cấp cao hơn, mà không truy cập cluster đang chạy tại thời điểm sinh, không phải là phát minh của Aggrega. Các công cụ khác làm điều đó, và đã làm trước khi Aggrega ra đời. Điều Aggrega bổ sung là lớp hợp đồng được công bố nằm phía trên, chứ không phải bản thân việc sinh tĩnh.

Không phải là ranh giới bảo mật. Không có gì trong chương này là cơ chế bảo mật thông tin. Mô hình thông tin xác thực là một mô hình đi dây: nó quyết định một con trỏ hoặc một giá trị đến từ đâu, ai có thể ràng buộc nó, và nó đến được container bằng cách nào. Bảo vệ dữ liệu bí mật là việc của kho secret, cluster và pipeline xử lý cây đã kết xuất.

Tham chiếu chéo