Эта статья объясняет, как настроить интеграцию Активности приложения для Google Drive и Workspace.
Обзор
Активности приложений предоставляют вам решение на основе API для внеполосной видимости всех действий, осуществляемых любым пользователем в подключённом SaaS-приложении. Чтобы обеспечить активности приложений видимость данных в приложении, необходимо настроить интеграцию с требуемым приложением. После создания интеграции, если поле изменилось или истекло, его можно отредактировать на странице Ресурсы > Интеграции > Интегрированные приложения. Для получения дополнительной информации см. Глossарий контроля приложений через API с использованием активности приложений.
Чтобы настроить интеграцию активностей приложений, необходимо:
Настроить интеграцию внутри SaaS-приложения
Создать конечный API-коннектор в CMA
Требуется лицензия CASB для активности приложений. Эта лицензия включает контроль приложений и данных и Активности приложений через API. Для получения информации о покупке лицензии CASB обратитесь к вашему представителю Cato.
Понимание интеграции с Google Workspace
Подключение вашей учетной записи Google Workspace к Cato позволяет видеть:
Активность входа пользователей: Отслеживание успешных и неудачных попыток входа всех сервисов Google Workspace (например, Gmail, Диск, Документы, Таблицы, Календарь).
Авторизации сторонних приложений (OAuth события): Мониторинг, когда пользователи входят в сторонние приложения через Google Sign-In или предоставляют внешним приложениям доступ к данным Workspace. Это включает в себя выдачу токенов, предоставленные полномочия (например, чтение/запись на Диске) и отзыв токенов.
Преимущества подключения Google Drive
После создания этого коннектора вы сможете просматривать и отслеживать активность в вашем Google Drive. Пример:
Загрузка/Скачивание файлов
Обмен файлами
Изменения разрешений
Вы также получаете доступ к различным аудитным журналам в вашей среде Google, например:
Успешность/невыполненные входы
Авторизация доступа к приложению
Модификация аккаунтов
Это помогает вам выявить и реагировать на подозрительную активность, и вы можете получать оповещения о следующих действиях:
Подозрительные входы
Рисковые чувствительные действия
Утечки паролей
Настройка интеграции Google Drive и Workspace
Чтобы настроить интеграцию Google Drive и Workspace, создайте новый проект.
Предпосылки
Необходимо приобрести лицензию Google Cloud Enterprise
Заметка:
С мая 2026 года коннектор Google Drive и Workspace сможет собирать дополнительные данные о событиях безопасности из Центра оповещений Google. Это включает данные, такие как подозрительные входы, утекшие пароли и действия администраторов с данными.
Если вы создали этот коннектор до мая 2026 года, вам нужно включить API Центра оповещений Google Workspace (шаги 7 и 8) и убедиться, что все перечисленные в шаге 22 полномочия добавлены.
Шаг 1: Настройка интеграции в Google Cloud Console
В консоли Google Cloud создайте закрытый ключ учетной записи для входа в CMA.
Настроить интеграцию Google Drive и Workspace:
В консоли Google Cloud нажмите Выбрать проект.
Нажмите Новый проект.
Выберите Имя и Местоположение, затем нажмите Создать.
Перейдите в API и сервисы > Библиотека.
Введите в поиск Admin SDK.
Нажмите на Admin SDK API и затем нажмите Включить.
Введите в поиск API Центра оповещений Google Workspace.
Нажмите на API Центра оповещений Google Workspace и затем нажмите Включить.
Перейдите в IAM и администратор > Сервисные аккаунты.
Выберите проект, который вы создали на втором шаге, и нажмите Создать сервисный аккаунт.
Добавьте ID сервисного аккаунта и нажмите Создать и продолжить.
В выпадающем меню Выберите роль выберите Менеджер аудита Администратор (вы можете найти эту роль).
Нажмите Готово.
Выберите созданный сервисный аккаунт и перейдите на вкладку Ключи,
Нажмите Добавить ключ > Создать новый ключ.
Выберите тип ключа JSON и нажмите Создать.
JSON файл, содержащий закрытый ключ, загрузится.
Скопируйте и сохраните Приватный ключ, чтобы его можно было добавить в CMA.
В консоли администратора Google перейдите в Безопасность > Доступ и контроль данных > Управление API.
Под Доменная делегация, выберите Управляйте доменной делегацией.
Нажмите Добавить новый.
Добавьте Client ID для сервисного аккаунта. Вы можете найти это на странице учетной записи услуги.
Добавьте следующие области:
https://www.googleapis.com/auth/admin.reports.audit.readonlyhttps://www.googleapis.com/auth/admin.directory.user.readonlyhttps://www.googleapis.com/auth/admin.directory.user.securityhttps://www.googleapis.com/auth/apps.alerts
Нажмите Авторизовать.
Шаг 2: Создайте API соединитель в CMA
После создания интеграции с необходимым приложением добавьте детали в CMA.
Для создания API соединителя в CMA:
Из меню навигации нажмите Ресурсы > Интеграции.
Перейдите на вкладку Настроенные интеграции.
Нажмите Создать.
Открывается панель Новая Интеграция.
Выберите Приложение SaaS, которое вы хотите добавить.
Примечание: введите Закрытый ключ в формате JSON.
В выпадающем списке Возможности выберите Активности приложений.
Добавьте подробности, созданные на этапе первом.
Примечание: JSON и адрес административной электронной почты являются необходимыми деталями для создания коннектора. Поле административного email должно включать электронную почту пользователя с ролью Супер Администратор.
Кликните Сохранить.
Приложение видно на таблице Интегрированных приложений с статусом Подключено.
После подключения ваших API вы можете отслеживать активности приложений на панели облачной активности. На появление данных может понадобиться несколько минут.
Источники
Журналы аудита Диска - Конечная точка activities/drive для запроса журналов аудита Google Drive
Журналы аудита входа - Конечная точка Activities/Login для запроса журналов аудита входов Google
Журналы аудита третьих сторон (Токен) - Конечная точка activities/token для запроса журналов аудита входов третьих сторон Google
Известные Ограничения услуг
В настоящий момент все события извлекаются в конечных точках Диск и Вход
Во входах от третьих сторон извлекаются только события, описывающие сам вход