واجهة برمجة تطبيقات REST Defender for Cloud Apps

توضح هذه المقالة كيفية التفاعل مع Defender for Cloud Apps عبر HTTPS.

توفر واجهة برمجة تطبيقات Microsoft Defender for Cloud Apps وصولا برمجيا إلى Defender for Cloud Apps من خلال نقاط نهاية REST API. يمكن للتطبيقات استخدام واجهة برمجة التطبيقات لتنفيذ عمليات القراءة والتحديث على البيانات والكائنات Defender for Cloud Apps. على سبيل المثال، تدعم واجهة برمجة تطبيقات Defender for Cloud Apps العمليات الشائعة التالية لكائن مستخدم:

• تحميل ملفات السجل لاكتشاف السحابة
• إنشاء برامج نصية للكتلة
• سرد الأنشطة والتنبيهات
• تجاهل التنبيهات أو حلها

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

لاستخدام واجهة برمجة تطبيقات Defender for Cloud Apps، يجب أولا الحصول على عنوان URL لواجهة برمجة التطبيقات من المستأجر الخاص بك. يستخدم عنوان URL لواجهة برمجة التطبيقات التنسيق التالي: https://<portal_url>/api/<endpoint>.

للحصول على عنوان URL لواجهة برمجة التطبيقات Defender for Cloud Apps للمستأجر الخاص بك، قم بالخطوات التالية:

1. في مدخل Microsoft Defender، حدد الإعدادات. ثم اختر تطبيقات السحابة. ضمن النظام، حدد حول.

2. في Defender for Cloud Apps حول الشاشة، يمكنك مشاهدة عنوان URL لواجهة برمجة التطبيقات.

   

بمجرد أن يكون لديك عنوان URL لواجهة برمجة التطبيقات، أضف اللاحقة /api إليه للحصول على عنوان URL لواجهة برمجة التطبيقات. على سبيل المثال، إذا كان عنوان URL الخاص بمدخلك هو https://mytenant.us2.contoso.com، فإن عنوان URL لواجهة برمجة التطبيقات هو https://mytenant.us2.portal.cloudappsecurity.com/api.

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

يتطلب Defender for Cloud Apps رمزا مميزا لواجهة برمجة التطبيقات في رأس جميع طلبات واجهة برمجة التطبيقات إلى الخادم، مثل ما يلي:

Authorization: Token <your_token_key>

أين <your_token_key> هو الرمز المميز الشخصي لواجهة برمجة التطبيقات.

لمزيد من المعلومات حول رموز واجهة برمجة التطبيقات المميزة، راجع إدارة الرموز المميزة لواجهة برمجة التطبيقات.

الرموز المميزة لواجهة برمجة التطبيقات - مثال

curl -XGET -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/example-endpoint"

ما الإجراءات المدعومة؟

يصف الجدول التالي الإجراءات المدعومة:

حيث يمثل المورد مجموعة من الكيانات ذات الصلة.

ما أنواع الحقول المعتمدة؟

يصف الجدول التالي أنواع الحقول المدعومة:

الطوابع الزمنية

تشير إشارات الطوابع الزمنية في واجهة برمجة تطبيقات Defender for Cloud Apps إلى الطابع الزمني Unix بالمللي ثانية. يتم تحديد هذا الطابع الزمني من خلال عدد المللي ثانية منذ 1970-01-01 0:00:00. يمكنك استخدام cmdlet PowerShell get-date لتحويل التواريخ إلى طوابع زمنية.

حدود

يمكنك اختيار الحد من طلباتك عن طريق توفير معلمة حد في الطلب.

يتم دعم الأساليب التالية لتوفير معلمة الحد:

• ترميز عنوان URL (مع Content-Type: application/x-www-form-urlencoded عنوان)
• بيانات النموذج
• نص JSON (مع Content-Type: multipart/form-data ورأس حد مناسب)

مرشحات

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

هيكل

تدعم بعض نقاط نهاية واجهة برمجة التطبيقات عوامل التصفية عند تنفيذ الاستعلامات. في الأقسام ذات الصلة، ستجد مرجعا يسرد جميع الحقول القابلة للتصفية المتوفرة وعوامل التشغيل المدعومة لهذا المورد.

تدعم معظم عوامل التصفية قيما متعددة لتزويدك بالاستعلامات القوية. عند الجمع بين عوامل التصفية وعوامل التشغيل، نستخدم AND كعامل تشغيل منطقي بين عوامل التصفية.

عوامل التصفية - مثال

curl -XGET -H "Authorization:Token <your_token_key>" "https://<tenant_id>.<tenant_region>.portal.cloudappsecurity.com/api/example-endpoint" -d '{
  "filters": {
    "some.field": {
      "eq": ["value1", "value2"],
      "isset": true
    },
    "some.field2": {
      "gte": 5
    }
  },
  "skip": 5,
  "limit": 10
}'

المشغلون

يصف الجدول التالي عوامل التشغيل المدعومة:

الخطوات التالية

إذا واجهت أي مشاكل، فنحن هنا للمساعدة. للحصول على المساعدة أو الدعم لقضية المنتج، يرجى فتح تذكرة دعم.