В этой статье объясняется, как настроить интеграцию App Activities для GitHub.
Обзор
Активности приложений предоставляют вам решение на основе API для внеполосной видимости всех действий, осуществляемых любым пользователем в подключённом SaaS-приложении. Чтобы обеспечить активности приложений видимость данных в приложении, необходимо настроить интеграцию с требуемым приложением. После создания интеграции, если поле изменилось или истекло, его можно отредактировать на странице Ресурсы > Интеграции > Интегрированные приложения. Для получения дополнительной информации см. Глossарий контроля приложений через API с использованием активности приложений.
Чтобы настроить интеграцию активностей приложений, необходимо:
Настроить интеграцию внутри SaaS-приложения
Создать конечный API-коннектор в CMA
Требуется лицензия CASB для активности приложений. Эта лицензия включает контроль приложений и данных и Активности приложений через API. Для получения информации о покупке лицензии CASB обратитесь к вашему представителю Cato.
Преимущества подключения GitHub
После создания этого конечного коннектора, вы можете просматривать и контролировать активность в вашей GitHub среде. Пример,
Входы пользователей
Клонирование репозиториев
Фиксации
Запросы на вытягивание
Изменение настроек репозиториев/организаций
Оповещения о проверках кода/уязвимостей
Это помогает вам выявить и реагировать на подозрительную активность, и вы можете получать оповещения о следующих действиях:
Проверки безопасности кода
Проверки на уязвимости (Dependabot)
Проверки секретов
Настройка интеграции GitHub
Чтобы настроить интеграцию GitHub, создайте новый персональный токен доступа.
Предварительные условия
Вы должны приобрести лицензию GitHub Enterprise
Предоставлены следующие области (разрешения):
Пользователь - read:user
Аудит_лог - read:audit_log
Орг - read:org
Предприятие - read:enterprise
Репозиторий - События безопасности: чтение
Заметка:
С марта 2026 года коннектор GitHub сможет собирать события безопасности для аудита и межплатформенной корреляции. Если вы создали этот коннектор до марта 2026 года, вам нужно регенерировать токен доступа с дополнительной областью
security_events:readи добавить новый токен в CMA.Чтобы регенерировать токен доступа, в Центре разработчиков GitHub выберите существующий токен, используемый для интеграции Cato. Нажмите Сгенерировать токен-носитель и в разделе Репозиторий убедитесь, что выбран
security_events:read. Нажмите Сгенерировать токен-носитель, чтобы применить изменения. Следуйте шагу 2 ниже, чтобы добавить новый токен в CMA.
Шаг 1: Настройте интеграцию в GitHub Developer Center
В GitHub Developer Center определите токен доступа, который будет введён в CMA.
Чтобы настроить интеграцию GitHub:
В Центре разработчиков GitHub перейдите в Personal access tokens > Tokens (classic).
Нажмите Сгенерировать новый токен.
Установите дату окончания срока действия токена.
Рекомендуем установить дату истечения срока на максимальный допустимый период 1 год.
Добавьте приведенные выше области.
Нажмите Сгенерировать токен.
Копируйте и сохраните новый токен доступа, чтобы его можно было добавить в Приложение Управления Cato.
Перейдите в Настройки > Предприятия.
Щелкните по имени вашего предприятия.
Отображается страница входа в вашу организацию.
Скопируйте и сохраните последний сегмент URL, чтобы он мог быть добавлен в CMA. Например, в URL
https://github.com/enterprises/cato, копируйте и сохранитеcato.
Шаг 2: Создание API-коннектора в CMA
После настройки интеграции с необходимым приложением, добавьте информацию в CMA.
Чтобы создать API коннектор в CMA:
В меню навигации нажмите Ресурсы > Интеграции.
Перейдите на вкладку Настроенные интеграции.
Нажмите на Новый.
Открывается панель Новая Интеграция.
Выберите Приложение SaaS, которое вы хотите добавить.
В выпадающем списке Возможности выберите Активности приложений.
Добавьте подробности, созданные на первом этапе.
Нажмите Save.
Приложение видно на таблице Интегрированных приложений с статусом Подключено.
После подключения ваших API вы можете отслеживать активности приложений на панели облачной активности. Данные могут появиться через несколько минут.
Известное Ограничение
Все события извлекаются
Источники
Конечная точка аудита предприятия - Запрос к конечной точке событий
GraphQL и конечная точка пользователей - Запрос информации о пользователях GitHub.