العمل باستخدام واجهة برمجة التطبيقات (API)

لا يمكن تقييد الوصول إلى التطبيقات من خلال REST API باستخدام الحماية بكلمة مرور. على سبيل المثال، لا يمكن منع مستخدم من تعطيل حماية من خلال REST API.‏ يمكنك تكوين الحماية بكلمة المرور من خلال REST API وتقييد وصول المستخدم إلى التطبيق من خلال الواجهة المحلية.

لإدارة التطبيق من خلال REST API، ستحتاج إلى تشغيل عميل REST في الحساب الذي حددته عند تثبيت التطبيق الذي يشتمل على دعم REST API. يمكنك تحديد مستخدم واحد فقط للعمل باستخدام REST API.‏

فتح المراجع الخاصة بـ REST API‏

تتكون إدارة التطبيق من خلال REST API من الخطوات التالية:

  1. الحصول على القيم الحالية لإعدادات التطبيق. لتنفيذ ذلك، أرسل طلب GET.‏

    مثال:

    GET http://localhost:6782/kes/v1/settings/ExploitPrevention

  2. سيقوم التطبيق بإرسال استجابة تشتمل على بنية الإعدادات وقيمها. يدعم Kaspersky Endpoint Security الصيغ XML و JSON.‏

    مثال:

    ‎{‎

    ‎"action": 0,‎

    "enableSystemProcessesMemoryProtection": true,

    ‎"enabled": true‎

    ‎}‎

  3. تحرير إعدادات التطبيق. استخدم بنية الإعدادات التي تم استلامها في سياق الاستجابة لطلب GET.‏

    مثال:

    ‎{‎

    ‎"action": 0,‎

    "enableSystemProcessesMemoryProtection": false,

    ‎"enabled": true‎

    ‎}‎

  4. حفظ إعدادات التطبيق (الحمولة) في JSON ‏(payload.json).
  5. وقّع JSON بتنسيق PKCS7.‏

    مثال:

    $ openssl smime -sign -in payload.json -signer cert.pem -inkey key.pem -nodetach -binary -outform pem -out signed_payload.pem

    نتيجة لذلك، تحصل على ملف موقع مع حمولة الطلب (signed_payload.pem).‏

  6. تحرير إعدادات التطبيق. لفعل ذلك، أرسل طلب POST وأرفق الملف الموقع مع حمولة الطلب (signed_payload.pem).

يطبق التطبيق الإعدادات الجديدة ويرسل استجابة تحتوي على نتائج تكوين التطبيق (من الممكن أن تكون الاستجابة فارغة). ويمكنك التحقق من تحديث الإعدادات باستخدام طلب GET.‏

أعلى الصفحة