المقدمة
يصف هذا المستند عملية تكوين تكامل Umbrella والتحقق من صحته مع SecureX مع 3 واجهات API المتاحة.
المتطلبات الأساسية
المتطلبات
توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:
- Cisco Umbrella
- Cisco Secure X
- إستجابة تهديدات الحماية من Cisco
المكونات المستخدمة
تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:
- حساب Umbrella مع ترخيص ميزة DNS
- X الآمن
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك مباشرة، فتأكد من فهمك للتأثير المحتمل لأي أمر.
معلومات أساسية
من أجل تكوين هذا التكامل بشكل كامل مع جميع وظائفه، يلزمك الوصول إلى واجهات برمجة التطبيقات الثلاثة هذه
- واجهة برمجة التطبيقات لإعداد التقارير (مضمنة في جميع التراخيص)
- واجهة برمجة التطبيقات
- التحقيق في API
لتكوين تكامل Umbrella، يجب أولا تجميع بعض المعلومات من مثيلات Umbrella الخاصة بك ثم إكمال نموذج إضافة وحدة Umbrella جديدة.
التكوين
إنشاء وحدة نمطية
- سجل الدخول إلى حساب Secure X. إذا لم يكن لديك حساب بعد، فيمكنك إنشاء حساب باستخدام تسجيل دخول آمن إلى Cisco.
- انتقل إلى عمليات التكامل > إضافة وحدة نمطية جديدة. في صفحة التكامل المتوفر انتقل لأسفل إلى خيار المظلة وانقر فوق إضافة وحدة نمطية جديدة.
أستخدم هذه الخطوات لجمع المعلومات الضرورية من حساب Umbrella الخاص بك لتقديمها في نموذج إضافة وحدة Umbrella جديدة.
التحقيق في API
- في Umbrella، انتقل إلى التحقيق > التحقق من وصول واجهة برمجة التطبيقات، وانقر فوق إنشاء رمز مميز جديد وأدخل عنوانا للرمز المميز، ثم انقر فوق إنشاء رمز مميز جديد مرة أخرى.
- انسخ قيمة الرمز المميز للوصول إلى حقل رمز API المميز على نموذج إضافة وحدة نمطية جديدة للمظلة.
واجهة برمجة التطبيقات
- في Umbrella، انتقل إلى السياسات > مكونات السياسة > عمليات التكامل، وانقر إضافة وأدخل اسما، وانقر إنشاء.
- انقر فوق إرتباط اسم التكامل الذي تم إنشاؤه حديثا، وحدد مربع Enablecheckbox وSave.
- انقر فوق اسم التكامل لعرض عنوان URL الخاص بالتكامل. انسخ عنوان URL الخاص بالتكامل إلى حقل عنوان URL الخاص بتكامل المظلة المخصص على نموذج إضافة وحدة نمطية جديدة.
ملاحظة: من أجل دمج واجهة برمجة تطبيقات Umbrella Enforcement API، يجب أن تكون مسؤول في مؤسسة أو مؤسسة فرعية مستقلة تابعة ل Umbrella بدلا من مسؤول في وحدة تحكم Umbrella.
واجهة برمجة تطبيقات إعداد التقارير
-
في Umbrella، انتقل إلى Admin > مفاتيح API وانقر فوق إنشاء.
-
تحت ماذا يجب أن تفعل واجهة برمجة التطبيقات هذه؟، انقر فوق الزر Umbrella Reporting Radio ثم انقر فوق إنشاء.
-
انسخ القيم التالية إلى حقول التقارير على نموذج إضافة وحدة نمطية جديدة للمظلة:
-
مفتاح API (مفتاحك)
-
سر واجهة برمجة التطبيقات (سر خاص بك)
-
معرف المؤسسة - من عنوان URL للمستعرض، مجموعة الأرقام بين/o/
و/#/
-
طلب الإطار الزمني (بالأيام)- أدخل الإطار الزمني (بالأيام) لإثراء المشاهدات من أحدث طلبات DNS
حفظ الوحدة النمطية
1. املأ معلومات واجهة برمجة التطبيقات (API) في وحدة Umbrella النمطية، انقر فوق حفظ.
إنشاء لوحة معلومات SecureX
1. بمجرد إضافة الوحدة النمطية الخاصة بك، يمكنك الانتقال إلى Secure X وإنشاء لوحة معلومات جديدة.
2. تحت لوحات المعلومات المتاحة، حدد وحدة Umbrella النمطية الخاصة بك وأضف الفئات التي ترغب في رؤيتها.
3. انقر فوق حفظ، وانظر معلوماتك التي يتم ملؤها عبر واجهة برمجة التطبيقات (API).
التحقق من الصحة
استخدم هذا القسم لتأكيد عمل التكوين بشكل صحيح.
نستخبر
ال Investigate API، يسمح أنت أن يضيف موجز إلى بحث CTR، أن ترى التصرف من مجال ويثري التحقيق مع وحدات أخرى.
1. للتحقق من هذا التكامل، قم بإجراء تحقيق جديد في الاستجابة لتهديدات Cisco. يمكن العثور على المصير النهائي الذي توفره Umbrella مع البحث عن مجال معروف، مثل cisco.com.
2. إذا قمت بالنقر أسفل المجال في الرسم البياني "العلاقات"، يمكنك أيضا الدوران حول محور من هناك إلى لوحة معلومات "التحقيق" في Umbrella.
إنفاذ
باستخدام واجهة برمجة تطبيقات Enforcement، يمكنك حظر مجال أو إلغاء حظره مباشرة من تحقيق.
1. للتحقق من عمل واجهة برمجة التطبيقات (API)، يمكنك حظر مجال تم الاطلاع عليه في تحقيق، وهذا يضيف المجال إلى قائمة حظر السياسات في Umbrella.
2. للتحقق من إضافة عنوان URL إلى قائمة الحظر، انتقل إلى السياسات > مكونات السياسة > عمليات التكامل. حدد تكامل SecureX، وانقر فوق رؤية المجالات. يعرض نافذة المجالات المضافة من CTR.
3. إذا لم يتم حظر المجالات، انتقل على لوحة معلومات Umbrella إلى السياسات > مكونات النهج > إعدادات الأمان. ضمن عمليات التكامل تأكد من أنك قمت بتطبيق القائمة التي تريدها.
الإبلاغ
تتيح لك واجهة برمجة تطبيقات Reporting (واجهة برمجة التطبيقات) الاطلاع على معلومات عمليات نشر Umbrella الخاصة بك داخل SecureX.
يمكنك التحقق من التكامل من خلال تحقيق في مجال تعرف أنه قد تم مشاهدته في بيئة عملك في CTR.
وفي تحقيق لجنة مكافحة الإرهاب، تعرض قائمة أجهزة الكمبيوتر التي وصلت إلى مجال معين تحت المشاهدة.
الفيديو
يمكنك العثور على معلومات التكوين المضمنة في هذه المقالة في هذا الفيديو.
معلومات ذات صلة