Repolode
trufflesecurity

trufflesecurity/trufflehog

CLI que encuentra credenciales expuestas en Git, almacenamiento en la nube, chats y otras fuentes, y comprueba si siguen activas.

Alternativa open source a:GitGuardian

Estrellas
28,583
Forks
2,650
Issues abiertos
581
Último commit
hace 19 horas

¿Qué es?

TruffleHog detecta secretos como claves de API, contraseñas de bases de datos y claves privadas en muchos lugares, incluidos repositorios de Git, plataformas de chat y wikis, logs, almacenes de objetos, sistemas de archivos e imágenes de Docker. Clasifica más de 800 tipos de secretos según el servicio al que pertenecen, de modo que permite identificar una cadena de texto aislada como, por ejemplo, una clave de AWS o Stripe.

Para la mayoría de los tipos de secretos, TruffleHog inicia sesión en la API correspondiente para confirmar si una credencial sigue activa. Los resultados se indican como verificados, no verificados o desconocidos, lo que reduce los falsos positivos. Para unos 20 tipos de credenciales comunes, también puede realizar un análisis más profundo para mostrar quién creó un secreto y qué permisos concede.

Se ejecuta como una sola herramienta de línea de comandos, que se puede instalar mediante Homebrew, Docker o una versión binaria, e integrar en pipelines de CI, GitHub Actions y hooks de pre-commit. Los resultados pueden estar en texto plano, JSON o SARIF.

Funciones clave

  • 01Analiza Git, GitHub, GitLab, S3, GCS, imágenes de Docker, sistemas de archivos, Postman, Jenkins y más
  • 02Clasifica más de 800 tipos de secretos según el servicio al que pertenecen
  • 03Verifica las credenciales con la API correspondiente para indicar si siguen activas
  • 04El análisis más profundo de unos 20 tipos de credenciales comunes revela permisos y recursos
  • 05Genera resultados en texto plano, JSON o SARIF, y es compatible con GitHub Actions y hooks de pre-commit

Casos de uso

  • Analizar repositorios de Git y pull requests para detectar claves incluidas por error antes de que queden expuestas
  • Revisar buckets de S3 o GCS en busca de credenciales guardadas en archivos de configuración o de datos
  • Bloquear secretos en pipelines de CI con la opción --fail
  • Auditar imágenes de Docker o espacios de trabajo de Postman para detectar credenciales incrustadas

Inicio rápido

  1. 1

    Instalar en macOS con Homebrew

    brew install trufflehog
  2. 2

    Analizar un repositorio para detectar solo secretos verificados

    trufflehog git https://github.com/trufflesecurity/test_keys --results=verified
  3. 3

    Analizar una organización de GitHub para detectar solo secretos verificados

    trufflehog github --org=trufflesecurity --results=verified

Antes de usarlo

  • Publicado bajo AGPL-3.0, una licencia copyleft que puede restringir su uso en productos propietarios.
  • Algunas funciones avanzadas, como github-experimental object discovery, están en fase alfa y pueden cambiar.

Temas

Preguntas frecuentes

¿Qué es trufflehog?
CLI que encuentra credenciales expuestas en Git, almacenamiento en la nube, chats y otras fuentes, y comprueba si siguen activas. TruffleHog detecta secretos como claves de API, contraseñas de bases de datos y claves privadas en muchos lugares, incluidos repositorios de Git, plataformas de chat y wikis, logs, almacenes de objetos, sistemas de archivos e imágenes de Docker. Clasifica más de 800 tipos de secretos según el servicio al que pertenecen, de modo que permite identificar una cadena de texto aislada como, por ejemplo, una clave de AWS o Stripe.
¿trufflehog es gratuito? ¿Qué licencia tiene?
trufflehog es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿trufflehog sigue mantenido?
Mantenimiento activo. El último commit de trufflehog fue el 19 oct 2026.
¿Para qué puedo usar trufflehog?
Analizar repositorios de Git y pull requests para detectar claves incluidas por error antes de que queden expuestas Revisar buckets de S3 o GCS en busca de credenciales guardadas en archivos de configuración o de datos Bloquear secretos en pipelines de CI con la opción --fail Auditar imágenes de Docker o espacios de trabajo de Postman para detectar credenciales incrustadas
¿Cómo se instala trufflehog?
Instalar en macOS con Homebrew: brew install trufflehog Analizar un repositorio para detectar solo secretos verificados: trufflehog git https://github.com/trufflesecurity/test_keys --results=verified Analizar una organización de GitHub para detectar solo secretos verificados: trufflehog github --org=trufflesecurity --results=verified
¿Dónde consigo trufflehog?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/trufflesecurity/trufflehog

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

Proyectos relacionados