موصل تنبيهات Armis (باستخدام Azure Functions) ل Microsoft Sentinel

يمنح موصل تنبيهات Armis القدرة على استيعاب تنبيهات Armis في Microsoft Sentinel من خلال واجهة برمجة تطبيقات Armis REST. راجع وثائق واجهة برمجة التطبيقات: https://<YourArmisInstance>.armis.com/api/v1/docs لمزيد من المعلومات. يوفر الموصل القدرة على الحصول على معلومات التنبيه من منصة Armis وتحديد التهديدات وتحديد أولوياتها في بيئتك. يستخدم Armis بنيتك الأساسية الحالية لاكتشاف الأجهزة وتحديدها دون الحاجة إلى نشر أي عوامل.

هذا محتوى تم إنشاؤه تلقائيا. للحصول على تغييرات، اتصل بموفر الحل.

سمات الموصل

سمة الموصل	‏‏الوصف
التعليمات البرمجية لتطبيق وظائف Azure	https://aka.ms/sentinel-ArmisAlertsAPI-functionapp
الاسم المستعار لدالة Kusto	ArmisAlerts
عنوان URL لدالة Kusto	https://aka.ms/sentinel-ArmisAlertsAPI-parser
جدول (جداول) Log Analytics	Armis_Alerts_CL
دعم قواعد جمع البيانات	غير مدعوم حاليًا
مدعومة من قبل	شركة Armis

عينات الاستعلام

أحداث تنبيه Armis - جميع أنشطة التنبيهات.

Armis_Alerts_CL

| sort by TimeGenerated desc

المتطلبات الأساسية

للتكامل مع تنبيهات Armis (باستخدام Azure Functions) تأكد من أن لديك:

• أذونات Microsoft.Web/sites: مطلوب أذونات القراءة والكتابة إلى Azure Functions لإنشاء تطبيق دالة. راجع الوثائق لمعرفة المزيد حول Azure Functions.
• بيانات اعتماد/أذونات واجهة برمجة تطبيقات REST: مفتاح Armis السري مطلوب. راجع الوثائق لمعرفة المزيد حول واجهة برمجة التطبيقات على https://<YourArmisInstance>.armis.com/api/v1/doc

إرشادات تثبيت المورد

إشعار

يستخدم هذا الموصل Azure Functions للاتصال بواجهة برمجة تطبيقات Armis لسحب سجلاته إلى Microsoft Sentinel. قد يؤدي ذلك إلى تكاليف استيعاب بيانات إضافية. تحقق من صفحة تسعير Azure Functions للحصول على التفاصيل.

(خطوة اختيارية) تخزين مساحة العمل ومفتاح (مفاتيح) تخويل واجهة برمجة التطبيقات بشكل آمن أو الرمز المميز (الرموز المميزة) في Azure Key Vault. Azure Key Vault يوفر آلية آمنة لتخزين القيم الرئيسية واستردادها. اتبع هذه الإرشادات لاستخدام Azure Key Vault مع Azure Function App.

إشعار

يعتمد موصل البيانات هذا على محلل يستند إلى وظيفة Kusto للعمل كما هو متوقع. اتبع هذه الخطوات لإنشاء الاسم المستعار لدالات Kusto، ArmisAlerts

الخطوة 1 - خطوات التكوين لواجهة برمجة تطبيقات Armis

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

1. تسجيل الدخول إلى مثيل Armis الخاص بك
2. انتقل إلى الإعدادات -> إدارة واجهة برمجة التطبيقات
3. إذا لم يتم إنشاء المفتاح السري بالفعل، فاضغط على الزر إنشاء لإنشاء المفتاح السري
4. للوصول إلى المفتاح السري، اضغط على الزر إظهار
5. يمكن الآن نسخ المفتاح السري واستخدامه أثناء تكوين موصل تنبيهات Armis

الخطوة 2 - اختر واحدا من خياري النشر التاليين لنشر الموصل ودالة Azure المقترنة

هام: قبل نشر موصل بيانات تنبيه Armis، يكون معرف مساحة العمل والمفتاح الأساسي لمساحة العمل (يمكن نسخهما من التالي) متاحين بسهولة..، بالإضافة إلى مفتاح (مفاتيح) تخويل API Armis

الخيار 1 - قالب Azure Resource Manager (ARM)

استخدم هذا الأسلوب للتوزيع التلقائي لموصل Armis.

1. انقر فوق الزر Deploy to Azure أدناه.

   

2. حدد الاشتراك المفضل ومجموعة الموارد والموقع.

3. أدخل المعلومات أدناه:

   • اسم الدالة
   • Workspace ID
   • مفتاح مساحة العمل
   • مفتاح Armis السري
   • Armis URL https://<armis-instance>.armis.com/api/v1/
   • اسم جدول تنبيه Armis
   • جدول Armis
   • تجنب التكرارات (الافتراضي: صحيح)

4. ضع علامة على خانة الاختيار المسماة أوافق على الشروط والأحكام المذكورة أعلاه.

5. انقر فوق شراء للنشر.

الخيار 2 - النشر اليدوي لوظائف Azure

استخدم الإرشادات التالية خطوة بخطوة لنشر موصل بيانات تنبيه Armis يدويا باستخدام Azure Functions (النشر عبر Visual Studio Code).

1. نشر تطبيق الوظائف

ملاحظة: ستحتاج إلى إعداد تعليمة VS البرمجية لتطوير دالة Azure.

1. قم بتنزيل ملف Azure Function App . استخراج الأرشيف إلى كمبيوتر التطوير المحلي الخاص بك.

2. ابدأ تشغيل رمز VS. اختر ملف في القائمة الرئيسية وحدد فتح مجلد.

3. حدد مجلد المستوى الأعلى من الملفات المستخرجة.

4. اختر أيقونة Azure في شريط النشاط، ثم في منطقة Azure: Functions ، اختر الزر Deploy to function app . إذا لم تكن قد سجلت الدخول بالفعل، فاختر أيقونة Azure في شريط النشاط، ثم في منطقة Azure: Functions ، اختر تسجيل الدخول إلى Azure إذا كنت قد سجلت الدخول بالفعل، فانتقل إلى الخطوة التالية.

5. قدِّم المعلومات التالية في المطالبات:

   أ. تحديد المجلد: تحديد مجلد من مساحة عملك أو استعراض مجلد يتضمن تطبيق الدوال.

   ب. حدد الاشتراك: اختر الاشتراك الذي تريد استخدامه.

   جـ. حدد Create new Function App في Azure (لا تحدد الخيار Advanced)

   د. أدخل اسمًا فريدًا عالميًا لتطبيق الوظائف:اكتب اسمًا صالحًا في مسار URL. يتم التحقق من صحة الاسم الذي تكتبه للتأكد من أنه فريد في دالات Azure. (على سبيل المثال ARMISXXXXX).

   هـ. حدد وقت التشغيل: اختر Python 3.8 أو أعلى.

   و. حدد موقعًا للموارد الجديدة. للحصول على أداء أفضل وتكاليف أقل، اختر نفس المنطقة التي يوجد فيها Microsoft Sentinel.

6. ستبدأ عملية التوزيع. يعرض تنبيه بعد إنشاء تطبيق الوظيفة وتطبيق حزمة التوزيع.

7. انتقل إلى مدخل Microsoft Azure لتكوين Function App.

2. تكوين تطبيق الوظائف

1. في Function App، حدد Function App Name وحدد Configuration.
2. في علامة التبويب إعدادات التطبيق، حدد + إعداد التطبيق الجديد.
3. أضف كل إعداد من إعدادات التطبيق التالية بشكل فردي، مع قيمها الخاصة (حساسة لحالة الأحرف):
   • Workspace ID
   • مفتاح مساحة العمل
   • مفتاح Armis السري
   • Armis URL https://<armis-instance>.armis.com/api/v1/
   • اسم جدول تنبيه Armis
   • جدول Armis
   • تجنب التكرارات (الافتراضي: صحيح)
   • logAnalyticsUri (اختياري)

• استخدم logAnalyticsUri لتجاوز نقطة نهاية واجهة برمجة تطبيقات تحليلات السجل للسحابة المخصصة. على سبيل المثال، بالنسبة للسحابة العامة، اترك القيمة فارغة؛ بالنسبة لبيئة سحابة Azure GovUS، حدد القيمة بالتنسيق التالي: https://<CustomerId>.ods.opinsights.azure.us.

4. بمجرد إدخال جميع إعدادات التطبيق، انقر فوق حفظ.

الخطوات التالية

لمزيد من المعلومات، انتقل إلى الحل ذي الصلة في Azure Marketplace.