ESET PROTECT On-Prem – جدول المحتويات

إعداد ESET PROTECT On-Prem REST API

اتبع الخطوات الواردة أدناه لإعداد ESET PROTECT On-Prem REST API:

  1. تمكين واجهة REST API في المزيد > الإعدادات.

هامة
  • تأكد من فتح منافذ API في جدار الحماية المحلي.
  • لاستخدام REST API، يجب أن تحتوي شهادة النظير لخادم ESET PROTECT (سواء تم استخدامها كشهادة خادم REST أم لا) على localhost في حقل الاسم الشائع/المضيف. إذا كانت شهادة النظير (الخادم) لا تفي بهذا المطلب، عليك إنشاء شهادة جديدة وتغيير شهادة الخادم.
  1. عيّن لمستخدمي واجهة API مجموعة أذونات API.

هامة

لا يمكن لحساب المسؤول استخدام API.
  1. لأتمتة التفاعلات مع ESET PROTECT On-Prem API، يمكنك استخدام واجهة Swagger UI المُدمجة (متوفرة من إصدار ESET PROTECT On-Prem رقم 13.1).

arrow_down_business ما هو Swagger UI؟

بدلاً من ذلك، يمكنك تطبيق استدعاءات API إلى تطبيق عميل REST (على سبيل المثال، Postman) أو يمكنك استخدام سطر الأوامر (curl).

ملاحظة

يعمل خادم REST محلياً على خادم ESET PROTECT. لا يمكنك استخدام ESET Connect مع ESET PROTECT On-Prem REST API.
  1. قم بتنفيذ طلب GetTokens لتسجيل الدخول إلى خادم REST: في واجهة Swagger UI، وسّع GetTokens > انقر فوق جرب ذلك > قدّم البيانات الصحيحة في نص الطلب وانقر فوق تنفيذ.

الطريقة

POST

الوظيفة

getTokens

عنوان URL

https://protect_server:9443/GetTokens

نص الرسالة

{

"username" : "api",

"password" : "Admin.12345678",

"grant_type" : "password"

}
  1. تعمل الاستجابة على إرجاع accessToken. يمكنك لاحقاً استخدام accessToken في طلبات API الأخرى كرمز مميز للحامل (Authorization: Bearer). في واجهة Swagger UI، انقر فوق التخويل > الصق accessToken > انقر فوق التخويل. يمكنك تنفيذ استدعاءات أخرى، وستقوم واجهة Swagger UI بتضمين رمز التخويل المميز تلقائياً في كل استدعاء.

ملاحظة

راجع أيضاً أمثلة استدعاءات API وقائمة جميع استدعاءات API المتاحة في ESET PROTECT On-Prem.