الأدلة الإرشادية
الأطراف المعتمِدة
الطرف المعتمِد هو عميلك، أو أي جهة أخرى تُسأل أمامها، يُخضع كل إصدار من نظام الذكاء الاصطناعي لديك لتقييم ثبّته بنفسه. تقرّر مساحة العمل كل إصدار وفق تثبيته بجانب البوابة الخاصة بك، ويسحب هو سجل قرار لكل إصدار ويتحقق منه على جهازه. لا يرى أبدًا حالاتك أو تسمياتك أو آثارك، ولا يغيّر أي شيء تفعله بمتطلبك الخاص تثبيته.
السجل دليل يستطيع طرف ثانٍ التحقق منه، وليس شهادة اعتماد.
دعوة طرف معتمِد
في مشروع مستضاف، افتح Relying parties (في مجموعة Assurance في لوحة الأوامر، أو من Governance). لا يستطيع الدعوة إلا Owner: سمِّ المؤسسة، ثم أرسل بنفسك، مرة واحدة، الرابط الذي يظهر لك. يبقى صالحًا سبعة أيام.
يفتح الطرف المعتمِد الرابط وهو مسجّل الدخول بحساب من مؤسسته. لا يستطيع حساب عضو في مساحة عملك القبول، والحساب الذي ينضم لاحقًا إلى مساحة عملك يفقد صفحات الطرف المعتمِد. يرى الجانبان بريد الحساب الذي قبل: تحقّق من أنه الحساب الذي تتوقعه.
ما يفعله الطرف المعتمِد
1. التحقق من سجل أرسلته. صدّر سجلًا من صفحة تشغيل محكوم (Download the decision record) وأرسله. يشغّل هو:
``bash oloproof record verify record.json --key KEY_ID=PUBLIC_KEY --workspace-keys keys.json ``
بالمفتاح العام لمشغّلك، الذي يعطيه إياه مشغّل الـ runner لديك مباشرة، ومفاتيح بيان مساحة العمل التي ينشرها النشر، محفوظة من /api/workspace-statement-key.
بمجرد أن يكون لديك معرّف طرفك المعتمِد (في صفحتك)، أضف --relying-party RP_ID إلى كل فحص لاحق: عندها يفشل السجل الذي يعود إلى طرف معتمِد آخر، أو إلى المزوّد نفسه.
2. تثبيت التقييم. يلصق في صفحته evaluation.digest وevaluation.policy_digest ومعرّف التشغيل المقرَّر من السجل. يربط ملخص التقييم المجموعة (كل حالة ومحتواها)، والمقيّمين بمحتواهم، ومواصفات المقاييس والسياسة، فتصبح المجموعة المقتطعة أو السياسة الأكثر تساهلًا ملخصًا آخر. يجب أن تكون السياسة مما تحققت منه مساحة العمل. التشغيل هو خط الأساس الذي تُقرَّر مقابله كل قاعدة مقارنة، ويُعرض في صفحته، فلا يمكنك اختياره بترتيب ما تدفعه. لا يُستبدل التثبيت أبدًا: يُضاف تثبيت جديد ويكون الأحدث هو النافذ.
3. الإقرار بمفاتيح مشغّلك. تسرد صفحته كل تسجيل وكل إلغاء لمفتاح runner في المشروع، كما حدث، من سجل لا يستطيع أحد تعديله. لا يُحتسب المفتاح لتثبيته إلا بعد أن يقرّ بتسجيله، فلا يقرّر مفتاح تسجّله لاحقًا شيئًا له حتى يقارن مفتاحه العام بالذي أعطاه إياه المشغّل لديك. لا يحتاج التشغيل على عمّال Oloproof المُدارين إلى إقرار: فأنت لا تسجّل ذلك المفتاح ولا تدوّره.
4. سحب كل سجل. تسرد الصفحة كل إصدار من النظام قُرّر وفق تثبيته، مع حالة كل قاعدة ورابط Download لسجله. يسحب السجلات بنفسه، فلا يعتمد على تلك التي تختار إرسالها.
كيف يُقرَّر كل إصدار
يأخذ العامل التشغيل المثبَّت خطَّ أساس، متى كان تنفيذًا موثَّقًا موقّعًا بمفتاح أقرّ به، ويقرّر كل إصدار من النظام على أول بدء له لذلك التقييم، أيًّا كان المفتاح الذي وقّعه وأيًّا كان مصيره. لا يمكن استبدال تشغيل أول فاشل بإعادة تشغيل أوفر حظًا، ويبقى الإصدار الذي بدأ أولًا بمفتاح لم يقرّ به قط محجوبًا. تُقرَّر القواعد بالكود نفسه الذي يقرّر بوابتك، عند التنفيذ الموثَّق.
لا يعيش القرار أطول مما يستند إليه. إذا أُلغي مفتاح خط الأساس بوصفه مخترَقًا، أو ثبّت من جديد، تُحجب كل بوابة لم يعد التثبيت النافذ يقرّرها (MANUAL_REVIEW) مع السبب. لا يُحتسب المفتاح إلا بالمفتاح العام الذي أقرّ به، ولا يُحتسب التشغيل على عمّال Oloproof المُدارين إلا بمفتاح النشر نفسه.
ما يضيفه سجله
يحمل السجل المصدَّر لطرف معتمِد، في بيان مساحة العمل الموقّع:
- الطرف المعتمِد الموجَّه إليه، وتثبيته بوصفه المتطلب؛
- كل بدء للإصدار على التقييم، كلٌّ مع الطلب الموقّع من الـ runner نفسه، الذي يتحقق منه record verify مقابل المفاتيح التي يقدّمها؛
- سجل المفاتيح لكل مفتاح وقّع بدءًا أو تشغيلًا للإصدار: مفتاحه العام وتسجيله والإقرار به وأي إلغاء.
يُفشل record verify السجل إذا لم يصمد بدء موقّع أو سمّى تشغيلًا أو إصدارًا أو مجموعة أو مساحة عمل أو مشروعًا آخر، أو إذا لم يكن المفتاح العام لمفتاح مسجَّل هو الذي قدّمه، أو إذا استندت بوابة ناجحة إلى مفتاح لم يقرّ به أو إلى مفتاح مسجَّل بوصفه مخترَقًا، أو، مع --relying-party، إذا لم يكن السجل له أو لم يكن بيانه موقّعًا بمفتاح بيان مساحة عمل قدّمه. من دون --relying-party، البيان غير الموقّع يُقرأ غير مفحوص، لا موثَّقًا أبدًا. رموز خروجه لم تتغير: 0 عندما تنجح كل الفحوص الممكنة، و5 عندما يفشل أحدها، و2 عندما يتعذّر قراءة مفتاح أو ملف.
ما لا يستطيع إخبارك به
- أن الحساب الذي ثبّت وأقرّ يعود إلى الطرف المعتمِد: البريد معروض، لا مُثبَت.
- أن الـ runner لم يشغّل إلا كودًا يتحكم فيه مشغّله، أو أن الإصدار المقيَّم هو الذي يخدم الإنتاج.
- أن التقييم هو الصحيح: يبقى اختيار المجموعة بيد المزوّد، ما لم يقدّم الطرف المعتمِد المجموعة أو يثبّت تقييم حركة مستمدًا من الإنتاج.
- أي شيء قيل بعد التصدير: السجل هو كلمة مساحة العمل وقت تصديره؛ اسحب سجلًا جديدًا عند الشك.
- لا شيء بعد أن ينهي المشغّل العلاقة. لا تستطيع أنت إنهاءها: لا يمكن حذف مشروع، أو حسابك بوصفك آخر Owner لمساحة عمله، ما دام طرف معتمِد مرتبطًا به. ومع ذلك، اسحب كل سجل فور تقريره.
- فاصل PPI: التسميات التي وراء عيّنة بشرية ليست في السجل.