فهم نظرة عامة على واجهة برمجة تطبيقات نقاط النهاية الآمنة

مسألة

يصف هذا المستند إستخدام واجهة برمجة التطبيقات (API) لنقاط النهاية الآمنة (SE) من Cisco.

قرار

لاستخدام واجهة برمجة تطبيقات SE، قم بإنشاء بيانات اعتماد واجهة برمجة تطبيقات في وحدة التحكم SE.

تستخدم الأمثلة الواردة في هذه المقالة نقطة نهاية لنظام التشغيل Windows 7.

1. سجل الدخول إلى وحدة التحكم وانتقل إلى الحسابات > بيانات اعتماد واجهة برمجة التطبيقات (API).

1. انقر فوق بيانات اعتماد واجهة برمجة تطبيقات جديدة لإنشاء مجموعة جديدة من المفاتيح.

2. أدخل اسم التطبيق. حدد نطاق القراءة فقط أو القراءة والكتابة.

ملاحظة: يمكن أن تقوم بيانات اعتماد واجهة برمجة التطبيقات (API) ذات نطاق القراءة والكتابة بإجراء تغييرات على تكوين Cisco SE الخاص بك التي يمكن أن تتسبب في حدوث مشاكل كبيرة في نقاط النهاية الخاصة بك.  لا تنطبق بعض أوجه حماية الإدخال المضمنة في وحدة تحكم SE من Cisco على واجهة برمجة التطبيقات (API).

3. انقر فوق الزر إنشاء. تظهر صفحة تفاصيل مفتاح واجهة برمجة التطبيقات. احفظ هذه المعلومات لأن بعضها غير متوفر بعد مغادرة الشاشة.

ملاحظة: تتيح بيانات اعتماد واجهة برمجة التطبيقات (معرف عميل واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات) للبرامج الأخرى إسترداد بيانات Cisco SE وتعديلها. وهو يعادل وظيفيا اسم مستخدم وكلمة مرور، ويجب التعامل معه على هذا النحو.

تحذير: يتم عرض بيانات اعتماد API مرة واحدة فقط. إذا فقدت بيانات الاعتماد، فعليك إنشاء بيانات اعتماد جديدة.

قم بحذف بيانات اعتماد واجهة برمجة التطبيقات للتطبيق إذا كنت تشك في أنه قد تم أختراق بيانات الاعتماد هذه، ثم قم بإنشاء بيانات اعتماد جديدة.  عند حذف بيانات اعتماد واجهة برمجة تطبيقات (API)، يتم قفل العميل الذي يستخدم البيانات القديمة، لذا قم بتحديثها باستخدام بيانات الاعتماد الجديدة.

البيئة

• نقطة النهاية المختبرة: نقطة نهاية نظام التشغيل Windows 7.
• المنتج: Cisco SE
• الوصول: وصول وحدة التحكم بإذن لإنشاء بيانات اعتماد API وحذفها.
• واجهة برمجة التطبيقات: SE API الإصدار 3 والإصدار 1 والإصدار 0 (أمثلة تستخدم الإصدار 1).
• أداة العميل: تم تثبيت Curl على النظام المستخدم لتشغيل طلبات API.

توجد حاليا ثلاث إصدارات من واجهة برمجة تطبيقات SE: الإصدار 3 والإصدار 1 والإصدار 0. يوفر الإصدار 3 وظائف إضافية مقارنة بالإصدار 1 والإصدار 0. تتوفر وثائق واجهة برمجة التطبيقات الإصدار 3 في هذا الارتباط. أستخدم الإصدار 3 لاسترداد هذه المعلومات:

• سجلات التدقيق
• التحكم في الجهاز
• الأجهزة
• الاستبعادات
• جدار حماية المضيف
• اللجنة الاولمبية الدولية
• MSSP
• المنظمات
• السياسات
• أجهزة الكمبيوتر
• مكامن الضعف

انقر الأمر المناسب في الوثيقة لترى أمثلة من إستخدامه. 

نموذج وانهيار أمر API

يحتوي كل أمر API على معلومات مماثلة وينقسم إلى أمر حدود مثل هذا:

curl -o yourfilename.json https://client_id:api_key@api.example.com/v1/whatyouwanttodo

عندما تستخدم أمر التجعد مع خيار -o، فإنه يسمح لك بحفظ المخرجات في ملف. في هذه الحالة يكون اسم الملف "you filename.json". 

تلميح: يتوفر المزيد من المعلومات حول ملفات .json على موقع JSON على الويب.

يحدد الجزء التالي من أمر curl بيانات الاعتماد قبل رمز @. بعد إنشاء بيانات اعتماد واجهة برمجة التطبيقات، أستخدم معرف عميل واجهة برمجة التطبيقات (API) ومفتاح واجهة برمجة التطبيقات (API) في هذا الجزء من URL.

https://client_id:api_key@

قم بإضافة رقم الإصدار والإجراء المطلوب إجراؤه. على سبيل المثال، قم بتشغيل GET /v1/computers. الأمر الكامل يبدو هكذا:

curl -o computers.json https://client_id:api_key@api.example.com/v1/computers

بعد أن تقوم بتشغيل الأمر، يظهر ملف computers.json في الدليل حيث بدأت الأمر.

ملاحظة: يتوفر Curl عبر الإنترنت ويتم تجميعه للعديد من الأنظمة الأساسية، بما في ذلك Windows (بشكل عام، تريد إستخدام Win32 - الإصدار العام).

عندما تقوم بفتح الملف، فإن كل البيانات تظهر على سطر واحد. لعرضه في تخطيط منسق، قم بتثبيت ملحق مستعرض يقوم بتنسيق JSON وفتح الملف في متصفح. يوضح هذا الإخراج معلومات لأجهزة الكمبيوتر، مثل:

connector_guid، hostname، نشط، إرتباطات، connector_version، operating_system، internal_ips، external_ip، group_guid، network_address، guid النهج، واسم النهج.

{
version: "v1.0.0",
metadata: {
links: {
self: "https://api.amp.cisco.com/v1/computers"
},
results: {
total: 4,
current_item_count: 4,
index: 0,
items_per_page: 500
}
},
data: [
{
connector_guid: "abcdef-1234-5678-9abc-def123456789",
hostname: "host.example.com",
active: true,
links: {
computer: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789",
trajectory: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789/trajectory",
group: "https://api.amp.cisco.com/v1/groups/abcdef-1234-5678-9abc-def123456789"
},
connector_version: "4.4.2.10200",
operating_system: "Windows 7, SP 1.0",
internal_ips: [
"10.1.1.2",
" 192.168.1.2",
" 192.168.2.2",
" 169.254.245.1"
],
external_ip: "192.0.2.10",
group_guid: "abcdef-1234-5678-9abc-def123456789",
network_addresses: [
{
mac: "ab:cd:ef:01:23:45",
ip: "10.1.1.2"
},
{
mac: "bc:de:f0:12:34:56",
ip: "192.168.1.2"
},
{
mac: "cd:ef:01:23:45:67",
ip: "192.168.2.2"
},
{
mac: "de:f0:12:34:56:78",
ip: "169.254.245.1"
}
],
policy: {
guid: "abcdef-1234-5678-9abc-def123456789",
name: "Protect Policy"
}
}
]
}

يوضح هذا المثال طلب واجهة برمجة تطبيقات (API) أساسي. يمكنك الآن إستخدام خيارات أوامر أخرى لاسترداد البيانات وتعديلها في بيئتك.

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

• وثائق واجهة برمجة التطبيقات (API) لنقاط النهاية من Cisco AMP
• الدعم التقني والمستندات - Cisco Systems

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

المراجعة	تاريخ النشر	التعليقات
2.0	26-Oct-2026	تقويم
1.0	20-Mar-2017	الإصدار الأولي