Настройка Коннектора <b>Microsoft Entra ID (Azure AD)</b> для Активностей Входа

В этой статье объясняется, как настроить коннектор 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 APIs и прочитать все данные Microsoft Entra ID (Entra ID) для организации.

• Вход в систему и чтение профиля пользователя.

Настройка конечных коннекторов Microsoft

Чтобы настроить интеграцию Entra ID, необходимо:

1. Создать интеграцию арендатора MS (если она еще не настроена)

2. Создать API-коннектор в CMA

Шаг 1: Настроить интеграцию арендатора MS

Сначала настройте интеграцию арендатора MS как основного коннектора. Этот коннектор может быть использован для всех интеграций Microsoft. Если вы уже создали основной коннектор, перейдите к шагу 2.

Чтобы создать главный коннектор Microsoft 365:

1. Из меню навигации выберите Ресурсы > Интеграции и нажмите вкладку Интегрированные приложения.

2. Нажмите Новое. Панель Новый коннектор открывается.

3. На панели Новый разъем выберите приложение Microsoft 365 (новый арендатор).

   

4. Введите Имя Коннектора.

5. Нажмите Авторизовать и Сохранить.

   Открывается новая вкладка браузера с приложением Microsoft 365.

6. В новой вкладке браузера выполните аутентификацию в приложении Microsoft 365:

   1. Выберите учетную запись для приложения Microsoft 365.

   2. Введите пароль для приложения и подтвердите его.

   3. Примите разрешения, чтобы Cato мог получить доступ к приложению Microsoft 365.

   4. Экран показывает, что разрешения для приложения были успешно применены.

      

      Вы можете закрыть вкладку браузера и вернуться к Приложению Управления Cato.

7. Приложение SaaS Microsoft 365 добавлено на вкладку Интегрированные приложения.

   

Шаг 2: Настроить конечный коннектор Entra ID

После создания интеграции арендатора MS, можно создать конечный коннектор Entra ID.  

Заметка:

Когда вы создаете коннектор API для приложения Microsoft 365, коннектор создает аутентификационный сертификат, который действителен в течение 3 месяцев, и обновляет сертификат за 7 дней до истечения срока действия.

Чтобы настроить коннектор Microsoft Entra ID:

1. Из меню навигации выберите Ресурсы > Интеграции и нажмите вкладку Интегрированные приложения.

2. Нажмите Новое. Панель Новый коннектор открывается.

3. Из выпадающего меню Saas-приложение выберите Microsoft Entra ID.<\/span>

   

4. Выбрать Активность входа в систему.

5. В выпадающем меню Auth выберите Согласие Microsoft.

6. Добавить Имя и Описание для коннектора.

7. В раскрывающемся списке Parent ID, выберите Основной арендатор Microsoft, созданный на Шаге 1.

8. Нажмите Сохранить.

   CMA подключается к поставщику

9. Нажмите Авторизовать.

   Появится окно разрешений Microsoft.

10. Пересмотрите запрашиваемые разрешения и нажмите Принять.

    Приложение отображается на таблице интегрированных приложений со статусом Подключено.

Понимание статуса подключения

Столбец Статус на странице Настройки коннекторов показывает статус подключения между приложением Microsoft и вашим аккаунтом Cato. Вот объяснения состояний:

• Подключено - Ваш аккаунт подключен к приложению и работает правильно.

• Ожидание согласия пользователя - Разрешения не были предоставлены, чтобы дать Cato доступ к приложению Microsoft 365. Чтобы устранить эту проблему, обновите браузер. Если Статус изменится на Подключено, проблема решена, если Статус не изменится, удалите и создайте коннектор заново.

• Ошибка - Имеется проблема с подключением, разрешениями или другая ошибка с коннектором Microsoft. Удалите и создайте коннектор заново.

Поля событий Cato и API для входов Entra ID

Это соответствующие поля для событий входа Entra ID подтип Вход в приложение.

Запрос eventsFeed API Cato показывает данные для входов Entra ID в этих полях для типа eventFieldName, вы можете увидеть описания полей: здесь.