Repolode
GitGuardian

GitGuardian/ggshield

CLI для поиска и проверки более 500 типов секретов, жёстко заданных в файлах, Git-репозиториях, Docker-образах и пакетах; работает как pre-commit hook или в CI.

Звёзды
2,012
Форки
221
Открытые issues
69
Последний коммит
вчера

Что это?

ggshield — CLI-инструмент от GitGuardian для поиска жёстко заданных секретов, например API-ключей и учётных данных, прежде чем они утекут. Он сканирует локальные файлы, Git-репозитории, Docker-образы и пакеты PyPI и может работать как на компьютере разработчика, так и в CI-пайплайне.

Инструмент обращается к публичному API GitGuardian для обнаружения и проверки секретов. Его можно подключить к Git-хукам pre-commit, pre-push и pre-receive, а также к GitHub Actions. Во время сканирования сохраняются только метаданные — например, время вызова, размер запроса и режим сканирования, — поэтому найденные значения секретов не попадают на дашборд.

Также инструмент может устанавливать хуки для проверки взаимодействий с AI-ассистентами для программирования, такими как Cursor, Claude Code, Copilot Chat и Codex, блокируя действия с секретами до их выполнения.

Ключевые возможности

  • 01Обнаруживает более 500 типов секретов и проверяет их.
  • 02Сканирует файлы, Git-репозитории, Docker-образы и пакеты PyPI.
  • 03Работает как Git-хук pre-commit, pre-push или pre-receive.
  • 04Предоставляет GitHub Action и интеграцию с CI/CD.
  • 05Устанавливает хуки для проверки взаимодействий с AI-ассистентами для программирования.
  • 06Устанавливается на macOS, Linux и Windows через pip, pipx, Homebrew или пакеты.

Сценарии использования

  • Блокировка попадания секретов в репозиторий с помощью хуков pre-commit.
  • Поиск утёкших учётных данных в CI-пайплайнах до развёртывания.
  • Проверка существующей истории Git или Docker-образов на наличие жёстко заданных ключей.
  • Предотвращение выполнения AI-ассистентами для программирования действий, содержащих секреты.

Быстрый старт

  1. 1

    Установите ggshield с помощью pipx (требуются Python и git)

    pipx install ggshield
  2. 2

    Пройдите аутентификацию на серверах GitGuardian

    ggshield auth login
  3. 3

    Просканируйте текущий каталог на наличие секретов

    ggshield secret scan path -r .

Что важно знать

  • Для сканирования требуется аутентификация на серверах GitGuardian; используется их общедоступный API.
  • При установке из PyPI требуется поддерживаемая версия Python, срок поддержки которой не истёк (не EOL), а также git.
  • В macOS при обновлении до версии 1.54.0 появляется запрос Keychain для бинарного файла ggshield-py.

В подборках

Темы

Частые вопросы

Что такое ggshield?
CLI для поиска и проверки более 500 типов секретов, жёстко заданных в файлах, Git-репозиториях, Docker-образах и пакетах; работает как pre-commit hook или в CI. ggshield — CLI-инструмент от GitGuardian для поиска жёстко заданных секретов, например API-ключей и учётных данных, прежде чем они утекут. Он сканирует локальные файлы, Git-репозитории, Docker-образы и пакеты PyPI и может работать как на компьютере разработчика, так и в CI-пайплайне.
ggshield можно использовать бесплатно? Какая у него лицензия?
ggshield распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ggshield всё ещё поддерживается?
Активно поддерживается. Последний коммит в ggshield — 6 нояб. 2026 г..
Для чего можно использовать ggshield?
Блокировка попадания секретов в репозиторий с помощью хуков pre-commit. Поиск утёкших учётных данных в CI-пайплайнах до развёртывания. Проверка существующей истории Git или Docker-образов на наличие жёстко заданных ключей. Предотвращение выполнения AI-ассистентами для программирования действий, содержащих секреты.
Как установить ggshield?
Установите ggshield с помощью pipx (требуются Python и git): pipx install ggshield Пройдите аутентификацию на серверах GitGuardian: ggshield auth login Просканируйте текущий каталог на наличие секретов: ggshield secret scan path -r .
Где скачать ggshield?
Исходный код и инструкции по установке — на GitHub: https://github.com/GitGuardian/ggshield

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

CLI-инструмент для поиска захардкоженных секретов — паролей, API-ключей и токенов — в git-репозиториях, файлах и stdin.

30,8 тыс.+212 за неделю2,3 тыс.GoMITОбновлён 11 дней назад