Repolode
Enviar
GitGuardian

GitGuardian/ggshield

CLI que detecta y valida más de 500 tipos de secretos codificados en archivos, repositorios Git, imágenes de Docker y paquetes; se puede usar como hook de pre-commit o en CI.

Ver en GitHubSitio web
Estrellas
2,011
Forks
221
Issues abiertos
69
Último commit
ayer

¿Qué es?

ggshield es una herramienta de línea de comandos de GitGuardian que busca secretos codificados, como claves de API y credenciales, antes de que se filtren. Analiza archivos locales, repositorios Git, imágenes de Docker y paquetes de PyPI, y puede ejecutarse en el equipo de un desarrollador o dentro de un pipeline de CI.

Llama a la API pública de GitGuardian para detectar y validar secretos, y se puede integrar con hooks de Git pre-commit, pre-push y pre-receive, así como con GitHub Actions. Los análisis solo almacenan metadatos como la hora de la llamada, el tamaño de la solicitud y el modo de análisis, por lo que los valores de los secretos detectados no se guardan en el panel.

La herramienta también puede instalar hooks que analizan las interacciones con asistentes de programación con IA, como Cursor, Claude Code, Copilot Chat y Codex, y bloquean las acciones que contienen secretos antes de que se ejecuten.

Funciones clave

  • 01Detecta más de 500 tipos de secretos y los valida.
  • 02Analiza archivos, repositorios Git, imágenes de Docker y paquetes de PyPI.
  • 03Se ejecuta como hook de Git pre-commit, pre-push o pre-receive.
  • 04Ofrece una GitHub Action e integración con CI/CD.
  • 05Instala hooks para analizar las interacciones con asistentes de programación con IA.
  • 06Se instala en macOS, Linux y Windows mediante pip, pipx, Homebrew o paquetes.

Casos de uso

  • Impedir que se añadan secretos a un repositorio mediante hooks de pre-commit.
  • Analizar pipelines de CI para detectar credenciales filtradas antes del despliegue.
  • Auditar el historial existente de Git o las imágenes de Docker en busca de claves codificadas.
  • Impedir que los asistentes de programación con IA ejecuten acciones que contienen secretos.

Inicio rápido

  1. 1

    Instala ggshield con pipx (requiere Python y git)

    pipx install ggshield
  2. 2

    Autentícate en los servidores de GitGuardian

    ggshield auth login
  3. 3

    Analiza el directorio actual en busca de secretos

    ggshield secret scan path -r .

Antes de usarlo

  • El análisis requiere autenticación en los servidores de GitGuardian y utiliza su API pública.
  • Si se instala desde PyPI, requiere una versión de Python compatible y que no haya llegado al final de su ciclo de vida (EOL), además de git.
  • En macOS, al actualizar a la versión 1.54.0, aparece una solicitud de acceso al llavero para el binario ggshield-py.

En colecciones

Herramientas de CLI y terminalHerramientas de escaneo, auditoría e inteligencia de amenazasFrameworks de pruebas y herramientas de automatización

Temas

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

Preguntas frecuentes

¿Qué es ggshield?
CLI que detecta y valida más de 500 tipos de secretos codificados en archivos, repositorios Git, imágenes de Docker y paquetes; se puede usar como hook de pre-commit o en CI. ggshield es una herramienta de línea de comandos de GitGuardian que busca secretos codificados, como claves de API y credenciales, antes de que se filtren. Analiza archivos locales, repositorios Git, imágenes de Docker y paquetes de PyPI, y puede ejecutarse en el equipo de un desarrollador o dentro de un pipeline de CI.
¿ggshield es gratuito? ¿Qué licencia tiene?
ggshield es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ggshield sigue mantenido?
Mantenimiento activo. El último commit de ggshield fue el 6 nov 2026.
¿Para qué puedo usar ggshield?
Impedir que se añadan secretos a un repositorio mediante hooks de pre-commit. Analizar pipelines de CI para detectar credenciales filtradas antes del despliegue. Auditar el historial existente de Git o las imágenes de Docker en busca de claves codificadas. Impedir que los asistentes de programación con IA ejecuten acciones que contienen secretos.
¿Cómo se instala ggshield?
Instala ggshield con pipx (requiere Python y git): pipx install ggshield Autentícate en los servidores de GitGuardian: ggshield auth login Analiza el directorio actual en busca de secretos: ggshield secret scan path -r .
¿Dónde consigo ggshield?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/GitGuardian/ggshield

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados