التوقيع والثقة
المستند الذي يتبعه وكيل أقرب إلى ما يُنشر في بيئة التشغيل منه إلى صفحة ويكي، ولذلك يُعامَل المعاملة نفسها: من كتبه، وهل تغيّر، وهل ما زال معتمدًا.
ما الذي يُوقَّع
ينتج عن النشر إقرار المؤلف (author attestation): توقيع على البايتات كما كُتبت، يسمّي المستند والإصدار والبصمة (digest) وسقف القدرات الذي يضمنه الناشر. والقراءة التي تحلّ المستند — أسسه ومضمَّناته ومعاملاته — يمكن أن تحمل أيضًا إقرار التسليم (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) قد
انتقلت عنه أولًا. يبقى الإصدار مقروءًا عند تثبيته، فيستطيع التدقيق أن يرى ما حدث، ويحمل علامة، فيبقى المستهلكون
على ما لديهم بدلًا من تطبيقه.
ما لا يضمنه التوقيع
أن المستند آمن. التوقيع يثبت المصدر ولا يصدر حكمًا: فهو يبرهن على من نشر هذه البايتات، ولا يقول شيئًا عمّا إذا كان اتباعها فكرة جيدة. الضوابط المهمة لذلك موجودة عند المستهلك: سقوف القدرات، والمراجعة قبل أن ينتقل مرجع، وشخص يقرّر ما يُسمح للوكيل باتباعه.