Підписи та довіра
Документ, якого дотримується агент, ближчий до артефакту розгортання, ніж до сторінки вікі, тому до нього ставляться так само: хто його написав, чи він змінився і чи він досі схвалений.
Що підписується
Публікація створює засвідчення автора (author attestation): підпис над байтами документа, як його написано, що називає документ, версію, дайджест і стелю можливостей, за яку ручається видавець. Читання, яке розв’язує документ — його основи, включення та параметри, — може також містити засвідчення доставки (delivery attestation), для одного читача: підпис над текстом у тому вигляді, як його надіслано, і над маніфестом розв’язання (дайджест документа, кожна залежність, з якою його розв’язано, і дайджест результату), у який вкладено підпис автора. Отримувач перевіряє доставку, дістає з неї підпис автора і перевіряє його теж.
Ключі
Публічні ключі організації розміщено за адресою instruction://pub/<owner>/keys.json, і
отримувачі дізнаються про них із самого читання. Кожен ключ має один із трьох станів: active (активний), retired
(виведений з ужитку) або revoked (відкликаний).
| Стан | Значення |
|---|---|
| active | підписує нові версії |
| retired | більше не підписує; попередні версії й далі проходять перевірку |
| revoked | версії, підписані ним, вважаються непідписаними; отримувачі, які вимагають підписів, залишають ту версію, яку мали |
Ротацію виконує instruction keys rotate --org acme. Відкликайте ключ лише в разі компрометації: це свідомий крок, і його не можна скасувати.
Підпис власним ключем
Приватна половина ніколи не залишає вашої машини; реєстр бачить лише публічний JWK.
instruction keygen --out acme-key.json --kid laptop
instruction keys add acme-key.json --org acme --label "Alice's laptop"
instruction publish <id> --sign-with acme-key.json --message "signed by hand" Перевірка з боку отримувача
instruction watch instruction://acme/runbook@stable \
--require-signature --publisher https://instruction.md/pub/acme Закріпити видавця — це важлива половина. Без цього ви перевіряєте, що документ підписав хтось; з цим — що його підписав саме той видавець, якого ви очікували. Незакріплений видавець означає відмову, а не слабший рівень довіри.
Відкликання версії
instruction revoke <id> <version> відкликає опубліковану версію. Спершу посилання (refs)
мають бути пересунуті з неї. Її й далі можна прочитати, якщо закріпити, тож аудит усе ще бачить, що сталося, і
вона позначена, тож отримувачі залишають попередню версію, а не застосовують цю.
Чого підпис не обіцяє
Що документ безпечний. Підпис — це походження, а не оцінка: він доводить, хто опублікував ці байти, і нічого не каже про те, чи варто їх дотримуватися. Засоби контролю, які важать для цього, є на боці отримувача: стелі можливостей, рецензування перед тим, як посилання пересунеться, і людина, яка вирішує, чого агентові дозволено дотримуватися.