الانتقال إلى المحتوى الرئيسي
POST
تقييم سياسة MAIP

تقييم سياسة MAIP

POST /v1/maip/policies/evaluate تقييم جميع سياسات MAIP النشطة للمستأجر المصادق عليه مقابل وكيل محدد ونطاق مطلوب. يُرجع ما إذا كان الإجراء مسموحًا به أو مرفوضًا أو يتطلب موافقة بشرية. هذه هي نقطة تفتيش التنفيذ في وقت التشغيل التي تستدعيها الوكلاء قبل تنفيذ العمليات الحساسة.
يستخدم تقييم السياسة نموذج الرفض يتجاوز: إذا كانت أي سياسة نشطة ذات تطابق مشغلات قاعدة deny، يتم حظر الإجراء بغض النظر عن أي allow القواعد. علامة requires_approval إضافية — يمكن تعيينها حتى عندما تكون الإجراء مسموح به.

المصادقة

يتطلب رأس X-API-Key أو رمز Bearer JWT. نطاق المستأجر عبر ملف تعريف الارتباط أو مطالبة JWT.

منطق التقييم

يقوم التقييم بثلاثة فحوصات متسلسلة:
  1. فحص حالة الوكيل — يجب أن يكون الوكيل status: "active". يتم رفض الوكلاء المعلقين أو الملغاة دائمًا.
  2. فحص الوصول إلى النطاق — يجب أن يكون النطاق المطلوب موجودًا في النطاقات الممنوحة للوكيل. النطاقات المرفوضة صراحةً (المسبوقة بـ !) تمنع الوصول دائمًا.
  3. فحص قواعد السياسة — يتم تقييم جميع سياسات المستأجر النشطة بترتيب الأولوية. يتم ربط شروط كل قاعدة بـ AND. إذا تطابقت أي قاعدة deny، يتم حظر الإجراء.

الاستجابة

boolean
true إذا كان الإجراء مسموحًا به، false إذا تم رفضه بأي فحص.
string[]
أسماء السياسات التي رفضت الإجراء. مصفوفة فارغة إذا سمح بذلك.
string
سبب الرفض المقروء بشريًا. أحد الأسباب التالية: - "agent is not active" — الوكيل معلق أو ملغى - "scope not granted to agent" — النطاق ليس في النطاقات الممنوحة للوكيل - "denied by policy" — سياسة واحدة أو أكثر محظورة العمل
boolean
true إذا كان أي قاعدة سياسة مطابقة تحتوي على requires_approval: true، حتى لو كان الإجراء مسموح به بخلاف ذلك. يجب على المتصل تقديم موافقة بشرية سير العمل قبل المتابعة.

مثال

التفويضات

X-API-Key
string
header
مطلوب

مفتاح API للمصادقة من جهاز إلى جهاز

الجسم

application/json
agent_id
string
مطلوب

معرف وكيل متوافق مع MAIP

scope
string
مطلوب

نطاق الإذن المطلوب

action
string

الإجراء المحدد الذي يتم تنفيذه

resource
string

المورد المحدد الذي يتم الوصول إليه

الاستجابة

نتيجة التقييم

allowed
boolean

ما إذا كان الإجراء مسموحًا به

denied_by
string[]

أسماء السياسات التي رفضت الإجراء

reason
string

سبب الرفض المقروء بشريًا

requires_approval
boolean

ما إذا كانت الموافقة البشرية مطلوبة