Repolode
Enviar
GitGuardian

GitGuardian/ggshield

CLI que detecta e valida mais de 500 tipos de segredos hardcoded em arquivos, repositórios Git, imagens Docker e pacotes, com uso em hooks pre-commit ou no CI.

Ver no GitHubSite
Estrelas
2,012
Forks
221
Issues abertas
69
Último commit
ontem

O que é?

ggshield é uma ferramenta de linha de comando da GitGuardian que encontra segredos hardcoded, como chaves de API e credenciais, antes que vazem. Ela verifica arquivos locais, repositórios Git, imagens Docker e pacotes PyPI e pode ser executada na máquina de um desenvolvedor ou em um pipeline de CI.

A ferramenta chama a API pública da GitGuardian para detectar e validar segredos e pode ser integrada a hooks Git pre-commit, pre-push e pre-receive, além do GitHub Actions. As verificações armazenam apenas metadados, como horário da chamada, tamanho da solicitação e modo de verificação; assim, os valores dos segredos detectados não ficam no dashboard.

A ferramenta também pode instalar hooks que verificam interações com assistentes de programação com IA, como Cursor, Claude Code, Copilot Chat e Codex, bloqueando ações que contenham segredos antes de serem executadas.

Recursos principais

  • 01Detecta mais de 500 tipos de segredos e faz verificações de validação.
  • 02Verifica arquivos, repositórios Git, imagens Docker e pacotes PyPI.
  • 03Funciona como hook Git pre-commit, pre-push ou pre-receive.
  • 04Oferece uma GitHub Action e integração com CI/CD.
  • 05Instala hooks para verificar interações com assistentes de programação com IA.
  • 06Pode ser instalado no macOS, Linux e Windows via pip, pipx, Homebrew ou pacotes.

Casos de uso

  • Impedir que segredos sejam enviados para um repositório usando hooks pre-commit.
  • Verificar pipelines de CI em busca de credenciais vazadas antes da implantação.
  • Auditar o histórico existente do Git ou imagens Docker em busca de chaves hardcoded.
  • Impedir que assistentes de programação com IA executem ações que contenham segredos.

Início rápido

  1. 1

    Instale o ggshield com pipx (requer Python e git)

    pipx install ggshield
  2. 2

    Autentique-se nos servidores do GitGuardian

    ggshield auth login
  3. 3

    Verifique o diretório atual em busca de segredos

    ggshield secret scan path -r .

Antes de usar

  • A verificação requer autenticação nos servidores do GitGuardian e usa a API pública da empresa.
  • Ao instalar pelo PyPI, é necessária uma versão compatível e não descontinuada (EOL) do Python, além do git.
  • No macOS, a atualização para a versão 1.54.0 exibe uma solicitação do Keychain para o binário ggshield-py.

Em coleções

Ferramentas de CLI e terminalFerramentas de varredura, auditoria e inteligência de ameaçasFrameworks de teste e ferramentas de automação de testes

Tópicos

#secrets-detection#security#devsecops#pre-commit#cli#credentials-scanning#ci-cd#apikey#code#credentials

Perguntas frequentes

O que é ggshield?
CLI que detecta e valida mais de 500 tipos de segredos hardcoded em arquivos, repositórios Git, imagens Docker e pacotes, com uso em hooks pre-commit ou no CI. ggshield é uma ferramenta de linha de comando da GitGuardian que encontra segredos hardcoded, como chaves de API e credenciais, antes que vazem. Ela verifica arquivos locais, repositórios Git, imagens Docker e pacotes PyPI e pode ser executada na máquina de um desenvolvedor ou em um pipeline de CI.
ggshield é gratuito? Qual é a licença?
ggshield é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ggshield ainda é mantido?
Manutenção ativa. O último commit de ggshield foi em 6 de nov. de 2026.
Para que posso usar ggshield?
Impedir que segredos sejam enviados para um repositório usando hooks pre-commit. Verificar pipelines de CI em busca de credenciais vazadas antes da implantação. Auditar o histórico existente do Git ou imagens Docker em busca de chaves hardcoded. Impedir que assistentes de programação com IA executem ações que contenham segredos.
Como instalar ggshield?
Instale o ggshield com pipx (requer Python e git): pipx install ggshield Autentique-se nos servidores do GitGuardian: ggshield auth login Verifique o diretório atual em busca de segredos: ggshield secret scan path -r .
Onde consigo ggshield?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/GitGuardian/ggshield

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados