Приложения Microsoft (включая Copilot): Настройка интеграции активностей приложений

Prev Next

Эта статья объясняет, как настроить интеграцию App Activities для приложений Microsoft.

Для всех этих приложений требуется одинаковый процесс настройки интеграции.

Обзор

Активности приложений предоставляют вам решение на основе API для внеполосной видимости всех действий, осуществляемых любым пользователем в подключённом SaaS-приложении. Чтобы обеспечить активности приложений видимость данных в приложении, необходимо настроить интеграцию с требуемым приложением. После создания интеграции, если поле изменилось или истек срок действия, вы можете редактировать токен доступа на странице Ресурсы > Интеграции > Интегрированные приложения. Для получения дополнительной информации см. Что такое контроль приложения через API с активностями приложений.

Чтобы настроить интеграцию активностей приложений, необходимо:

  1. Настроить интеграцию внутри SaaS-приложения

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

Требуется лицензия CASB для активности приложений. Эта лицензия включает контроль приложений и данных и Активности приложений через API. Для получения информации о покупке лицензии CASB обратитесь к вашему представителю Cato.

Все активности (называемые Операциями в Microsoft Exchange) извлекаются.

Преимущества подключения приложений Microsoft

После создания этого конечного коннектора, вы можете просматривать и отслеживать активность в ваших приложениях Microsoft, например:

  • Office (например, Word, PowerPoint, Excel)

  • CoPilot

  • Power BI

Это помогает вам выявить и реагировать на подозрительную активность, и вы можете получать оповещения о следующих действиях:

  • Подозрительная пересылка входящих сообщений

  • Необычный объем удаления файлов

  • Активность с подозрительного IP-адреса

  • Оповещения о фишинге/спаме

Поддерживаемые приложения

Эта таблица перечисляет поддерживаемые приложения Microsoft и конечные коннекторы, которые необходимо настроить для каждого из них

Все четыре приложения настроены с помощью одного процесса, изложенного ниже

Приложение

Конечные коннекторы

Приложения Microsoft 356

  • Entra ID

Microsoft Entra ID

  • Exchange

Microsoft Exchange

  • SharePoint

  • OneDrive для бизнеса

Microsoft SharePoint и OneDrive для бизнеса

Настройка интеграции приложений Microsoft

Чтобы настроить интеграцию, создайте приложение API.

Необходимые условия

  • Вы должны иметь одну из этих лицензий:

    • Microsoft 365 E3

    • Лицензия Microsoft 365 E3 с дополнением E5 Compliance

    • Лицензия Microsoft 365 E3 с дополнением E5 eDiscovery и Audit

    • Лицензия Office 365 E5

  • У вас должны быть права администратора в центре администрирования Microsoft Entra

  • Журнал аудита Office 365 включен. Для получения дополнительной информации смотрите документацию Microsoft

  • Ваш глобальный административный аккаунт назначен требуемыми административными ролями и в Microsoft Purview и Exchange, а услуги находятся в полном объеме (полностью выделены). Для этого:

    1. Убедитесь, что ваш административный аккаунт является Глобальным Администратором в Microsoft 365

    2. Назначьте аккаунту административные роли как в Microsoft Purview, так и в Microsoft Exchange

    3. Войдите в порталы Purview и Exchange, чтобы инициировать полный объем

    4. Чтобы убедиться, что аудит включен и роли вступили в силу, через 60 минут повторно выполните команду UnifiedAuditLogIngestion после завершения распространения

Шаг 1: Создайте интеграцию арендатора MS

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

Чтобы создать интеграцию с MS Tenant:

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

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

  3. На панели Новый коннектор выберите приложение Арендатор MS (Настроить новый арендатор MS).

    New_Microsoft_365_Connector.png

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

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

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

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

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

      В противном случае, может возникнуть ошибка аутентификации Microsoft.

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

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

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

      Success_Connector_Permissions.png

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

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

Шаг 2: Создайте API соединитель в CMA

После создания интеграции с необходимым приложением добавьте детали в CMA.

Чтобы создать API коннектор в CMA:

  1. В навигационном меню нажмите Ресурсы > Интеграции.

  2. Нажмите вкладку Интегрированные приложения.

  3. Нажмите Новый.

    Откроется панель Новая интеграция.

  4. Выберите Приложение SaaS, которое хотите добавить.

  5. Выбрать Активности приложений.

  6. Выберите Основной арендатор Microsoft, созданный на этапе 1.

  7. (Опционально) Добавить описание.

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

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

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

    image-20250826-133358.png

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

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

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

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

Источники

  • POST https://login.microsoftonline.com/{{tenant_id}}/oauth2/v2.0/token - Вход

  • GET https://manage.office.com/api/v1.0/{{tenant_id}}/activity/feed/subscriptions/list - Подтверждение того, что аудит включен

  • POST https://manage.office.com/api/v1.0/{{tenant_id}}/activity/feed/subscriptions/start?contentType={{audit_name}} - Включение аудита (если необходимо):

  • GET https://manage.office.com/api/v1.0/{{tenant_id}}/activity/feed/subscriptions/content?contentType={{audit_name}}&startTime={{start_time}}&;endTime={{end_time}} - Составление списка аудита

  • GET к URI событий, полученным из предыдущего ответа