Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Факти про приєднання, які читає політика керування

Плагін керування, приєднаний у ролі ir-verdict, отримує весь граф збирання, і разом із ним надходить кожне приєднання сутності Feature у збиранні. Кожне приєднання несе фіксований набір фактів про себе: яку сутність Feature воно називає, який слот заповнює, на якому з’єднанні його записано, якщо його записано на з’єднанні, яка сутність FeatureRecipe його реалізує, що про нього оголосив автор каталогу, що в нього записав автор і чи обробляє воно матеріал, який хтось оголосив чутливим. Одне надходить не таким, як його записано: значення, яке автор оголосив чутливим, надходить приховним — див. Значення, оголошені чутливими, надходять приховними.

Ця сторінка перелічує ці факти й пояснює, що кожен із них стверджує, а чого не стверджує. Про сам сокет — чотири ролі, рівні серйозності вердиктів, канал вхідних даних оператора та два рушії політик, що постачаються в складі компілятора, — див. policy-socket.md. Таблицю поле за полем із типами та обов’язковістю див. у згенерованому довіднику схеми графа; ця сторінка вчить читати факти, а та сторінка є контрактом.

Де розміщуються прикріплення в корисному навантаженні

Прикріплення розміщуються в графі збірки під feature_values_mapping, з ключем за ідентифікатором вузла, а потім за іменем екземпляра, яке автор дав кожному прикріпленню:

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

Ім’я прикріплення несе змістове навантаження, а не є декоративним. Це ключ, за яким автор заповнює слот, тому саме його компілятор зіставляє з оголошеними слотами сутності Component, що є хостом.

Прикріплення, записане на одному зі з’єднань компонента — під features: у записі uses, у сутності Aggregate або в сутності Release, — є одним із прикріплень компонента-споживача, тому воно розміщується в тому самому кошику, на вузлі компонента-споживача. Його ключ — це ім’я, яке дає йому компілятор: псевдонім з’єднання і слот, з’єднані крапкою: gpt.credential для слота credential з’єднання, записаного під псевдонімом gpt. Крапка ніколи не з’являється в імені, яке пише автор, тому такий ключ ніколи не збігається з іменем жодного з власних прикріплень вузла. Утім, політика не зчитує з’єднання з ключа: запис містить його як дані, у 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 отримує проєкцію міток і значень вузлів, у якій оголошені чутливими значення приховано так само, як тут, і яка взагалі не містить прикріплень; політика annotation-transform отримує компоненти, які вона може анотувати. Правило, яке зчитує факти прикріплень, належить до ir-verdict, а перенесення його до іншої ролі дає правило, яке ніколи не спрацьовує, а не помилку, бо шлях, якого немає, просто не визначений.

Один кошик, усі родини вкладень

Кожне вкладення на вузлі розміщується в тому самому кошику, незалежно від того, що створює його Feature, — операційна Feature, Feature облікових даних чи Feature ідентичності. Жодна родина не отримує вужчої проєкції, ніж інша, тож політика, яка обходить кошик, бачить їх усі й ніколи не мусить знати, на яку родину вона дивиться, перш ніж зможе прочитати факт.

Ідентичність: type і resolved_version

type — це URI каталожної сутності Feature, яку називає прикріплення. resolved_version — це точна версія, на якій зупинилося розв’язання для цієї збірки. Обидва поля присутні завжди.

Метадані каталогу, передані дослівно: labels і catalog_annotations

labels — це власні metadata.labels приєднаної сутності Feature. catalog_annotations — це власні metadata.annotations тієї ж сутності. Обидва передаються в тому порядку, у якому їх оголошує сутність каталогу, і жоден не фільтрується, не нормалізується й не позбавляється префікса — ключ у власному просторі імен автора каталогу надходить точно так, як його записано, і компілятор не читає жодного з них.

Саме ця дослівна передача дає змогу будувати політику на мітці, про існування якої компілятор не має жодних причин знати. Автор каталогу, який позначає сутності Features облікових даних власноруч вигаданою міткою, може написати правило безпосередньо щодо цієї мітки.

Кожне з них відсутнє в приєднанні, коли сутність Feature не оголошує жодного, а також коли її type не вказує на жодну сутність каталогу.

catalog_annotations описує сутність, яку називає приєднання. Це інше питання, ніж annotation_key і annotation_source нижче, які описують те, як приєднання виникло. Приєднання, записане в блоці features:, містить анотації каталогу, але не містить жодного з двох інших.

Який слот заповнює прикріплення: binding

binding має три відповіді, і третя не є варіантом другої:

ЗначенняЗначення
ім’я слотаПрикріплення заповнює оголошений слот прикріплення з цим ім’ям.
freeПрикріплення не заповнює жодного оголошеного слота. Це позитивний висновок: набір слотів було визначено, і жоден оголошений слот не має цього імені.
відсутнєОголошений набір слотів хостової сутності Component не вдалося визначити, тож невідомо, який слот заповнено.

З якого оголошеного набору слотів походить ім’я, залежить від того, де написано прикріплення. Прикріплення з власного блоку вузла заповнює слот, який хостова сутність Component оголошує у власному featuresSchema. Прикріплення, написане на з’єднанні — тобто таке, що має connection (див. нижче), — заповнює слот, який оголошує сокет з’єднання, у featuresSchema цього сокета на хостовій сутності Component. Тож одне й те саме значення, 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 реалізує прикріплення: realization

realization називає FeatureRecipe, який Manifest сутності Release прив’язує до прикріплення, у формі <name>:<version>. Manifest прив’язує за власним ім’ям прикріплення, якщо його рівень name зіставляє це ім’я (для прикріплення, записаного на з’єднанні, — за його кваліфікованим ім’ям, gpt.credential вище), а інакше — за типом Feature, який називає прикріплення. Названий FeatureRecipe — це той, з яким збірка тих самих документів рендерить прикріплення: граф фіксує прив’язку до будь-якого рендерингу, а рендеринг прив’язує прикріплення так само.

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 виводить її як реалізацію прикріплення, а там, де ціль позначає походження на тому, що рендерить, документи, які рендерить цей FeatureRecipe, містять її як значення aggrega.ai/recipe-uri, тож політика пов’язує прикріплення з тим, що воно рендерить, без перетворення між формами.
  • Воно називає FeatureRecipe за ім’ям і версією, а не за можливістю. Дві можливості можуть кожна публікувати FeatureRecipe під одним ім’ям і версією. Яку з них прив’язано, визначає зіставлення в Manifest, яке називає можливість усюди, де саме ім’я було б неоднозначним; це поле його не повторює.
  • Власні прикріплення межі сутності Release також його містять, у boundary_features, і читаються так само. Прикріплення рівня межі також досягає кожного компонента, який містить межа, і має там ту саму реалізацію.
  • Відсутність означає, що прив’язки немає. Прикріплення, яке Manifest не прив’язує до жодного FeatureRecipe з каталогу, не містить realization. Збірка такої композиції зупиняється до рендерингу, називаючи незіставлене прикріплення, — але політику на цій ролі запитують до цієї зупинки, тож вона може зустріти прикріплення без нього. Наведене вище правило пропускає таке прикріплення, бо його тіло спершу зв’язує realization; правило, яке має повідомити про нього, явно перевіряє відсутній ключ.

Як виникло прикріплення: origin і два супутні поля

origin відрізняє прикріплення, яке ввів розробник, від прикріплення, створеного розгортанням на основі анотацій:

ЗначенняЗначення
explicitЗадано в блоці features:.
annotationСтворено розгортанням на основі анотацій.
mixedЛистки значень або infra цього прикріплення містять суміш обох; подробиці для кожного листка — у картах походження.

annotation_key називає анотацію, яка спричинила синтетичне прикріплення, а annotation_source вказує місце її оголошення у форматі <release-file-path>:<dotted-yaml-key-path>. Обидва поля відсутні, коли origin має значення explicit.

Авторські корисні навантаження: values, infra і inject

values — це операційна конфігурація прикріплення, сфера розробника. infra — його фізичне розмірювання для кожного екземпляра, сфера оператора. inject є агностичною маршрутизацією ін’єкції, що зіставляє ключі доставки з ключами provides, з яких вони заповнюються, і впорядкована спершу за механізмом доставки.

Що містить 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, застосоване до одного листа за раз. Лист, внесений анотацією, додатково несе поверхню авторингу, на якій його оголошено, ключ анотації, що його вніс, і розташування цього оголошення у вихідному коді. Там, де явний лист перезаписав лист, внесений анотацією, запис також несе пригнічений внесок, який він замінив, тож політика бачить, що саме було перевизначено, а не лише те, що переважило.

Три одиниці чутливості

Корисне навантаження містить три факти чутливості, і вони стосуються трьох різних одиниць: одного цілого прикріплення, одного ключа доставки, одного листка навантаження.

Кожен обчислюється з власних вхідних даних. Жоден не виводиться з іншого, і, зокрема, відповідь для прикріплення ніколи не поширюється на вужчі одиниці. Змішування будь-яких двох із них дає політику, яка помиляється непомітно, тому варто розібратися з кожним окремо, перш ніж писати правило для будь-якого з них.

Кожен із них виводиться з того, що автор задекларував, — sensitive: true на листку схеми сутності Feature або sensitive: true на слоті прикріплення, який декларує сутність Component для власних прикріплень або на одному зі своїх сокетів. Вміст жодного значення не перевіряється, і з назви поля не виводиться жодного змісту.

sensitive — одна відповідь для всього прикріплення

Істина, коли або прикріплена сутність Feature декларує чутливий листок у своїх values, infra чи provides, або слот, який заповнює прикріплення, декларує, що все, що його прив’язує, обробляє секретний матеріал, — слот прикріплення хостової сутності Component з тією самою назвою або, для прикріплення з connection, слот із цією назвою, який декларує сокет з’єднання. Не встановлено, коли жодної з цих декларацій немає.

Це відповідає на питання чим є сутність, тому навмисно не залежить від того, що написав конкретний автор. Він читає декларації сутності Feature, а не підмножину чутливих листків, яку випадково заповнило це прикріплення, бо поле, чутливе в одному Release й нечутливе в іншому, було б непридатним для політики, що міркує про сутність каталогу.

Дві половини незалежні, і кожна діє сама по собі. Сутність Feature, яка не декларує жодного чутливого листка, все одно прив’язує чутливий слот як чутливе прикріплення, бо так сказав слот. Заповнення, що декларує чутливий листок, є чутливим прикріпленням, навіть коли слот не робив такої декларації, і навіть коли це вільне прикріплення, що не прив’язує жодного слота.

sensitive_inject — одна відповідь на ключ доставки

Підмножина inject, чий ключ provides, на який вона посилається, прикріплена сутність Feature декларує чутливим, у власній формі inject: механізм, потім ключ доставки, а значенням є ключ provides, на який посилаються.

Ключ доставки, що заповнюється з ключа provides, який сутність Feature позначила чутливим, з’являється тут; ключ, що заповнюється з непозначеного ключа, — ні, навіть у тому самому прикріпленні й тому самому механізмі. Відсутнє, коли прикріплення не декларує жодного механізму доставки або не посилається на жоден чутливий ключ provides.

sensitive_payload_leaves — одна відповідь на листок навантаження

Листки, які містить корисне навантаження цього прикріплення, чий шлях прикріплена сутність Feature декларує чутливим, кожен у вигляді шляху через крапку з префіксом стовпа, який займає дане: values.<path> або infra.<path>.

Тут читається те навантаження, яке зрештою містить прикріплення, а не блок, який написав автор. Листок зі значенням, яке схема сутності Feature декларує як default, називається поряд із тим, який написав автор: заповнене типове значення — це дане, яке містить навантаження, а позначення, прочитане лише з написаного блоку, залишило б його неназваним.

Листок з’являється там, де шлях, який схема сутності Feature декларує чутливим, охоплює його, — декларація називає цей листок або об’єкт, що його містить. Зіставлення виконується посегментно за шляхом через крапку, тож декларація на db охоплює db.password і не сягає сусіднього листка з назвою dbPassword. Із тексту самого шляху нічого не виводиться, і жодне значення не перевіряється: чи написав автор на позначеному листку сам матеріал, чи вказівник на нього, тут дізнатися неможливо, і позначення цього не стверджує.

Порівняння виконується над навантаженням, розгорнутим до листків, а не над ключами верхнього рівня стовпа, тож листок, вкладений у вкладену мапу, порівнюється як будь-який інший.

Листки надходять у тому порядку, у якому їх містить навантаження, листки стовпа values перед листками стовпа infra, — у тому самому порядку, що й самі навантаження, і саме це зберігає побайтову ідентичність передачі між запусками з ідентичними вхідними даними.

Ця одиниця відповідає на питання куди це прикріплення поклало дані, що неминуче різниться від одного Release до іншого. Ось чому вона перетинається з написаним, а sensitive ні: це відповіді на різні питання, і застосування будь-якого з цих правил до іншого поля зламало б його.

Читання трьох разом

Автор прикріплює сутність Feature для облікових даних, яка декларує чутливими свій листок values literalPassword і свій ключ provides password, заповнює задекларований слот 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), тоді як values.secretName, локатор, який сутність Feature навмисно залишає непозначеним, відсутній у цьому списку, хоча навантаження теж його містить. Пароль, який написав автор, надходить приховано, тоді як локатор поряд надходить як написано: позначення повідомляє політиці, що значення є, а саме значення до неї ніколи не потрапляє.

Правилу, яке забороняє літеральний секрет у згенерованому артефакті, потрібен третій. Правилу, яке вимагає, щоб кожне прикріплення з обліковими даними мало мітку власника, потрібен перший. Заміна одного іншим змінює, які збірки зупиняються.

Відсутність не є дозволом

Листок перелічується лише там, де його охоплює декларація. Тож відсутній sensitive_payload_leaves означає, що це прикріплення не називає жодного листка, який його сутність Feature декларує чутливим, — а ніколи не те, що навантаження нечутливе. Він також не розрізняє прикріплення, яке не має такого листка, і генератор, який взагалі не повідомляє про цю вісь: ці два випадки залишаються нерозрізненними, і читач відсутнього ключа дізнається саме це й нічого більше.

Гість, який сприймає відсутній список листків як дозвіл показати чи вивести значення у відкритому вигляді, прочитав позначення навпаки.

Ключ повністю пропускається в передачі, коли він був би порожнім, тож прикріплення, сутність Feature і слот якого нічого не декларують, містить рівно ті байти, які містило б, якби позначення не існувало. Саме цей пропуск робить хибне прочитання легким, і саме тому напрям варто сформулювати прямо.

Найнаочніший випадок — прикріплення, яке є чутливим і не перелічує жодного листка. Візьміть прикріплення вище й змініть дві речі: автор пише лише локатор, залишаючи задекларований як чутливий листок незаповненим, і заповнює ключ середовища з непозначеного ключа provides name сутності Feature замість password:

{
"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 — поверхні міток і анотацій, які читає політика.