Box: Настройка интеграции для App Activities

Эта статья объясняет, как настроить интеграцию App Activities для Box

Обзор

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

Для настройки интеграции App Activities необходимо:

Настроить интеграцию в SaaS-программе
Создать API-коннектор в CMA

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

Настройка интеграции Box

Для настройки интеграции Box создайте платформенное приложение.

Предварительные требования

Вы должны приобрести лицензию Box Enterprise

Шаг 1: Настроить интеграцию в Центре разработчиков Box

В Центре разработчиков Box найдите идентификаторы Enterprise ID и Client ID для ввода в CMA.

Чтобы настроить интеграцию Box:

Авторизуйтесь в Центре разработчиков Box (https://<your_tenant>.app.box.com/developers/console)
На странице My Platform Apps нажмите Create Platform App
Нажмите Custom App.
Добавьте имя для приложения
В поле Purpose выберите Integration, а в поле Category выберите Security & Compliance и нажмите Next.
Выберите Server Authentication (Client Credentials Grant) и нажмите Create App.
На странице General Settings скопируйте Enterprise ID, чтобы добавить его в CMA.
На странице Настроить:
- Нажмите Получить секрет клиента. Скопируйте Client Secret и Client ID, чтобы добавить их в CMA.
  
  Примечание: Двухфакторная аутентификация должна быть включена для отображения Client Secret.
- Выберите Доступ к приложениям и предприятиям
На странице Авторизация нажмите Проверить и отправить.
Администратор учетной записи Box получает электронное письмо, из которого требуется подтвердить интеграцию.

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

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

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

В меню навигации выберите Resources > Integrations.
Откройте вкладку Integrated Apps.
Нажмите New.

Откроется панель New Integration.
Выберите SaaS-приложение, которое хотите добавить.
В выпадающем списке Capability выберите App Activities.
Добавьте сведения, созданные на первом этапе.
Нажмите Save.
Приложение видно в таблице Integrated Apps со статусом Connected.

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

Источники

Авторизация - с использованием конечной точки OAuth
События - выполнение запросов к конечной точке Events с использованием admin_logs stream_type

Известные ограничения

Все события в настоящее время извлекаются