GitHub: Настройка интеграции App Activities

Prev Next

В этой статье объясняется, как настроить интеграцию App Activities для GitHub.

Обзор

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

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

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

  2. Создать конечный 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:

  1. В Центре разработчиков GitHub перейдите в Personal access tokens > Tokens (classic).

  2. Нажмите Сгенерировать новый токен.

  3. Установите дату окончания срока действия токена.

    Рекомендуем установить дату истечения срока на максимальный допустимый период 1 год.

  4. Добавьте приведенные выше области.

  5. Нажмите Сгенерировать токен.

  6. Копируйте и сохраните новый токен доступа, чтобы его можно было добавить в Приложение Управления Cato.

  7. Перейдите в Настройки > Предприятия.

  8. Щелкните по имени вашего предприятия.

    Отображается страница входа в вашу организацию.

  9. Скопируйте и сохраните последний сегмент URL, чтобы он мог быть добавлен в CMA. Например, в URL https://github.com/enterprises/cato, копируйте и сохраните cato.

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

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

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

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

  2. Перейдите на вкладку Настроенные интеграции.

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

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

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

  5. В выпадающем списке Возможности выберите Активности приложений.

  6. Добавьте подробности, созданные на первом этапе.

  7. Нажмите Save.

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

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

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

  • Все события извлекаются

Источники

  • Конечная точка аудита предприятия - Запрос к конечной точке событий

  • GraphQL и конечная точка пользователей - Запрос информации о пользователях GitHub.