إسترداد واجهات برمجة التطبيقات (API) الخاصة بدور مستخدم ESA باستخدام واجهات برمجة التطبيقات (API) الخاصة بالامتيازات

المقدمة

يوضح هذا المستند كيفية إسترداد معلومات الامتيازات لدور ESA الذي تمت مصادقته باستخدام نقطة نهاية /ESA/API/v2.0/login/privileges.

البيئة

• بايثون 3.x
• تم تثبيت مكتبة طلبات Python
• جهاز أمان البريد الإلكتروني (ESA) مع خدمة API التي تم تمكينها على واجهة الإدارة ومع منفذ API الذي تم تكوينه

قرار

1. تأكد من تمكين خدمة ESA API على واجهة الإدارة.
2. أكدت ال يشكل API ميناء على ال ESA واستخدم ال نفسه ميناء قيمة في النص التنفيذي.
3. الحصول على قيمة رأس التفويض وملف تعريف إرتباط جلسة عمل ESA صالح للحساب المستخدم لاستدعاء API.
4. إذا لزم الأمر، قم بتثبيت التبعية المطلوبة:

   pip install requests

5. قم بتحديث متغير البرنامج النصي عنوان IP ل ESA ومنفذ API وقيم المصادقة)، ثم قم بتشغيل البرنامج النصي.

ملاحظة: أستخدم منفذ API المكون على ESA. الحفاظ على قيمة المنفذ متناسقة عبر البرنامج النصي وأي لقطات شاشة.

ترجمة الاستجابة

تمثل إستجابة /login/الامتيازات الامتيازات الممنوحة لجلسة العمل المصدق عليها. أستخدم قائمة الامتيازات المرتجعة لتحديد موارد واجهة برمجة التطبيقات والعمليات المتاحة لدور المستخدم الحالي.

في حمولة JSON، راجع data.privileges. يسرد كل إدخال مسار مورد وأساليب HTTP المسموح بها لذلك المورد.

المحتوى ذي الصلة

2) تثبيت الطلبات (لم يتم تثبيته مع Python بشكل افتراضي). قم بتشغيل هذا الأمر من موجه الأوامر:

pip install requests

تسمح الطلبات بإرسال طلبات HTTP من Python.

3) يتم تضمين pprint مع Python (المكتبة القياسية). لا يتطلب الأمر أي تثبيت.

توفر وحدة الطباعة إمكانية طباعة هياكل بيانات Python العشوائية بشكل جميل في نموذج يمكن إستخدامه كمدخل إلى المترجم وعرضهم في تنسيق يمكن قراءته. هذه الوحدة النمطية إختيارية. يمكن أن يستخدم النص التنفيذي الطباعة بدلا من ذلك؛ ومع ذلك، فإن المخرجات أقل قابلية للقراءة.

 لا يلزم تثبيت JSON بشكل منفصل لأنه جزء من المكتبة القياسية.

مسألة

حدد واجهات برمجة تطبيقات Cisco Email Security Appliance (ESA) التي يمكن الوصول إليها لدور المستخدم الذي تمت مصادقته.

السبب

يتم التحكم في وصول واجهة برمجة التطبيقات (API) على ESA بالامتيازات المخصصة للجلسة المصدق عليها والدور. ترجع نقطة نهاية /esa/api/v2.0/login/الامتيازات قائمة الامتيازات الفعالة بحيث يمكنك تحديد موارد واجهة برمجة التطبيقات (API) وأساليب HTTP المسموح بها للمستخدم الحالي.

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

يقوم طلب GET الناجح إلى /esa/api/v2.0/login/privileges بإرجاع HTTP 200 OK وحمولة JSON التي تسرد الامتيازات (وصول API) المتاحة للجلسة المصدق عليها. راجع JSON الذي تم إرجاعه لتحديد موارد وعمليات واجهة برمجة التطبيقات المسموح بها لهذا الدور.

قرار

الإجراء

import requests
import json
import pprint

url = "https://192.0.2.10:6080/esa/api/v2.0/login/privileges"
headers = {
"Authorization": "Basic ",
    "Cookie": ""
}

response = requests.request("GET", url, headers=headers, verify=True)
json_string = json.loads(response.content)
pprint.pprint(json_string)

مثال الإخراج

مثال الإخراج:

{
  "data": {
    "privileges": [
      {
        "resource": "/esa/api/v2.0/login/privileges",
        "methods": ["GET"]
      }
    ]
  }
}

راجع قائمة الامتيازات لتحديد موارد API وطرق HTTP المسموح بها للجلسة المصدق عليها.

محفوظات المراجعة

المراجعة	تاريخ النشر	التعليقات
1.0	01-Oct-2026	الإصدار الأولي