Быстрый настраиваемый сканер секретов, который ищет утёкшие учётные данные в git-репозиториях, файлах, GitHub, GitLab, S3 и других источниках.
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
Установите ggshield с помощью pipx (требуются Python и git)
pipx install ggshield - 2
Пройдите аутентификацию на серверах GitGuardian
ggshield auth login - 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 обновляется ежедневно.
Похожие проекты
Сканер секретов на Rust, который находит утёкшие учётные данные, проверяет, активны ли они, определяет доступы и поддерживает отзыв.
Сканер безопасности с приоритетом на AI: проверяет код и конфигурации AI-агентов, включая приложения на LLM, MCP-серверы и секреты в истории чатов и командной оболочки.
CLI-инструмент для поиска захардкоженных секретов — паролей, API-ключей и токенов — в git-репозиториях, файлах и stdin.
Инструмент статического анализа, который находит и помогает исправлять проблемы безопасности в конфигурациях CI/CD, включая GitHub Actions, Dependabot и pre-commit.
Сканирует конфигурации AI-инструментов разработки (Claude Desktop, Cursor, VS Code) и исходный код MCP-серверов на предмет утечек секретов, API-эндпоинтов, AI-моделей и рисков shell-инъекций.