تهيئة موصل أنشطة تسجيل الدخول لـ Microsoft Entra ID (Azure AD)

تشرح هذه المقالة كيفية تهيئة موصل Microsoft Entra ID (سابقًا Entra ID) لدمج بيانات تسجيل الدخول في Entra ID مع أحداث Cato ولوحة معلومات الأنشطة السحابية.

نظرة عامة عن موصلات Microsoft

لتهيئة موصل Microsoft Entra ID الخاص بـ Cato لجلب بيانات تسجيل الدخول، يجب أولًا تهيئة موصل Microsoft 365 كتطبيق رئيسي لمنح أذونات القراءة لموصل Entra ID. برنامج الأم لديه الأذونات فقط لإدارة موصلات Microsoft. بعد تهيئة موصل Microsoft 365، يمكنك تهيئة موصل Entra ID لاسترجاع بيانات تسجيل الدخول.

إذا كنت ترغب في استيراد بيانات تسجيل الدخول من منظمات فرعية مختلفة داخل منظمتك، أنشئ موصل Microsoft 365 منفصل لكل مستأجر Azure ذي صلة، ثم قم بتهيئة موصل Entra ID لكل مستأجر.

المتطلبات السابقة

• يتطلب تراخيص Microsoft 365 E3 أو أفضل، أو خطة Entra ID P1 أو P2 منفصلة.

• يتطلب موصل Microsoft 365 وجود مسؤول لديه دور المسؤول العالمي لمنح الأذونات لموصل Entra ID من Cato.

الأذونات المطلوبة لموصل Microsoft Entra ID

للسماح لموصل Entra ID باسترجاع بيانات تسجيل الدخول لحسابك، يمنح الموصل لـ Cato الأذونات والإجراءات التالية مع Microsoft 365:

• الاتصال بواجهات برمجة تطبيقات Microsoft وقراءة جميع بيانات Microsoft Entra ID للمنظمة.

• تسجيل الدخول وقراءة ملف تعريف المستخدم.

تكوين موصلات مايكروسوفت

لإعداد تكامل Entra ID، تحتاج إلى:

1. إنشاء تكامل مستأجر MS (إذا لم يكن هذا قد تم تكوينه بالفعل)

2. إنشاء الموصل API في CMA

الخطوة 1: تكوين تكامل مستأجر MS

أولا، قم بتكوين تكامل المستأجر MS باعتباره الموصل الأساسي. يمكن استخدام هذا الموصل لجميع تكاملات مايكروسوفت. إذا كنت قد أنشأت الموصل الأساسي بالفعل، فانتقل إلى الخطوة 2.

لإنشاء الموصل الرئيسي لـ Microsoft 365:

1. من قائمة التنقل، اختر الموارد > التكاملات واضغط على علامة تبويب التطبيقات المتكاملة.

2. اضغط على جديد. يفتح لوحة موصل جديد.

3. في اللوحة موصل جديد، حدد تطبيق Microsoft 365 (مستأجر جديد).

   

4. ادخل اسم الموصل.

5. انقر على تفويض وحفظ.

   تفتح علامة تبويب متصفح جديدة على تطبيق مايكروسوفت 365.

6. في علامة تبويب المتصفح الجديدة، صادق نفسك مع تطبيق Microsoft 365:

   1. اختر حساب Microsoft للتطبيق Microsoft 365.

   2. أدخل كلمة المرور للتطبيق وقم بالموافقة عليها.

   3. اقبل الأذونات للسماح لكاتو بالوصول إلى تطبيق مايكروسوفت 365.

   4. يظهر على الشاشة أنك نجحت في تطبيق الأذونات للتطبيق.

      

      يمكنك إغلاق علامة التبويب في المتصفح والعودة إلى تطبيق إدارة Cato.

7. تتم إضافة تطبيق SaaS مايكروسوفت 365 إلى علامة تبويب التطبيقات المتكاملة.

   

الخطوة 2: تكوين موصل Entra ID

بعد إنشاء تكامل مستأجر MS، يمكنك إنشاء موصل Entra ID.  

تنويه:

عند إنشاء موصل API لتطبيق Microsoft 365، يقوم الموصل بإنشاء شهادة مصادقة صالحة لمدة 3 أشهر، ويجدد الشهادة قبل 7 أيام من انتهاء الصلاحية.

لتهيئة موصل Microsoft Entra ID:

1. من قائمة التنقل، اختر الموارد > التكاملات واضغط على علامة تبويب التطبيقات المتكاملة.

2. انقر فوق جديد. يفتح لوحة موصل جديد.

3. من قائمة السحب تطبيق Saas, اختر Microsoft Entra ID.

   

4. اختر أنشطة تسجيل الدخول.

5. في القائمة المنسدلة Auth, اختر موافقة Microsoft

6. أضف اسمًا ووصفًا للموصل.

7. في القائمة المنسدلة ID الرئيسي, اختر المستأجر الرئيسي لـ Microsoft الذي تم إنشاؤه في الخطوة 1.

8. انقر حفظ.

   يتصل الـCMA بالمورد

9. انقر الموافقة.

   ستظهر شاشة الأذونات الخاصة بمايكروسوفت.

10. تحقق من الأذونات المطلوبة وانقر قبول.

    التطبيق مرئي في جدول التطبيقات المتكاملة مع حالة متصل.

فهم حالة الموصل

تعرض عمود الحالة في صفحة إعدادات الموصلات حالة الاتصال بين تطبيق Microsoft وحساب Cato الخاص بك. هذه هي توضيحات الحالتين:

• متصل - حسابك متصل بالتطبيق ويعمل بشكل صحيح.

• في انتظار موافقة المستخدم - لم تتم الموافقة على الأذونات للسماح لـ Cato بالوصول إلى تطبيق Microsoft 365. لحل هذه المشكلة، قم بتحديث المستعرض. إذا تغيرت الحالة إلى متصل، فالمشكلة قد حُلت، إذا لم تتغير الحالة، احذف وأعد إنشاء الموصل.

• خطأ - يوجد مشكلة في الاتصال، الأذونات، أو غيرها مع موصل Microsoft. احذف واعِد إنشاء الموصل.

Cato Event وحقول API لتسجيلات الدخول في Entra ID

هذه هي الحقول ذات الصلة لأحداث تسجيل الدخول في Entra ID من النوع الفرعي تسجيل دخول التطبيق.

استعلام eventsFeed الخاص بـ API لـ Cato يعرض البيانات لتسجيلات الدخول في Entra ID في هذه الحقول لنوع eventFieldName، يمكنك رؤية وصف الحقول: هنا.