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.

Các dữ kiện về attachment mà một chính sách quản trị đọc

Một plugin quản trị gắn ở vai trò ir-verdict nhận toàn bộ đồ thị build, và mọi attachment Feature trong bản build đều đến cùng với nó. Mỗi attachment mang theo một tập dữ kiện cố định về chính nó: nó gọi tên Feature nào, nó lấp vị trí (slot) nào, nó được viết trên kết nối nào khi nó được viết trên một kết nối, FeatureRecipe nào hiện thực hóa nó, tác giả catalog đã khai báo gì về nó, một tác giả đã viết gì vào nó, và liệu nó có xử lý dữ liệu mà ai đó đã khai báo là nhạy cảm hay không. Có một điều không đến đúng như được viết: một giá trị mà tác giả đã khai báo là nhạy cảm sẽ đến ở dạng bị giữ lại — xem Declared-sensitive values arrive withheld (Các giá trị được khai báo nhạy cảm đến ở dạng bị giữ lại).

Trang này liệt kê các dữ kiện đó và cho biết mỗi dữ kiện khẳng định điều gì và không khẳng định điều gì. Về chính socket — bốn vai trò, các mức độ nghiêm trọng của phán quyết, kênh đầu vào của người vận hành, và hai công cụ chính sách đi kèm bên trong trình biên dịch — xem policy-socket.md. Về bảng chi tiết từng trường với kiểu dữ liệu và tính bắt buộc, xem tài liệu tham chiếu lược đồ đồ thị được sinh tự động; trang này hướng dẫn cách đọc các dữ kiện, còn trang kia là hợp đồng.

Vị trí của các attachment trong payload

Các attachment nằm trong build graph dưới feature_values_mapping, được đánh khóa theo id của node rồi theo tên instance mà tác giả đặt cho từng attachment:

input.graph.spec.feature_values_mapping[<node id>][<attachment name>]

Tên attachment mang chức năng thực sự chứ không chỉ để trang trí. Đó là khóa mà tác giả dùng để điền một slot, vì vậy đó cũng là thứ mà trình biên dịch dùng để ghép cặp với các slot đã khai báo của Component chủ.

Một attachment được viết trên một trong các kết nối của một component — dưới features: trên một mục uses, trong Aggregate hoặc trong Release — là một trong các attachment của component tiêu thụ, nên nó nằm trong cùng bucket, trên node của component tiêu thụ. Khóa của nó là tên mà trình biên dịch đặt cho nó, gồm alias của kết nối và slot nối với nhau bằng một dấu chấm: gpt.credential cho slot credential của kết nối được viết dưới alias gpt. Dấu chấm không bao giờ xuất hiện trong một tên do tác giả viết, nên khóa đó không bao giờ trùng với tên của một attachment riêng của node. Tuy nhiên, policy không đọc kết nối từ khóa: mục này mang kết nối dưới dạng dữ liệu, trong connection bên dưới.

package security
import rego.v1
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.binding == "free"
msg := sprintf("%v carries attachment %v, which fills no declared slot.", [node_id, name])
}

Chỉ ir-verdict nhìn thấy các dữ kiện này. Một policy render-verdict nhận các artifact đã render và không có graph; một policy label-transform nhận một phép chiếu các labels và giá trị của các node, với các giá trị được khai báo nhạy cảm bị giữ lại như ở đây, hoàn toàn không mang attachment nào; một policy annotation-transform nhận các component mà nó có thể chú thích. Một quy tắc đọc các dữ kiện attachment thuộc về ir-verdict, và việc chuyển nó sang một vai trò khác sẽ tạo ra một quy tắc không bao giờ kích hoạt thay vì một lỗi, vì một đường dẫn không tồn tại đơn giản là không xác định.

Một bucket, mọi họ attachment

Mọi attachment trên một node đều nằm trong cùng một bucket, bất kể Feature của nó tạo ra gì — một Feature vận hành, một Feature thông tin xác thực, một Feature danh tính. Không họ nào nhận một phép chiếu hẹp hơn họ khác, nên một policy duyệt qua bucket sẽ thấy tất cả chúng và không bao giờ phải biết mình đang xem họ nào trước khi có thể đọc một dữ kiện.

Định danh: type và resolved_version

type là URI của Feature trong catalog mà attachment chỉ định. resolved_version là phiên bản chính xác mà quá trình phân giải đã chốt cho bản build này. Cả hai luôn có mặt.

Siêu dữ liệu catalog, được mang nguyên văn: labels và catalog_annotations

labels là chính metadata.labels của thực thể Feature được gắn. catalog_annotations là chính metadata.annotations của thực thể đó. Cả hai đều được mang theo đúng thứ tự mà thực thể catalog khai báo, và không cái nào bị lọc, chuẩn hóa hay bị cắt tiền tố — một khóa trong namespace riêng của tác giả catalog đến nơi đúng như khi được viết, và trình biên dịch không đọc khóa nào trong số đó.

Chính việc mang nguyên văn đó cho phép một chính sách dựa trên một nhãn mà trình biên dịch không có lý do gì để biết là tồn tại. Một tác giả catalog đánh dấu các Features thông tin xác thực bằng một nhãn do chính họ đặt ra có thể viết một quy tắc nhắm trực tiếp vào nhãn đó.

Mỗi trường vắng mặt khỏi attachment khi Feature không khai báo gì, và khi type của nó không phân giải ra thực thể catalog nào.

catalog_annotations mô tả thực thể mà phần gắn kèm nêu tên. Đó là một câu hỏi khác với annotation_key và annotation_source ở dưới, vốn mô tả phần gắn kèm đã ra đời như thế nào. Một phần gắn kèm được viết trong một khối features: mang các annotation của catalog trong khi không mang cái nào trong hai cái còn lại.

Attachment lấp đầy slot nào: binding

binding có ba câu trả lời, và câu trả lời thứ ba không phải là một biến thể của câu thứ hai:

Giá trịÝ nghĩa
một tên slotAttachment lấp đầy slot attachment đã khai báo có tên đó.
freeAttachment không lấp đầy slot đã khai báo nào. Đây là một kết luận khẳng định: tập slot đã được phân giải và không có slot đã khai báo nào mang tên này.
vắng mặtKhông thể phân giải tập slot đã khai báo của Component chủ, nên không biết slot nào được lấp đầy.

Tên đó đến từ tập slot đã khai báo nào phụ thuộc vào nơi attachment được viết. Một attachment thuộc khối riêng của node lấp đầy một slot mà Component chủ khai báo trong featuresSchema của chính nó. Một attachment được viết trên một kết nối — attachment mang connection bên dưới — lấp đầy một slot mà socket của kết nối khai báo, trong featuresSchema của socket đó trên Component chủ. Vì vậy cùng một giá trị, credential, chỉ một slot của Component trên attachment này và một slot của một socket trên attachment khác, và connection là thứ phân biệt hai trường hợp.

Việc ghép cặp dựa theo tên — một attachment lấp đầy một slot khi Feature được gắn dưới tên của slot, trên khối của component hoặc trên kết nối — nên giá trị là một khóa chính xác lấy từ tập slot đã khai báo. Không có gì được đọc ra từ khóa của attachment: attachment của một kết nối có khóa gpt.credential và báo cáo credential. Tên slot được mang theo thay vì một cờ đơn thuần vì slot nào được lấp đầy là nửa hữu ích hơn của câu trả lời.

Một attachment được viết trên một kết nối không bao giờ báo cáo free. Các slot của một socket là những tên duy nhất mà một kết nối đi qua socket đó có thể mang, và một kết nối mang bất kỳ tên nào khác sẽ bị từ chối khi bản build được nạp, nên mọi attachment như vậy trong một đồ thị đến được một policy đều lấp đầy một slot đã khai báo.

Một policy coi binding vắng mặt là free sẽ báo cáo một điều chưa biết như một kết luận. Hãy kiểm tra free một cách tường minh.

Attachment được viết trên kết nối nào: connection

connection có mặt trên mọi attachment được viết trên một trong các kết nối của node, và vắng mặt trên mọi attachment thuộc khối riêng của node. Nó mang hai trường, là tọa độ của kết nối đó trên node:

TrườngÝ nghĩa
socketSocket mà kết nối được nối qua.
aliasAlias mà kết nối được viết dưới tên đó.

Cặp này chỉ định một cạnh của đồ thị: cạnh có source là node mang attachment và có socket cùng alias là các giá trị này. target của cạnh đó là component mà attachment được trình cho. Nhờ vậy một policy nối một attachment với thứ mà nó chạm tới — điều mà không fact nào trên riêng attachment có thể nói được, vì attachment nằm trên node tiêu thụ:

package security
import rego.v1
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.labels["feature.aggrega.ai/kind"] == "secret"
some edge in input.graph.spec.edges
edge.source == node_id
edge.socket == attachment.connection.socket
edge.alias == attachment.connection.alias
input.graph.spec.nodes[edge.target].labels["example.com/trust-zone"] == "external"
msg := sprintf("%v presents the credential %v to %v, outside the trust zone.", [node_id, name, edge.target])
}

Những gì connection khẳng định, và những gì nó không khẳng định:

  • Nó ghi lại nơi tác giả đã viết attachment. Nó được điền từ kết nối mà attachment được viết trên đó, không bao giờ được phân tích từ khóa của attachment, nên nó giữ socket — thứ mà khóa không mang — cũng như alias.
  • Nó không mang slot. Slot nào của socket mà attachment lấp đầy là binding, được đọc theo cùng cách như với mọi attachment; slot được báo cáo một lần, ở đó.
  • Nó không mô tả target. Target, các nhãn của nó, và ai đã nối cạnh — nhà phát triển, Release, hay một Feature — là các fact của cạnh và node target, được đọc ở đó sau khi nối.
  • Một kết nối do Feature vẽ không mang attachment nào, nên không attachment nào mang một connection chỉ định cạnh như vậy. Một credential mà kết nối riêng của một Feature cần là một attachment lấp đầy một slot mà Feature khai báo, và nó không mang connection.
  • Vắng mặt nghĩa là khối riêng của node. Một attachment không có connection đã được viết trên features: riêng của component (hoặc tới được đó từ một phạm vi rộng hơn hoặc qua việc mở rộng dựa trên annotation). Đó không phải là phát hiện rằng attachment không được trình cho component nào khác: credential riêng của một component chạm tới đâu được quyết định bởi cách việc phân phối của nó được nối, điều mà trường này không mô tả.

Ngoài việc quyết định tập slot đã khai báo nào mà binding và nửa slot của sensitive được đọc từ đó, connection không thay đổi gì ở attachment: FeatureRecipe của nó, hợp đồng provides của nó, các fact còn lại và vị trí của nó trong bucket đều giống như của bất kỳ attachment nào mà node mang.

FeatureRecipe nào hiện thực hóa phần gắn kèm: realization

realization nêu tên FeatureRecipe mà Manifest của Release gắn với phần gắn kèm, dưới dạng <name>:<version>. Manifest gắn theo chính tên của phần gắn kèm khi tầng name của nó ánh xạ tên đó — với một phần gắn kèm được viết trên một kết nối, đó là tên đầy đủ của nó, gpt.credential ở trên — và nếu không thì theo kiểu Feature mà phần gắn kèm nêu tên. FeatureRecipe được nêu tên chính là FeatureRecipe mà một lần build cùng các tài liệu đó dùng để render phần gắn kèm: đồ thị ghi lại việc gắn trước khi bất cứ thứ gì được render, và quá trình render gắn phần gắn kèm theo cùng một cách.

package security
import rego.v1
approved_realizations := {"approved-credential:1.0.0"}
deny contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
attachment.labels["feature.aggrega.ai/kind"] == "secret"
realization := attachment.realization
not realization in approved_realizations
msg := sprintf("%v realizes the credential %v with %v, which is not an approved FeatureRecipe.",
[node_id, name, realization])
}

Những gì realization khẳng định, và những gì nó không khẳng định:

  • Đó là cùng một cặp ở mọi nơi nó xuất hiện. aggrega inspect in nó ra như realization của phần gắn kèm, và khi một target đóng dấu provenance lên những gì nó render, các tài liệu mà FeatureRecipe đó render mang nó làm giá trị aggrega.ai/recipe-uri của chúng, nên một policy nối một phần gắn kèm với những gì nó render mà không cần chuyển đổi giữa các dạng.
  • Nó nêu tên FeatureRecipe theo tên và phiên bản, không theo capability. Hai capability có thể mỗi bên công bố một FeatureRecipe dưới cùng một tên và phiên bản. Cái nào trong số đó được gắn là do ánh xạ của Manifest quyết định, ánh xạ này nêu tên capability ở bất cứ chỗ nào chỉ riêng tên sẽ gây mơ hồ; trường này không nhắc lại điều đó.
  • Các phần gắn kèm của chính một ranh giới Release cũng mang nó, dưới boundary_features, được đọc theo cùng một cách. Một phần gắn kèm ở cấp ranh giới cũng đến được từng component mà ranh giới chứa, và mang cùng realization ở đó.
  • Vắng mặt nghĩa là không được gắn với gì cả. Một phần gắn kèm mà Manifest không gắn với FeatureRecipe nào có trong catalog thì không mang realization. Một lần build của thành phần như vậy dừng lại trước khi render, nêu tên phần gắn kèm chưa được ánh xạ — nhưng một policy ở vai trò này được hỏi trước lần dừng đó, nên nó có thể gặp một phần gắn kèm không mang giá trị nào. Quy tắc ở trên bỏ qua phần gắn kèm như vậy, vì phần thân của nó gắn realization trước tiên; một quy tắc muốn báo cáo nó thì kiểm tra tường minh khóa bị thiếu.

Attachment ra đời như thế nào: origin và hai trường đi kèm

origin phân biệt một attachment do nhà phát triển gõ vào với một attachment do quá trình mở rộng dựa trên annotation tạo ra:

Giá trịÝ nghĩa
explicitĐược viết trong một khối features:.
annotationĐược tạo ra bởi quá trình mở rộng dựa trên annotation.
mixedCác lá value hoặc infra của attachment mang cả hai loại lẫn nhau; chi tiết theo từng lá nằm trong các bản đồ provenance.

annotation_key nêu tên annotation đã kích hoạt một attachment tổng hợp, và annotation_source chỉ vị trí khai báo của nó dưới dạng <release-file-path>:<dotted-yaml-key-path>. Cả hai đều vắng mặt khi origin là explicit.

Các payload do tác giả viết: values, infra và inject

values là cấu hình vận hành của attachment — lĩnh vực của nhà phát triển. infra là kích thước vật lý theo từng instance của nó — lĩnh vực của người vận hành. inject là định tuyến injection không phụ thuộc vào nội dung, ánh xạ các khóa phân phối tới các khóa provides mà chúng lấy giá trị từ đó, được đánh khóa trước tiên theo cơ chế phân phối.

Nội dung mà values của một attachment thông tin xác thực mang theo là do tác giả lựa chọn, và trình biên dịch mang theo bất kỳ thứ gì đã được viết mà không phân giải cái nào: một thông tin xác thực theo tham chiếu mang một con trỏ vào kho bí mật, còn một thông tin xác thực theo giá trị mang chính dữ liệu đó. Dù là loại nào, một leaf mà Feature được gắn khai báo là nhạy cảm sẽ đến với policy ở dạng bị giữ lại, như phần tiếp theo mô tả; một leaf mà nó không khai báo, chẳng hạn một locator được công bố, sẽ đến đúng như đã viết.

Các giá trị được khai báo là nhạy cảm đến nơi ở dạng bị giữ lại

Mọi lá mà đồ thị đánh dấu là được khai báo nhạy cảm đều đến socket này dưới dạng một marker bị giữ lại thay vì giá trị mà tác giả đã viết. Marker là một đối tượng một khóa mang lý do giá trị vắng mặt:

{ "aggrega_withheld": "declared" }

declared nghĩa là có một khai báo bao phủ lá đó. Một payload hoàn toàn không thể đọc được sẽ bị giữ lại toàn bộ, với lý do unreadable, vì không lá nào bên trong nó có thể được đánh giá.

Việc giữ lại tuân theo chính các đánh dấu của đồ thị, nên nó chạm tới đúng những lá mà các đánh dấu đó nêu tên, dù chúng nằm ở đâu:

  • values và infra của mọi attachment, bất kể phạm vi nào đã viết nó — khối riêng của component, một subsystem, một boundary hay Release, một mở rộng do annotation điều khiển — và bất kể nó được viết trên khối riêng của node hay trên một trong các kết nối của node, theo các lá mà sensitive_payload_leaves của nó nêu tên;
  • infra của một attachment cấp boundary, dưới boundary_features, theo đánh dấu riêng của nó;
  • values và infra riêng của một node, dưới values_mapping và infra_mapping, theo sensitive_payload_leaves riêng của node;
  • values và infra riêng của một kết nối, trên cạnh và trong mục uses của node tiêu thụ, theo sensitive_payload_leaves của cạnh, vốn nêu tên các lá mà socket của component tiêu thụ khai báo là nhạy cảm.

Những gì một policy dựa vào để suy luận vẫn còn nguyên vẹn. Kiểu, phiên bản đã phân giải, các label, các catalog annotation, binding, connection, realization, origin và các bản đồ nguồn gốc của nó, cả ba dữ kiện về độ nhạy cảm, và mọi lá không có khai báo nào đánh dấu đều đến đúng như được viết. Khóa của một lá bị giữ lại cũng được giữ nguyên, nên một policy vẫn thấy một payload mang những lá nào và lá nào trong số đó mang dữ liệu được khai báo — chỉ giá trị là vắng mặt. Vì vậy, một quy tắc về nơi dữ liệu được khai báo nhạy cảm di chuyển tới, và theo đường nào, hoàn toàn có thể biểu đạt được; một quy tắc về nội dung của dữ liệu thì không, theo thiết kế.

Khối uses do tác giả viết của một node, được mang trên node bên cạnh các cạnh của nó, giữ mỗi attachment được viết trên một kết nối ở mức type và description của nó. Các giá trị của attachment chỉ được mang một lần, trên chính attachment, nơi việc giữ lại chạm tới chúng.

Một policy muốn phân biệt một lá bị giữ lại với một lá do tác giả viết sẽ kiểm tra khóa của marker:

package security
import rego.v1
audit contains msg if {
some node_id, attachments in input.graph.spec.feature_values_mapping
some name, attachment in attachments
some key, value in attachment.values
is_object(value)
value.aggrega_withheld
msg := sprintf("%v/%v writes a declared-sensitive value at values.%v.", [node_id, name, key])
}

Đây chính là việc giữ lại mà --ir-graph áp dụng khi một lệnh in ra đồ thị và aggrega/irGraph của daemon áp dụng khi nó trả lời một client, nên một policy và một người đọc đồ thị thấy cùng những lá bị giữ lại. Các bề mặt đó trả lại giá trị cho người yêu cầu chúng bằng --unredacted; payload mà một policy nhận không có yêu cầu như vậy, và các giá trị được khai báo riêng của một node bị giữ lại khỏi nó theo cùng điều kiện như của một attachment. Nó áp dụng cho payload mà một policy nhận và không cho gì khác: đồ thị mà bản build render từ đó không bị động đến, nên việc giữ lại không thay đổi byte được render nào. Không có gì bị giữ lại khỏi những gì một policy render-verdict nhận, vì các artifact đã render chính là thứ mà vai trò đó đánh giá.

Mỗi lá đến từ đâu: values_provenance và infra_provenance

Mỗi bản đồ được đánh khóa theo đường dẫn lá có dấu chấm bên trong trụ cột của nó, và mỗi mục ghi lại origin của lá đó — cùng sự phân biệt explicit / annotation, áp dụng cho từng lá một. Một lá do annotation đóng góp còn mang thêm bề mặt soạn thảo nơi nó được khai báo, khóa annotation đã đóng góp nó và vị trí nguồn của khai báo đó. Ở nơi một lá explicit ghi đè lên một lá do annotation đóng góp, mục đó còn mang theo phần đóng góp bị loại bỏ mà nó đã thay thế, để một policy có thể thấy cái gì đã bị ghi đè chứ không chỉ cái gì đã thắng.

Ba đơn vị độ nhạy cảm

Payload mang ba dữ kiện về độ nhạy cảm, và chúng nằm ở ba đơn vị khác nhau: toàn bộ một attachment, một khóa phân phối, một lá payload.

Mỗi dữ kiện được tính từ đầu vào riêng của nó. Không dữ kiện nào được suy ra từ dữ kiện khác, và đặc biệt câu trả lời theo từng attachment không bao giờ được lan xuống các đơn vị hẹp hơn. Gộp lẫn bất kỳ hai dữ kiện nào sẽ tạo ra một policy sai theo hướng thất bại một cách lặng lẽ, vì vậy nên đọc riêng từng dữ kiện trước khi viết một quy tắc dựa trên bất kỳ dữ kiện nào trong số đó.

Mỗi dữ kiện đều được suy ra từ những gì tác giả đã khai báo — sensitive: true trên một lá schema của Feature, hoặc sensitive: true trên một khe attachment mà một Component khai báo, cho các attachment của chính nó hoặc trên một trong các socket của nó. Không có nội dung giá trị nào được kiểm tra, và không có ý nghĩa nào được đọc ra từ tên của một trường.

sensitive — một câu trả lời cho toàn bộ attachment

Có giá trị true khi hoặc Feature được gắn khai báo một lá nhạy cảm trong values, infra hoặc provides, hoặc khe mà attachment lấp đầy khai báo rằng bất cứ thứ gì gắn vào nó đều xử lý dữ liệu bí mật — khe attachment cùng tên của Component chủ, hoặc, với một attachment mang connection, khe cùng tên mà socket của kết nối đó khai báo. Không được đặt khi không có khai báo nào trong hai khai báo trên.

Dữ kiện này trả lời thực thể là gì, nên nó cố ý không thay đổi theo những gì một tác giả cụ thể đã viết. Nó đọc các khai báo của Feature thay vì tập con các lá nhạy cảm mà attachment này tình cờ lấp đầy, bởi vì một trường nhạy cảm trong Release này nhưng không nhạy cảm trong Release khác sẽ trở nên vô dụng đối với một policy suy luận về thực thể catalog.

Hai nửa này độc lập, và mỗi nửa tự đứng vững. Một Feature hoàn toàn không khai báo lá nhạy cảm nào vẫn gắn vào một khe nhạy cảm như một attachment nhạy cảm, vì khe đã nói như vậy. Một phần lấp đầy khai báo một lá nhạy cảm là một attachment nhạy cảm ngay cả khi khe không có khai báo như vậy, và ngay cả khi đó là một attachment tự do không gắn vào khe nào.

sensitive_inject — một câu trả lời cho mỗi khóa phân phối

Tập con của inject mà khóa provides được tham chiếu của nó được Feature được gắn khai báo là nhạy cảm, mang theo đúng hình dạng của inject: cơ chế, rồi đến khóa phân phối, với khóa provides được tham chiếu làm giá trị.

Một khóa phân phối lấy giá trị từ một khóa provides mà Feature đã đánh dấu nhạy cảm sẽ xuất hiện ở đây; khóa lấy giá trị từ một khóa không được đánh dấu thì không, ngay cả trên cùng attachment và cùng cơ chế. Vắng mặt khi attachment không khai báo cơ chế phân phối nào, hoặc không tham chiếu khóa provides nhạy cảm nào.

sensitive_payload_leaves — một câu trả lời cho mỗi lá payload

Các lá mà payload của attachment này mang có đường dẫn được Feature được gắn khai báo là nhạy cảm, mỗi lá dưới dạng đường dẫn phân tách bằng dấu chấm có tiền tố pillar mà dữ liệu chiếm giữ: values.<path> hoặc infra.<path>.

Payload được đọc ở đây là payload mà attachment cuối cùng mang, không phải khối mà tác giả đã viết. Một lá nằm ở giá trị mà schema của Feature khai báo là default được nêu tên cùng với lá mà tác giả đã viết tại đó: một giá trị mặc định được lấp đầy là một dữ liệu mà payload mang, và một đánh dấu chỉ đọc từ khối được viết sẽ bỏ sót không nêu tên nó.

Một lá xuất hiện khi một đường dẫn mà schema của Feature khai báo là nhạy cảm bao phủ nó — khai báo nêu tên lá đó, hoặc nêu tên một object chứa nó. Việc so khớp chạy theo từng đoạn trên đường dẫn phân tách bằng dấu chấm, nên một khai báo tại db bao phủ db.password và không chạm tới một lá anh em có tên dbPassword. Không có gì được đọc ra từ chính văn bản của đường dẫn và không giá trị nào được kiểm tra — việc tác giả viết chính dữ liệu đó tại một lá được đánh dấu hay viết một con trỏ tới nó là điều không thể biết ở đây và không phải là điều mà đánh dấu khẳng định.

Phép so sánh chạy trên payload đã được làm phẳng thành các lá, không phải trên các khóa cấp cao nhất của pillar, nên một lá lồng trong một map lồng nhau được so sánh như mọi lá khác.

Các lá đến theo thứ tự mà payload lưu giữ chúng, các lá của pillar values trước các lá của pillar infra — cùng thứ tự mà chính các payload mang, và đó là điều giữ cho dữ liệu truyền đi giống hệt nhau từng byte giữa các lần chạy với đầu vào giống nhau.

Đơn vị này trả lời attachment này đặt dữ liệu ở đâu, điều tất yếu thay đổi theo từng Release. Đó là lý do nó giao với những gì đã được viết trong khi sensitive thì không: hai dữ kiện là câu trả lời cho những câu hỏi khác nhau, và áp dụng quy tắc của bên này cho trường bên kia sẽ làm hỏng nó.

Đọc cả ba cùng nhau

Một tác giả gắn một Feature thông tin xác thực khai báo lá values literalPassword và khóa provides password của nó là nhạy cảm, lấp đầy một khe credentials đã được khai báo, và viết một mật khẩu dạng literal trực tiếp:

{
"type": "example/db-credential",
"resolved_version": "1.0.0",
"binding": "credentials",
"values": {
"secretName": "db-creds",
"literalPassword": { "aggrega_withheld": "declared" }
},
"inject": {
"env": { "DATABASE_PASSWORD": "password" }
},
"sensitive": true,
"sensitive_inject": {
"env": { "DATABASE_PASSWORD": "password" }
},
"sensitive_payload_leaves": ["values.literalPassword"]
}

Ba câu hỏi khác nhau, ba câu trả lời khác nhau. Attachment có xử lý dữ liệu được khai báo nhạy cảm hay không (sensitive). Khóa môi trường DATABASE_PASSWORD là một khóa mang dữ liệu đó (sensitive_inject). Và payload của attachment này mang một giá trị cụ thể tại values.literalPassword (sensitive_payload_leaves) — trong khi values.secretName, một bộ định vị mà Feature cố ý để không đánh dấu, vắng mặt trong danh sách đó dù payload cũng mang nó. Mật khẩu mà tác giả viết đến dưới dạng bị giữ lại, trong khi bộ định vị bên cạnh đến đúng như đã viết: đánh dấu cho policy biết rằng có một giá trị ở đó, còn bản thân giá trị thì không bao giờ đến được policy.

Một quy tắc từ chối bí mật dạng literal trong một artifact đã render cần dữ kiện thứ ba. Một quy tắc yêu cầu mọi attachment xử lý thông tin xác thực phải mang một nhãn sở hữu cần dữ kiện thứ nhất. Thay cái này bằng cái kia sẽ thay đổi những bản build nào bị dừng.

Vắng mặt không có nghĩa là cho phép

Một lá chỉ được liệt kê khi có một khai báo bao phủ nó. Vì vậy, một sensitive_payload_leaves vắng mặt cho biết rằng attachment này không nêu tên lá nào mà Feature của nó khai báo là nhạy cảm — không bao giờ cho biết rằng payload không nhạy cảm. Nó cũng không phân biệt một attachment không có lá nào như vậy để nêu tên với một producer hoàn toàn không báo cáo trục này: hai trường hợp đó vẫn không thể phân biệt, và người đọc một khóa vắng mặt chỉ biết được điều đó và không gì hơn.

Một guest đọc danh sách lá vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị ở dạng rõ đã đọc ngược ý nghĩa của đánh dấu.

Khóa bị lược bỏ hoàn toàn khỏi dữ liệu truyền đi khi nó rỗng, nên một attachment mà Feature và khe của nó không khai báo gì sẽ mang đúng những byte mà nó sẽ mang nếu đánh dấu không tồn tại. Chính sự lược bỏ đó khiến việc đọc sai trở nên dễ dàng, và đó là lý do nên nói rõ hướng ý nghĩa này.

Trường hợp rõ nhất là một attachment nhạy cảm nhưng hoàn toàn không liệt kê lá nào. Lấy attachment ở trên và thay đổi hai điều — tác giả chỉ viết bộ định vị, để trống lá được khai báo nhạy cảm, và lấy giá trị cho khóa môi trường từ khóa provides name không được đánh dấu của Feature thay vì password:

{
"type": "example/db-credential",
"resolved_version": "1.0.0",
"binding": "credentials",
"values": { "secretName": "db-creds" },
"inject": {
"env": { "DATABASE_PASSWORD": "name" }
},
"sensitive": true
}

sensitive vẫn là true — các khai báo của Feature không thay đổi — trong khi cả hai đơn vị hẹp hơn đều biến mất. Attachment vẫn xử lý dữ liệu bí mật; chỉ là nó không làm vậy thông qua một lá hay một khóa phân phối mà attachment này mang. Một policy dựa trên giá trị tổng hợp sẽ từ chối bản build này, còn một policy dựa trên đánh dấu theo từng lá sẽ cho nó đi qua. Cả hai đều là quy tắc có thể biện minh được, và policy cần quy tắc nào là quyết định mà tác giả policy đưa ra một cách có chủ đích.

Sự bất đối xứng tương tự cũng diễn ra theo chiều ngược lại với sensitive_inject: một attachment có thể viết một lá nhạy cảm trong khi không định tuyến gì nhạy cảm qua khóa phân phối nào, hoặc định tuyến một khóa provides nhạy cảm trong khi hoàn toàn không viết giá trị nào.

Những gì một khai báo nhạy cảm không làm

Việc đánh dấu chỉ mang tính chú thích; nó không phải là một cơ chế kiểm soát. Khai báo một lá hoặc một slot là nhạy cảm không mã hóa bất cứ thứ gì, không xác thực hay từ chối một giá trị, và không bắt buộc một cơ chế phân phối. Không có kết quả build nào thay đổi chỉ vì có mặt một khai báo.

Trên hầu hết các target, nó cũng không thay đổi byte nào được render: một giá trị được khai báo nhạy cảm mà tác giả cung cấp inline được render y hệt như một giá trị không được khai báo. Terraform là ngoại lệ trong số các target của thư viện chuẩn, vì nó có sẵn một primitive nhạy cảm gốc theo từng giá trị để khai báo áp vào — xem providers/terraform.md “Declared-sensitive module inputs”. Một target không có khái niệm nhạy cảm riêng thì không có gì để một khai báo thay đổi.

Điều các khai báo làm ở mọi nơi là khiến sự thật đó trở nên dễ đọc — đối với đầu ra debug của chính trình biên dịch, và đối với một policy tại socket này, nơi quyết định phải làm gì với nó. Biến một dấu đánh thành một kết quả build là việc của policy, và đó là lý do socket này tồn tại. Và một policy được cho biết về dữ liệu được khai báo nhạy cảm mà không được trao chính dữ liệu đó: dấu đánh được gửi đến, còn giá trị được gửi đến trong trạng thái bị giữ lại.

Tham chiếu chéo

  • policy-socket.md — socket quản trị: bốn vai trò, các mức độ nghiêm trọng của phán quyết, kênh đầu vào của người vận hành, các policy engine đi kèm bên trong trình biên dịch, và việc gắn một plugin vào một workspace.
  • plugin-contract.md — vị trí của socket trong pipeline và các dạng dữ liệu truyền có kiểu của nó.
  • tài liệu tham chiếu lược đồ đồ thị — hợp đồng từng trường cho đồ thị build, bao gồm mọi trường trên một attachment.
  • entities/component.md “Attachment Slots” — khai báo một slot, và khai báo một slot là nhạy cảm; cùng với featuresSchema mà một socket khai báo cho các kết nối được nối qua nó.
  • entities/aggregate.md “A connection’s own attachments” — viết một attachment trên một kết nối, và tên mà nó nhận.
  • vocabulary/compact-form-authoring.md “Declaring a leaf sensitive” — từ khóa sensitive: và giới hạn của những gì việc khai báo nó đạt được.
  • vocabulary/labels-and-annotations.md — các bề mặt label và annotation mà một policy đọc.