Gato (Github Attack TOolkit)

Инструмент, который позволяет выявлять и эксплуатировать уязвимости конвейеров в публичных и приватных репозиториях организации на GitHub. Содержит возможности пост-эксплуатации для использования скомпрометированного токена персонального доступа и возможность поиска секретов в GitHub Actions и артефактах публичных репозиториев.

Характеристики
🔺Перечисление привилегий классического GitHub PAT (Personal Access Token)
🔺Перечисление на основе GitHub Code Search API
🔺Перечисление с помощью поиска SourceGraph
🔺Разбор логов запусков GitHub Actions для выявления self-hosted раннеров
🔺Разбор workflow GitHub Actions
🔺Автоматическое выполнение команд через создание форк-pull request
🔺Автоматическое выполнение команд через создание workflow
🔺Автоматическая эксфильтрация секретов из workflow
🔺Поддержка SOCKS5-прокси, HTTPS-прокси
🔺Сканирование секретов в артефактах workflow GitHub Actions

🔺Установка

git clone https://github.com/praetorian-inc/gato && cd gato
python3 -m venv venv && source venv/bin/activate
pip install .

Для работы инструмента требуется классический токен GitHub или токен для установки приложения. Чтобы создать его, необходимо войти в GitHub => Настройки разработчика GitHub => Generate New Token => Generate new token (classic).

После создания этого токена установите переменную среды GH_TOKEN в своей оболочке, выполнив команду export GH_TOKEN=<YOUR_CREATED_TOKEN>. Либо сохраните токен в безопасном менеджере паролей и вводите его при появлении запроса в приложении. При создании токена должно быть как минимум разрешения Actions:read и Contents:read для выполнения модулей перечисления.

🔺Примеры использования
После установки инструмента его можно запустить, введя команду gato или praetorian-gato. Просматривать параметры базового инструмента можно с помощью gato -h, а параметры каждого из модулей инструмента — с помощью следующих команды:
🔺gato search -h
🔺gato enum -h
🔺gato attack -h

Сперва необходимо проверить токен gato e -v.
Допустим ваша цель - EvilCorp. Данная команда выведет список всех репозиториев evilcorp в GitHub. Она определит права доступа пользователя к каждому репозиторию и предоставит информацию о том, к чему у этого пользователя есть доступ.

gato -s e -t evilcorp -oJ evilcorp_gato.json

Если инструмент обнаружил, что пользователь может получить доступ к секретным данным из EvilRepository, и, поскольку токен имеет область действия рабочего процесса, пользователь может украсть их с помощью следующей команды.

gato -s attack -t evilcorp/evilrepository --secrets --delete-action