الانتقال إلى المحتوى الرئيسي
تتيح لك سياسات الإصدار فرض متطلبات الامتثال والولاية القضائية والثقة عبر عمليات السك والتحقق وتصدير حزم الإثبات. عندما تكون السياسة نشطة، يتم تقييم كل طلب مطابق مقابل قواعدك قبل المتابعة. يتم رفض الطلبات غير المطابقة مع سبب واضح.

متى تستخدم السياسات

استخدم سياسات الإصدار عندما تحتاج إلى:
  • تقييد السك على المُصدرين في ولايات قضائية محددة (مثل الولايات المتحدة فقط أو الولايات المتحدة والاتحاد الأوروبي)
  • طلب مستوى ثقة أدنى قبل أن يتمكن المُصدر من إنشاء شهادات
  • فرض قواعد مختلفة للسك مقابل التحقق
  • التحكم في من يمكنه تصدير حزم الإثبات أو إرسال طلبات قابلية نقل البيانات
  • اختبار سياسة مقابل مدخلات عينة قبل النشر للإنتاج
  • تدقيق السياسة التي كانت سارية عند إنشاء شهادة
إذا لم تقم بإنشاء أي سياسات، يُسمح بجميع طلبات السك والتحقق والتصدير افتراضيًا.

كيف تعمل السياسات

تحتوي كل سياسة على قاعدة واحدة أو أكثر. تحتوي القاعدة على:
  • الشروط — فحوصات على مستوى الحقل يتم تقييمها مقابل سياق الطلب (على سبيل المثال، jurisdiction eq US)
  • التأثير - ALLOW أو DENY إذا تطابقت الشروط
  • التأثير الافتراضي - يُطبق عندما لا تتطابق أي قاعدة
يتم تقييم القواعد بالترتيب. تحدد القاعدة المطابقة الأولى النتيجة. إذا لم تتطابق أي قاعدة، يتم تطبيق default_effect.

عوامل الشرط

تدعم الشروط تدوين النقاط للحقول المتداخلة (مثل key.age_days، key.status).

الحقول المتاحة

يمكن الإشارة إلى أي حقل في مدخلات التقييم، بما في ذلك الحقول المتداخلة باستخدام تدوين النقطة. الحقول التالية متاحة افتراضيًا:

دورة حياة السياسة

لكل سياسة حالة تتحكم فيما إذا كانت مطبقة: عند إنشاء سياسة، تختار الحالة الأولية. يتم تقييم السياسات ACTIVE فقط في وقت الطلب.

انتقالات دورة الحياة

تتبع السياسات عادة هذا التقدم:
  1. إنشاء كـ DRAFT — كتابة وتحسين قواعدك دون التأثير على حركة المرور الحية.
  2. محاكاة — اختبر المسودة التجريبية مقابل مدخلات عينة باستخدام محاكي السياسات.
  3. تفعيل — اضبط الحالة على ACTIVE ليتم تطبيق السياسة على الطلبات المطابقة.
  4. تعطيل — اضبط الحالة على DISABLED لإيقاف التنفيذ مؤقتًا دون فقدان تعريف السياسة.
  5. حذف — إزالة السياسة بالكامل عندما لا تكون هناك حاجة إليها.
يمكنك الانتقال بين DRAFT و ACTIVE و DISABLED في أي وقت عن طريق تحديث السياسة. يزيد كل تغيير في الحالة من إصدار السياسة، والذي يتم تسجيله جنبًا إلى جنب مع كل قرار تقييم لغرض التدقيق.
يصبح نقل السياسة إلى ACTIVE ساري المفعول على الفور. تأكد من اختبار القواعد باستخدام المحاكي قبل التفعيل.

فئات السياسات

السياسات محددة النطاق لإجراء معين: يمكنك الحصول على سياسات نشطة متعددة. تنطبق كل سياسة على فئتها فقط.

سياسات مراقبة الصادرات

تتحكم سياسات BUNDLE_EXPORT في من يمكنه تصدير حزم الإثبات وتقديم طلبات قابلية نقل البيانات. استخدمها لتقييد الصادرات حسب الولاية القضائية أو مستوى الثقة أو أي حقل آخر في مدخلات التقييم.
لإنشاء هذه السياسة عبر واجهة برمجة التطبيقات (API)، اضبط category على BUNDLE_EXPORT:

ارتباطات السياسة

تربط روابط السياسة سياسة معينة بهدف محدد حتى تعرف المحرك متى يطبقها. يتضمن كل ربط: عندما تتطابق روابط متعددة مع طلب، يتم تقييمها بترتيب تنازلي للأولوية. توقف نتيجة DENY الأولى التقييم فورًا.

إنشاء ربط عبر واجهة برمجة التطبيقات

لتطبيق سياسة كإعداد افتراضي على مستوى المستأجر، اضبط target_type على TENANT_DEFAULT وتجاهل target_id:
استخدم قيم أولوية أعلى للربط الأكثر تحديدًا. على سبيل المثال، عيّن الأولوية 100 لربط على مستوى المُصدر و10 للوضع الافتراضي للمستأجر بحيث يتم تقييم السياسة الخاصة بالمُصدر أولاً.

إنشاء سياسة

من وحدة التحكم

  1. انتقل إلى السياسات في الشريط الجانبي للوحة التحكم
  2. انقر على إنشاء سياسة
  3. أدخل اسمًا، وحدد فئة (MINT، VERIFY، أو BUNDLE_EXPORT)، واختر حالة
  4. اكتب قواعدك بتنسيق JSON أو استخدم قالبًا
  5. انقر فوق نشر السياسة — إذا كانت الحالة ACTIVE، فإنها تدخل حيز التنفيذ فورًا

من قالب

تتضمن وحدة التحكم أربعة قوالب جاهزة للاستخدام يمكنك إضافتها بنقرة واحدة: لاستخدام قالب، افتح علامة التبويب القوالب في صفحة السياسات وانقر على استخدام قالب. يتم إنشاء السياسة وتفعيلها على الفور. يمكنك تعديلها لاحقًا لتخصيص القواعد.

عبر واجهة برمجة التطبيقات

عيّن status إلى DRAFT إذا كنت ترغب في حفظ السياسة دون فرضها بعد.
Response

سرد السياسات

يعرض مصفوفة بجميع السياسات للمستأجر الحالي.

محاكاة سياسة

قبل الاعتماد على سياسة في الإنتاج، استخدم المحاكي لاختبار كيفية تقييمها لمدخل معين. في وحدة التحكم، افتح علامة التبويب المحاكي في صفحة السياسات، وحدد سياسة، وأدخل مدخل اختبار. يمكنك أيضًا استدعاء نقطة نهاية التقييم مباشرةً:
Response
يتضمن الرد أربعة حقول:
إذا كنت تعتمد سابقًا على evaluation_ms في استجابة التقييم لمراقبة الأداء، فقد تم حذف هذا الحقل من استجابة API. لا يزال مسجلاً في مسار تدقيق القرار — استعلم عن resource_type=policy_decision في سجل التدقيق لاسترداده.
إذا لم تتطابق أي قاعدة، فإن الاستجابة تعكس default_effect:

سجل تدقيق القرار

يتم تسجيل كل تقييم للسياسة تلقائيًا. يسجل كل قرار إصدار السياسة، والقواعد المطابقة، وتجزئة SHA-256 للمدخلات لإثبات عدم التلاعب. استخدم سجلات القرارات لتتبع سبب السماح بطلب معين أو رفضه. يتضمن رد التقييم decision_id يمكنك الرجوع إليه في استعلامات التدقيق:
يتضمن سجل التدقيق حقولًا ليست جزءًا من استجابة واجهة برمجة تطبيقات التقييم، مثل evaluation_ms وinput_hash:

حذف سياسة

أزل سياسة من وحدة التحكم بالنقر على أيقونة الحذف في بطاقة السياسة، أو عبر واجهة برمجة التطبيقات:
يصبح حذف السياسة ساري المفعول على الفور. لن يتم تقييم أي طلبات سك أو تحقق معلقة كانت خاضعة للسياسة مقابلها بعد الآن.

مثال: سياسة متعددة القواعد

اجمع قواعد متعددة للتعبير عن متطلبات معقدة. يتم تقييم القواعد بالترتيب — المطابقة الأولى تفوز.
ترفض هذه السياسة جهات الإصدار من الفئة الفردية بغض النظر عن الولاية القضائية، وتسمح لجهات الإصدار الأمريكية والأوروبية بأي مستوى ثقة آخر، وترفض جميع الآخرين.

ذات صلة

حزمة تطوير برامج محرك السياسات

تقييم السياسات برمجيًا باستخدام SDK للتكامل المخصص السيناريوهات.

مرجع واجهة برمجة تطبيقات السياسة

إنشاء السياسات وإدراجها وتقييمها وحذفها عبر واجهة برمجة تطبيقات REST.

صادرات الامتثال

تصدير بيانات التدقيق بتنسيقات SOC 2 و GDPR و HIPAA للامتثال التقارير.

الحوكمة

استخدم سير عمل الحوكمة للموافقة على المصدر وتغييرات الحالة.