الانتقال إلى المحتوى الرئيسي
GET
سرد سياسات MAIP

قائمة سياسات MAIP

GET /v1/maip/policies يُرجع جميع سياسات وكيل MAIP المكونة للمستأجر المصادق عليه. تُعرّف السياسات قواعد التنفيذ في وقت التشغيل التي تحكم ما يمكن للوكلاء فعله بناءً على درجات الثقة، والنطاقات، وعمق التفويض، ونوع الوكيل.

المصادقة

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

الاستجابة

يعرض مصفوفة من كائنات السياسة.
string
المفتاح الأساسي UUID للسياسة.
string
معرف UUID للمستأجر المالك.
string
اسم السياسة المقروء بشريًا. يُستخدم في رسائل الرفض وسجلات التدقيق.
string
وصف تفصيلي لما تفرضه السياسة.
string
فئة السياسة. واحدة من: "scope"، "trust"، "rate"، "custom".
string
حالة دورة حياة السياسة. واحدة من: "active"، "disabled"، "archived". فقط يتم تقييم سياسات active أثناء فحوصات السياسة.
integer
أولوية التقييم. يتم تقييم الأرقام الأقل أولاً. الافتراضي: 100.
object
مصفوفة JSON لقواعد السياسة. تحتوي كل قاعدة على شروط وتأثير ("allow"، "deny"، "require_approval")، واختياريًا علامة requires_approval. راجع إنشاء سياسة للحصول على التفاصيل الكاملة مخطط القاعدة.
string
طابع زمني لإنشاء ISO 8601.
string
طابع زمني لآخر تحديث ISO 8601.

مثال

التفويضات

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

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

الاستجابة

مصفوفة من السياسات

id
string<uuid>

مفتاح أساسي UUID

tenant_id
string<uuid>

معرف UUID للمستأجر المالك

name
string

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

description
string

وصف مفصل للسياسة

category
enum<string>

فئة السياسة

الخيارات المتاحة:
scope,
trust,
rate,
custom
status
enum<string>

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

الخيارات المتاحة:
active,
disabled,
archived
priority
integer

أولوية التقييم (الأقل = الأول)

rules
object[]

مصفوفة من قواعد السياسة

created_at
string<date-time>
updated_at
string<date-time>