거버넌스 정책이 읽는 attachment 사실
ir-verdict 역할에 연결된 거버넌스 플러그인은 빌드 그래프 전체를 받으며, 빌드의 모든 Feature attachment가 함께 전달됩니다. 각 attachment는 자신에 관한 고정된 사실 집합을 가집니다. 어떤 Feature를 지정하는지, 어떤 슬롯을 채우는지, 연결 위에 작성된 경우 어떤 연결 위에 작성되었는지, 어떤 FeatureRecipe가 이를 실현하는지, 카탈로그 작성자가 이에 대해 무엇을 선언했는지, 작성자가 무엇을 기록했는지, 그리고 누군가 민감하다고 선언한 자료를 다루는지 여부입니다. 한 가지는 작성된 그대로 전달되지 않습니다. 작성자가 민감하다고 선언한 값은 보류된 상태로 전달됩니다. Declared-sensitive values arrive withheld(민감하다고 선언된 값은 보류된 상태로 전달됩니다)를 참조하십시오.
이 페이지는 이러한 사실을 열거하고 각 사실이 무엇을 주장하고 무엇을 주장하지 않는지 설명합니다.
소켓 자체, 즉 네 가지 역할, 판정 심각도,
운영자 입력 채널, 그리고 컴파일러에 포함되어 제공되는 두 정책 엔진에 대해서는
policy-socket.md를 참조하십시오. 타입과 필수 여부를 포함한
필드별 표는 생성된
그래프 스키마 참조를 참조하십시오. 이 페이지는 사실을 읽는 방법을
설명하며, 그 페이지가 계약입니다.
페이로드에서 attachment가 놓이는 위치
attachment는 빌드 그래프의 feature_values_mapping 아래에 놓이며, 노드 id를 키로, 그다음에는 작성자가 각 attachment에 부여한 인스턴스 이름을 키로 합니다.
input.graph.spec.feature_values_mapping[<node id>][<attachment name>]attachment 이름은 장식이 아니라 실질적인 역할을 합니다. 이 이름은 작성자가 슬롯을 채울 때 사용하는 키이므로, 컴파일러가 호스트 Component의 선언된 슬롯과 짝지을 때 사용하는 것이기도 합니다.
컴포넌트의 연결 중 하나에 작성된 attachment는 — Aggregate나 Release에서 uses 항목의 features: 아래에 작성된 것으로 — 소비하는 컴포넌트의 attachment 중 하나이므로, 소비하는 컴포넌트의 노드에서 같은 버킷에 놓입니다. 그 키는 컴파일러가 부여하는 이름으로, 연결의 별칭과 슬롯을 점으로 이은 것입니다. 예를 들어 별칭 gpt로 작성된 연결의 credential 슬롯이라면 gpt.credential입니다. 점은 작성자가 쓰는 이름에 절대 나타나지 않으므로, 이 키는 노드 자체의 attachment 이름과 결코 같아지지 않습니다. 다만 정책은 키에서 연결을 읽어내지 않습니다. 항목은 연결을 아래의 connection에 데이터로 담고 있습니다.
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])}이 사실은 ir-verdict만 볼 수 있습니다. render-verdict 정책은 렌더링된 아티팩트를 받으며 그래프는 받지 않습니다. label-transform 정책은 노드의 레이블과 값의 투영을 받는데, 여기서 민감하다고 선언된 값은 이곳과 같이 보류되며 attachment는 전혀 포함되지 않습니다. annotation-transform 정책은 자신이 어노테이션할 수 있는 컴포넌트를 받습니다. attachment 사실을 읽는 규칙은 ir-verdict에 속하며, 이를 다른 역할로 옮기면 오류가 아니라 절대 발동하지 않는 규칙이 됩니다. 존재하지 않는 경로는 단순히 정의되지 않은 것으로 처리되기 때문입니다.
하나의 버킷, 모든 첨부 계열
노드의 모든 첨부는 그 Feature가 무엇을 생성하든 — 운영 Feature, 자격 증명 Feature, ID Feature — 같은 버킷에 놓입니다. 어떤 계열도 다른 계열보다 좁은 투영을 받지 않으므로, 버킷을 순회하는 정책은 모든 계열을 보며, 사실을 읽기 전에 자신이 어떤 계열을 보고 있는지 알 필요가 없습니다.
식별 정보: type과 resolved_version
type은 attachment가 지정하는 카탈로그 Feature의 URI입니다.
resolved_version은 이 빌드에서 버전 해석이 최종적으로 결정한 정확한 버전입니다.
두 값은 항상 존재합니다.
그대로 전달되는 카탈로그 메타데이터: labels와 catalog_annotations
labels는 첨부된 Feature 엔터티 자체의 metadata.labels입니다.
catalog_annotations는 그 엔터티 자체의 metadata.annotations입니다. 둘 다
카탈로그 엔터티가 선언한 순서대로 전달되며, 어느 쪽도 필터링되거나
정규화되거나 접두사가 제거되지 않습니다. 카탈로그 작성자 고유의 네임스페이스에 있는 키는
작성된 그대로 도착하며, 컴파일러는 그중 어느 것도 읽지 않습니다.
이렇게 그대로 전달되기 때문에, 컴파일러가 존재를 알 이유가 없는 레이블을 키로 하여 정책을 작성할 수 있습니다. 자격 증명 Features에 직접 고안한 레이블을 표시하는 카탈로그 작성자는 그 레이블을 대상으로 규칙을 직접 작성할 수 있습니다.
Feature가 아무것도 선언하지 않은 경우와 그 type이 어떤 카탈로그 엔터티로도 해석되지 않는 경우에는 각각 attachment에 나타나지 않습니다.
catalog_annotations는 첨부가 가리키는 엔터티를 설명합니다. 이는
아래의 annotation_key 및 annotation_source와는 다른 질문으로, 이 둘은
첨부가 어떻게 생겨났는지를 설명합니다.
features: 블록에 작성된 첨부는 카탈로그 어노테이션을 전달하지만
나머지 두 가지는 어느 것도 전달하지 않습니다.
첨부가 채우는 슬롯: binding
binding에는 세 가지 값이 있으며, 세 번째 값은 두 번째 값의 변형이 아닙니다:
| 값 | 의미 |
|---|---|
| 슬롯 이름 | 첨부가 해당 이름으로 선언된 첨부 슬롯을 채웁니다. |
free | 첨부가 선언된 어떤 슬롯도 채우지 않습니다. 이는 확정된 판정입니다. 슬롯 집합이 해석되었고, 선언된 슬롯 중 이 이름을 가진 것이 없습니다. |
| 없음 | 호스트 Component의 선언된 슬롯 집합을 해석할 수 없었으므로, 어느 슬롯이 채워지는지 알 수 없습니다. |
이름이 어느 선언된 슬롯 집합에서 오는지는 첨부가 작성된 위치에 따라 달라집니다. 노드 자체 블록의 첨부는 호스트 Component가 자신의 featuresSchema에 선언한 슬롯을 채웁니다. 연결에 작성된 첨부, 즉 아래의 connection을 가진 첨부는 연결의 소켓이 선언한 슬롯을 채우며, 이 슬롯은 호스트 Component에 있는 해당 소켓의 featuresSchema에 선언됩니다. 따라서 같은 값 credential이 어떤 첨부에서는 Component의 슬롯을, 다른 첨부에서는 소켓의 슬롯을 가리키며, 둘을 구분해 주는 것이 connection입니다.
짝짓기는 이름으로 이루어집니다. Feature가 컴포넌트의 블록이나 연결에서 슬롯의 이름으로 첨부되면 첨부가 그 슬롯을 채우므로, 값은 선언된 슬롯 집합의 키와 정확히 일치합니다. 첨부의 키에서는 아무것도 읽지 않습니다. 연결의 첨부는 키가 gpt.credential이고 보고되는 값은 credential입니다. 단순한 플래그 대신 슬롯 이름을 담는 이유는 어느 슬롯이 채워졌는지가 답에서 더 유용한 절반이기 때문입니다.
연결에 작성된 첨부는 결코 free를 보고하지 않습니다. 소켓의 슬롯은 그 소켓을 통한 연결이 가질 수 있는 유일한 이름이며, 다른 이름을 가진 연결은 빌드를 로드할 때 거부됩니다. 따라서 정책에 도달하는 그래프에서 그러한 첨부는 모두 선언된 슬롯을 채웁니다.
binding이 없는 것을 free로 취급하는 정책은 알 수 없는 상태를 판정 결과로 보고하게 됩니다. free인지 명시적으로 검사하십시오.
첨부가 작성된 연결: connection
connection은 노드의 연결 중 하나에 작성된 모든 첨부에 존재하며,
노드 자체 블록의 모든 첨부에는 없습니다. 이 값은 노드에서 해당 연결의
좌표인 두 필드를 담습니다.
| 필드 | 의미 |
|---|---|
socket | 연결이 배선되는 소켓입니다. |
alias | 연결이 작성된 별칭입니다. |
이 쌍은 그래프의 엣지 하나를 가리킵니다. 즉 source가 첨부를 담은 노드이고
socket과 alias가 이 값들인 엣지입니다. 그 엣지의 target은 첨부가
제공되는 컴포넌트입니다. 따라서 정책은 첨부를 그것이 도달하는 대상과 조인합니다.
첨부는 소비하는 노드에 위치하므로, 첨부 자체의 어떤 사실도 이것을 알려 줄 수 없습니다.
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])}connection이 주장하는 것과 주장하지 않는 것:
- 작성자가 첨부를 작성한 위치를 기록합니다. 이 값은 첨부가 작성된 연결로부터 채워지며 첨부의 키에서 파싱되는 일은 없으므로, 별칭뿐 아니라 키에 담기지 않는 소켓도 담습니다.
- 슬롯은 담지 않습니다. 첨부가 소켓의 어느 슬롯을 채우는지는
binding이며, 다른 모든 첨부와 같은 방식으로 읽습니다. 슬롯은 그곳에서 한 번만 보고됩니다. - 대상을 설명하지 않습니다. 대상, 그 레이블, 그리고 엣지를 누가 배선했는지, 즉 개발자인지, Release인지, Feature인지는 엣지와 대상 노드의 사실이며, 조인 후 그곳에서 읽습니다.
- Feature가 그리는 연결은 첨부를 담지 않으므로, 그러한 엣지를 가리키는
connection을 담은 첨부는 없습니다. Feature 자체의 연결에 필요한 자격 증명은 Feature가 선언하는 슬롯을 채우는 첨부이며,connection을 담지 않습니다. - 없으면 노드 자체 블록을 의미합니다.
connection이 없는 첨부는 컴포넌트 자체의features:에 작성되었습니다(또는 더 넓은 범위에서, 혹은 어노테이션 기반 확장으로 그곳에 도달했습니다). 이는 첨부가 다른 어떤 컴포넌트에도 제공되지 않는다는 발견이 아닙니다. 컴포넌트 자체의 자격 증명이 무엇에 도달하는지는 전달이 어떻게 배선되는지에 따라 결정되며, 이 필드는 그것을 설명하지 않습니다.
binding과 sensitive의 슬롯 부분을 어느 선언된 슬롯 집합에서 읽을지
결정하는 것 외에, connection은 첨부에 대해 아무것도 바꾸지 않습니다.
첨부의 FeatureRecipe, provides 계약, 나머지 사실, 버킷 내 위치는
노드가 담는 다른 모든 첨부와 같습니다.
어떤 FeatureRecipe가 attachment를 실현하는가: realization
realization은 Release의 Manifest가 attachment에 바인딩하는 FeatureRecipe를 <name>:<version> 형식으로 명명합니다. Manifest는 name 계층이 attachment의 이름을 매핑하는 경우 그 attachment 자체의 이름으로 바인딩하며(connection에 작성된 attachment라면 그 정규화된 이름, 위의 예에서는 gpt.credential), 그렇지 않으면 attachment가 명명하는 Feature 타입으로 바인딩합니다. 명명된 FeatureRecipe는 동일한 문서를 빌드할 때 attachment를 렌더링하는 데 쓰이는 바로 그 FeatureRecipe입니다. 그래프는 렌더링이 시작되기 전에 바인딩을 기록하고, 렌더링은 attachment를 같은 방식으로 바인딩합니다.
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])}realization이 나타내는 것과 나타내지 않는 것:
- 나타나는 모든 곳에서 동일한 쌍입니다.
aggrega inspect는 이를 attachment의 realization으로 출력하며, 타깃이 렌더링 결과에 출처 정보를 기록하는 경우 해당 FeatureRecipe가 렌더링하는 문서는 이를aggrega.ai/recipe-uri값으로 지닙니다. 따라서 정책은 형식을 변환하지 않고도 attachment를 그 렌더링 결과와 결합할 수 있습니다. - FeatureRecipe를 capability가 아니라 이름과 버전으로 명명합니다. 두 capability가 각각 같은 이름과 버전으로 FeatureRecipe를 게시할 수 있습니다. 그중 어느 것이 바인딩되는지는 Manifest의 매핑이 결정하며, 이 매핑은 이름만으로 모호해지는 곳마다 capability를 명명합니다. 이 필드는 그것을 다시 기술하지 않습니다.
- Release 경계 자체의 attachment도 이를 지닙니다.
boundary_features아래에 있으며 같은 방식으로 읽습니다. 경계 수준의 attachment는 경계가 포함하는 각 component에도 도달하며, 그곳에서도 같은 realization을 지닙니다. - 없으면 아무것에도 바인딩되지 않았다는 뜻입니다. Manifest가 카탈로그에 있는 어떤 FeatureRecipe에도 바인딩하지 않는 attachment는
realization을 지니지 않습니다. 그러한 구성의 빌드는 렌더링 전에 매핑되지 않은 attachment를 명시하며 중단됩니다. 그러나 이 역할의 정책은 그 중단 전에 호출되므로, realization이 없는 attachment를 만날 수 있습니다. 위의 규칙은 본문이 먼저realization을 바인딩하므로 그러한 attachment를 건너뜁니다. 이를 보고하려는 규칙은 키가 없는지를 명시적으로 검사합니다.
attachment가 생겨난 경위: origin과 두 동반 필드
origin은 개발자가 직접 입력한 attachment와 어노테이션 기반 확장이 생성한 attachment를
구별합니다.
| 값 | 의미 |
|---|---|
explicit | features: 블록에서 작성되었습니다. |
annotation | 어노테이션 기반 확장으로 생성되었습니다. |
mixed | attachment의 value 리프나 infra 리프에 두 가지가 섞여 있습니다. 리프별 세부 정보는 provenance 맵에 있습니다. |
annotation_key는 합성 attachment를 트리거한 어노테이션의 이름이며, annotation_source는 그 선언의 위치를 <release-file-path>:<dotted-yaml-key-path> 형식으로 나타냅니다. origin이 explicit이면 둘 다 없습니다.
작성된 페이로드: values, infra, inject
values는 attachment의 운영 구성으로, 개발자의 영역입니다. infra는 인스턴스별 물리적 사이징으로, 운영자의 영역입니다. inject
는 전달 메커니즘을 첫 번째 키로 하여 전달 키를 그 값을 채우는 provides 키에
매핑하는, 구애받지 않는 주입 라우팅입니다.
자격 증명 attachment의 values에 무엇을 담을지는 작성자가 선택하며,
컴파일러는 어느 쪽이든 해석하지 않고 작성된 그대로 전달합니다. 참조 방식의
자격 증명은 시크릿 저장소를 가리키는 포인터를 담고, 값 방식의 자격 증명은
자격 증명 자료 자체를 담습니다. 어느 쪽이든, 연결된 Feature가 민감하다고 선언한
리프는 다음 절에서 설명하듯 보류된 상태로 정책에 도달하며, 공개된 로케이터처럼
선언되지 않은 리프는 작성된 그대로 도착합니다.
민감하다고 선언된 값은 보류된 상태로 도착합니다
그래프가 민감하다고 선언된 것으로 표시한 모든 리프는 작성자가 쓴 값이 아니라 보류 마커로 이 소켓에 도착합니다. 마커는 값이 없는 이유를 담은 단일 키 객체입니다.
{ "aggrega_withheld": "declared" }declared는 선언이 해당 리프를 포함한다는 뜻입니다. 전혀 읽을 수 없는 페이로드는
그 안의 어떤 리프도 판단할 수 없으므로 unreadable 이유와 함께 통째로 보류됩니다.
보류는 그래프 자체의 표시를 따르므로, 표시가 지정한 리프가 어디에 있든 정확히 그 리프에만 적용됩니다.
- 모든 첨부의
values와infra: 어떤 스코프가 작성했든( 컴포넌트 자체 블록, 서브시스템, 경계 또는 Release, 어노테이션 기반 확장), 그리고 노드 자체 블록에 작성되었든 그 연결 중 하나에 작성되었든, 해당sensitive_payload_leaves가 지정하는 리프에 적용됩니다. - 경계 수준 첨부의
infra:boundary_features아래에서, 자체 표시에 따라 적용됩니다. - 노드 자체의
values와infra:values_mapping과infra_mapping아래에서, 노드 자체의sensitive_payload_leaves에 따라 적용됩니다; - 커넥션 자체의
values와infra: 엣지 위와 소비하는 노드의uses항목 안에서, 엣지의sensitive_payload_leaves에 따라 적용되며, 이것은 소비하는 컴포넌트의 소켓이 민감하다고 선언한 리프를 명시합니다.
정책이 추론하는 대상은 온전히 유지됩니다. 타입, 해석된 버전, 레이블, 카탈로그 어노테이션, binding, connection, realization, origin과 그 출처 맵, 세 가지 민감도 사실 전부, 그리고 어떤 선언도 표시하지 않은 모든 리프는 작성된 그대로 도착합니다. 보류된 리프의 키도 유지되므로 정책은 페이로드가 어떤 리프를 담고 있는지, 그중 어떤 리프가 선언된 자료를 담고 있는지 여전히 볼 수 있으며, 값만 없습니다. 따라서 민감하다고 선언된 자료가 어디로, 어떤 경로로 이동하는지에 관한 규칙은 완전히 표현할 수 있지만, 자료의 내용에 관한 규칙은 설계상 표현할 수 없습니다.
노드의 엣지 옆에 실려 있는, 노드에 작성된 uses 블록은
연결에 작성된 각 첨부를 해당 type과 description으로만 유지합니다.
첨부의 값은 첨부 자체에 한 번만 실리며, 그곳에서
보류가 적용됩니다.
보류된 리프와 작성된 리프를 구분하려는 정책은 마커의 키를 검사합니다.
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])}이것은 명령이 그래프를 출력할 때 --ir-graph가 적용하고, 데몬의 aggrega/irGraph가
클라이언트에 응답할 때 적용하는 것과 같은 보류이므로,
정책과 그래프를 읽는 사람은 같은 리프가 보류된 것을 봅니다. 이러한
인터페이스는 --unredacted로 요청하는 사람에게 값을 반환하지만,
정책이 받는 페이로드에는 그러한 요청이 없으며, 노드 자체의 선언된
값도 첨부의 값과 같은 조건으로 정책에서 보류됩니다. 보류는
정책이 받는 페이로드에만 적용되고 그 밖의 어떤 것에도 적용되지 않습니다.
빌드가 렌더링에 사용하는 그래프는 그대로이므로 보류로 인해 렌더링된 바이트는
하나도 바뀌지 않습니다. render-verdict 정책이 받는 것에서는 아무것도
보류되지 않습니다. 그 역할이 판단하는 대상이 렌더링된 아티팩트이기 때문입니다.
각 리프의 출처: values_provenance와 infra_provenance
각각은 해당 필러 안의 점으로 구분된 리프 경로를 키로 하며, 각 항목은 그 리프의 origin을 기록합니다. 이는 동일한 explicit / annotation 구분을 리프 하나씩 적용한 것입니다. 어노테이션이 기여한 리프는 추가로 그것이 선언된 작성 표면, 그것을 기여한 어노테이션 키, 그리고 그 선언의 소스 위치를 함께 전달합니다. 명시적 리프가 어노테이션이 기여한 리프를 덮어쓴 경우, 항목은 그것이 대체한 억제된 기여도 함께 전달하므로, 정책은 무엇이 이겼는지뿐 아니라 무엇이 재정의되었는지도 확인할 수 있습니다.
세 가지 민감도 단위
페이로드는 세 가지 민감도 사실을 담으며, 이들은 서로 다른 세 단위에 놓입니다. 첨부 하나 전체, 전달 키 하나, 페이로드 리프 하나입니다.
각각은 자체 입력으로부터 계산됩니다. 어느 것도 다른 것에서 파생되지 않으며, 특히 첨부 단위의 답은 더 좁은 단위로 결코 퍼져 내려가지 않습니다. 이 중 둘을 혼동하면 조용히 실패하는 방향으로 잘못된 정책이 만들어지므로, 이들 중 어느 것에 대해 규칙을 작성하기 전에 세 가지를 따로 읽어 둘 가치가 있습니다.
이들 모두는 작성자가 선언한 것에서 파생됩니다. 즉 Feature의 스키마 리프에 있는 sensitive: true, 또는 Component가 자신의 첨부용이나 자신의 소켓 중 하나에 선언하는 첨부 슬롯의 sensitive: true입니다. 어떤 값의 내용도 검사하지 않으며, 필드 이름에서 어떤 의미도 읽어 내지 않습니다.
sensitive — 첨부 전체에 대한 하나의 답
첨부된 Feature가 자신의 values, infra 또는 provides에 민감한 리프를 선언하거나, 첨부가 채우는 슬롯이 그것에 바인딩되는 것은 무엇이든 비밀 자료를 다룬다고 선언할 때 참입니다. 이 슬롯은 호스트 Component의 같은 이름의 첨부 슬롯이며, connection을 지닌 첨부의 경우에는 연결의 소켓이 선언하는 그 이름의 슬롯입니다. 두 선언이 모두 없으면 설정되지 않습니다.
이 값은 엔터티가 무엇인지에 답하므로, 특정 작성자가 작성한 내용에 따라 달라지지 않도록 의도적으로 설계되었습니다. 이 첨부가 우연히 채운 민감한 리프의 부분 집합이 아니라 Feature의 선언을 읽는데, 한 Release에서는 민감하고 다른 Release에서는 민감하지 않은 필드는 카탈로그 엔터티에 대해 추론하는 정책에게 쓸모가 없기 때문입니다.
두 부분은 서로 독립적이며, 각각 단독으로 성립합니다. 민감한 리프를 전혀 선언하지 않는 Feature라도 민감한 슬롯에 바인딩되면 민감한 첨부가 되는데, 슬롯이 그렇게 선언했기 때문입니다. 민감한 리프를 선언하는 채움은 슬롯이 그런 선언을 하지 않았더라도, 그리고 어떤 슬롯에도 바인딩되지 않는 자유 첨부이더라도 민감한 첨부입니다.
sensitive_inject — 전달 키마다 하나의 답
참조하는 provides 키를 첨부된 Feature가 민감하다고 선언한 inject의 부분 집합으로, inject 자체의 형태로 담깁니다. 즉 메커니즘, 그다음 전달 키이며, 값은 참조된 provides 키입니다.
Feature가 민감하다고 표시한 provides 키에서 채워지는 전달 키는 여기에 나타납니다. 표시되지 않은 키에서 채워지는 전달 키는 같은 첨부, 같은 메커니즘이라도 나타나지 않습니다. 첨부가 전달 메커니즘을 선언하지 않거나 민감한 provides 키를 참조하지 않으면 존재하지 않습니다.
sensitive_payload_leaves — 페이로드 리프마다 하나의 답
이 첨부의 페이로드가 담고 있는 리프 중 첨부된 Feature가 그 경로를 민감하다고 선언한 리프들로, 각각 해당 데이터가 차지하는 필러 접두사가 붙은 점 표기 경로, 즉 values.<path> 또는 infra.<path>로 표시됩니다.
여기서 읽는 페이로드는 작성자가 작성한 블록이 아니라 첨부가 최종적으로 담게 되는 페이로드입니다. Feature의 스키마가 default로 선언한 값에 놓인 리프는 작성자가 값을 작성한 리프와 함께 이름이 붙습니다. 채워진 기본값은 페이로드가 담는 데이터이며, 작성된 블록만으로 읽어 낸 표시는 그것을 이름 없이 남겨 두게 되기 때문입니다.
리프는 Feature의 스키마가 민감하다고 선언한 경로가 그것을 포함하는 곳에 나타납니다. 즉 선언이 그 리프를 지정하거나, 그것을 포함하는 객체를 지정하는 경우입니다. 매칭은 점 표기 경로에 대해 세그먼트 단위로 이루어지므로, db에 대한 선언은 db.password를 포함하지만 dbPassword라는 이름의 형제 리프에는 미치지 않습니다. 경로 자체의 텍스트에서 아무것도 읽어 내지 않으며 어떤 값도 검사하지 않습니다. 작성자가 표시된 리프에 자료 자체를 작성했는지 아니면 그것에 대한 포인터를 작성했는지는 여기서 알 수 없으며, 표시가 주장하는 바도 아닙니다.
비교는 필러의 최상위 키가 아니라 리프 단위로 평탄화된 페이로드에 대해 이루어지므로, 중첩된 맵 안에 중첩된 리프도 다른 리프와 똑같이 비교됩니다.
리프는 페이로드가 담고 있는 순서대로, values 필러의 리프가 infra 필러의 리프보다 먼저 도착합니다. 이는 페이로드 자체가 담는 순서와 같으며, 동일한 입력에 대한 실행 간에 와이어를 바이트 단위로 동일하게 유지하는 것이 바로 이 순서입니다.
이 단위는 이 첨부가 데이터를 어디에 두었는지에 답하며, 이는 필연적으로 Release마다 달라집니다. 그래서 이 단위는 작성된 내용과 교차하는 반면 sensitive는 그렇지 않습니다. 두 값은 서로 다른 질문에 대한 답이며, 어느 한쪽의 규칙을 다른 필드에 적용하면 그 필드가 망가집니다.
세 가지를 함께 읽기
작성자가 자신의 literalPassword values 리프와 password provides 키를 민감하다고 선언하는 자격 증명 Feature를 첨부하여, 선언된 credentials 슬롯을 채우고, 리터럴 비밀번호를 인라인으로 작성하는 경우입니다.
{ "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"]}세 가지 다른 질문에 세 가지 다른 답입니다. 첨부는 어쨌든 민감하다고 선언된 자료를 다룹니다(sensitive). DATABASE_PASSWORD 환경 키는 그 자료를 전달하는 키입니다(sensitive_inject). 그리고 이 첨부의 페이로드는 구체적으로 values.literalPassword에 값을 담고 있습니다(sensitive_payload_leaves). 반면 Feature가 의도적으로 표시하지 않은 위치 지정자인 values.secretName은 페이로드가 그것도 담고 있지만 그 목록에는 없습니다. 작성자가 작성한 비밀번호는 보류된 채 도착하고, 그 옆의 위치 지정자는 작성된 그대로 도착합니다. 표시는 정책에게 값이 거기 있다는 것을 알려 주며, 값 자체는 정책에 결코 도달하지 않습니다.
렌더링된 아티팩트에 리터럴 비밀이 있는 것을 거부하는 규칙에는 세 번째가 필요합니다. 자격 증명을 다루는 모든 첨부에 소유권 레이블을 요구하는 규칙에는 첫 번째가 필요합니다. 하나를 다른 것으로 대체하면 어떤 빌드가 중단되는지가 달라집니다.
부재는 허가가 아닙니다
리프는 선언이 그것을 포함하는 곳에서만 나열됩니다. 따라서 sensitive_payload_leaves가 없다는 것은 이 첨부가 자신의 Feature가 민감하다고 선언한 리프를 하나도 지정하지 않는다는 뜻이며, 결코 페이로드가 민감하지 않다는 뜻이 아닙니다. 또한 지정할 그런 리프가 없는 첨부와 이 축을 아예 보고하지 않는 생산자를 구별하지도 않습니다. 이 둘은 구별할 수 없는 상태로 남으며, 없는 키를 읽는 쪽은 그 사실만 알 수 있을 뿐 그 이상은 알 수 없습니다.
리프 목록이 없는 것을 값을 평문으로 표시하거나 내보내도 된다는 허가로 읽는 게스트는 표시를 거꾸로 읽은 것입니다.
키가 비어 있게 될 때는 와이어에서 완전히 생략되므로, Feature와 슬롯이 아무것도 선언하지 않는 첨부는 표시가 존재하지 않았을 때 담았을 바이트와 정확히 같은 바이트를 담습니다. 이 생략 때문에 잘못 읽기 쉬우며, 그래서 방향을 분명히 밝혀 둘 가치가 있습니다.
가장 분명한 경우는 민감하면서도 리프를 하나도 나열하지 않는 첨부입니다. 위의 첨부에서 두 가지를 바꿔 보겠습니다. 작성자가 위치 지정자만 작성하고 민감하다고 선언된 리프는 채우지 않으며, 환경 키를 password 대신 Feature의 표시되지 않은 name provides 키에서 채웁니다.
{ "type": "example/db-credential", "resolved_version": "1.0.0", "binding": "credentials", "values": { "secretName": "db-creds" }, "inject": { "env": { "DATABASE_PASSWORD": "name" } }, "sensitive": true}sensitive는 여전히 참입니다. Feature의 선언이 바뀌지 않았기 때문입니다. 반면 더 좁은 두 단위는 모두 사라집니다. 첨부는 여전히 비밀 자료를 다루지만, 이 첨부가 담는 리프나 전달 키를 통해 다루지 않을 뿐입니다. 집계 값을 기준으로 하는 정책은 이 빌드를 거부하고, 리프별 표시를 기준으로 하는 정책은 통과시킵니다. 둘 다 타당한 규칙이며, 정책이 어느 쪽을 원하는지는 정책 작성자가 의도적으로 내리는 결정입니다.
sensitive_inject에 대해서도 같은 비대칭이 반대 방향으로 작용합니다. 첨부는 전달 키를 통해 민감한 것을 전혀 라우팅하지 않으면서 민감한 리프를 작성할 수도 있고, 값을 전혀 작성하지 않으면서 민감한 provides 키를 라우팅할 수도 있습니다.
민감도 선언이 하지 않는 일
표시는 주석을 달 뿐이며 통제 수단이 아닙니다. 리프나 슬롯을 민감하다고 선언해도 아무것도 암호화되지 않고, 값을 검증하거나 거부하지 않으며, 전달 메커니즘을 강제하지도 않습니다. 선언이 있다는 이유로 바뀌는 빌드 결과는 없습니다.
대부분의 대상에서는 렌더링되는 바이트도 전혀 바뀌지 않습니다. 작성자가 인라인으로 제공한 민감 선언 값은 선언되지 않은 값과 정확히 똑같이 렌더링됩니다. 표준 라이브러리 대상 가운데 Terraform은
예외인데, 선언이 적용될 값 단위의 기본 민감도 프리미티브를 갖추고 있기 때문입니다.
providers/terraform.md의 “Declared-sensitive module
inputs”를 참조하십시오. 자체 민감도 개념이 없는 대상에서는 선언이 바꿀 것이 없습니다.
선언이 모든 곳에서 하는 일은 그 사실을 읽을 수 있게 만드는 것입니다. 컴파일러 자체의 디버그 출력과, 그 사실을 어떻게 처리할지 결정하는 이 소켓의 정책에 대해서입니다. 표시를 빌드 결과로 바꾸는 것은 정책의 일이며, 이 소켓은 바로 그 일을 위해 존재합니다. 그리고 정책은 민감 선언된 자료를 건네받지 않고도 그 자료에 대해 전달받습니다. 표시는 도착하고, 값은 보류된 채 도착합니다.
상호 참조
policy-socket.md— 거버넌스 소켓: 네 가지 역할, 판정 심각도, 운영자 입력 채널, 컴파일러에 포함되어 제공되는 정책 엔진, 그리고 워크스페이스에 플러그인을 연결하는 방법.plugin-contract.md— 소켓의 파이프라인 내 위치 및 타입이 지정된 와이어 형태.- 그래프 스키마 레퍼런스 — 빌드 그래프에 대한 필드별 계약으로, 어태치먼트의 모든 필드를 포함합니다.
entities/component.md“Attachment Slots” — 슬롯 선언과 슬롯을 민감한 것으로 선언하는 방법, 그리고 소켓이 자신을 통해 연결되는 커넥션에 대해 선언하는featuresSchema.entities/aggregate.md“A connection’s own attachments” — 커넥션에 어태치먼트를 작성하는 방법과 그 어태치먼트가 갖는 이름.vocabulary/compact-form-authoring.md“Declaring a leaf sensitive” —sensitive:키워드와 이를 선언해서 얻을 수 있는 효과의 한계.vocabulary/labels-and-annotations.md— 정책이 읽는 레이블 및 어노테이션 영역.