Gitleaks: encuentra claves y contraseñas subidas por error a tu código, gratis y de código abierto
Gitleaks es un escáner gratuito de línea de comandos que busca secretos como claves de API, contraseñas y tokens en el historial de git, en carpetas o en texto que le pasas. Basado en el README oficial, no probado por nosotros: qué hace, sus límites (el autor dice que está completo) y qué no hemos podido confirmar.
Tipo
Escáner de secretos (línea de comandos)
Licencia y coste
Licencia MIT, gratis
Revisada
2 nov 2026
Versión
v8.30.1 (la página muestra 21 de marzo, sin año)
Para quién
Equipos que guardan código en git y quieren una comprobación gratuita de que ninguna clave o contraseña se coló en un commit.
Cuidado con
El autor dice que está completo (solo parches de seguridad). Un hallazgo significa clave expuesta: revócala.
← Todas las fichas de herramientasN.º 3 / 11
En una frase
Gitleaks es un escáner que lee un repositorio de git, una carpeta o texto que le pasas, e informa de secretosSecreto (clave de API, token, contraseña) Cualquier texto que demuestra a un servicio que tienes permiso para entrar, como una clave de API, una contraseña de base de datos o un token de acceso. Toca otra vez para abrir el glosario: contraseñas, claves de API y tokens que nunca deberían estar en tu código. Busca por patrones, así que puede encontrar una clave que alguien pegó en un fichero hace años y que sigue viva en tu historial de git.
Para quién es
Fundadores, creadores independientes y equipos pequeños que guardan código en git, publican rápido, a menudo con ayuda de asistentes de IA, y quieren una comprobación barata de que ninguna clave se coló en un commit. Es una herramienta de línea de comandos, así que hay que sentirse cómodo escribiendo comandos.
Qué dice la documentación
Todo lo que sigue sale del README del proyecto, que leímos el 2 de noviembre de 2026.
- Qué escanea: el comando
gitescanea el historial de un repositorio,direscanea carpetas o ficheros ystdinescanea texto que le pasas. - Instalación: Homebrew en macOS, una imagen de Docker (en Docker Hub y en el registro de contenedores de GitHub), compilar desde el código con Go, o un binario ya hecho de la página de versiones.
- Antes de hacer commit: funciona con el framework pre-commit, así que un commit se puede frenar si encuentra un secreto. El README dice que se puede saltar con una variable de entorno, lo que también significa que cualquiera puede saltárselo.
- En tu pipeline: hay una GitHub Action, mantenida como proyecto aparte llamado gitleaks-action.
- Línea base: puedes guardar un informe y pasarlo como línea base, para que los escaneos siguientes avisen solo de lo nuevo. Útil si un repositorio antiguo ya tiene fugas conocidas.
- Configuración: las reglas viven en un fichero
.gitleaks.toml. Puedes añadir reglas propias (un id y una expresión regular, con palabras clave, entropía y ruta opcionales), ampliar las reglas por defecto y desactivar algunas. - Permitir un hallazgo: una lista de permitidos global o por regla, un comentario
gitleaks:allowen la línea, o un fichero.gitleaksignorecon huellas. El README marca este último como experimental. - Informes: JSON, CSV, JUnit y SARIF, o una plantilla propia en Go.
- Códigos de salida: 0 significa sin fugas, 1 significa fugas o error (se puede cambiar con una opción) y 126 significa una opción desconocida. Un script que ignore el código de salida dejará pasar hallazgos.
Lo bueno
- Gratis, licencia MIT, y una sola herramienta para historial, carpetas y texto.
- Puede ejecutarse antes de un commit, así que un secreto puede no llegar nunca al repositorio compartido.
- La línea base permite adoptarla en un proyecto antiguo sin ahogarse en hallazgos del pasado.
- Las reglas son configuración en texto plano que puedes leer y cambiar.
Los límites que admite
- El autor dice que el proyecto está «completo en funciones». El README dice que las próximas versiones se limitarán a parchesParche (actualización de seguridad) Una corrección que publica el fabricante de un software para cerrar un fallo o un error. Toca otra vez para abrir el glosario de seguridad y que el autor está cambiando su foco a otro proyecto llamado Betterleaks. No leímos nada sobre ese proyecto más allá de esta mención.
- La función
.gitleaksignoreestá marcada como experimental en el README. - Los comandos antiguos
detectyprotectquedaron obsoletos en la v8.19.0 y están ocultos pero siguen disponibles, así que guías antiguas de internet pueden mostrar comandos que han cambiado.
Cuándo no usarla
- Si crees que sustituye a cambiar una clave filtrada. Encontrar un secreto en tu historial no deshace la fuga. Trata la clave como expuesta.
- Como única línea de defensa. Un escáner de patrones puede pasar por alto un secreto que no se parece a sus patrones, y puede marcar cosas que no son secretos.
- Si quieres un panel alojado con alertas y funciones de equipo: esta es una herramienta de línea de comandos, y no leímos nada en el README sobre una versión alojada.
Lo que te cuesta
Tiempo más que dinero. El README no da ninguna estimación del tiempo de puesta en marcha. El trabajo real viene después: ajustar reglas y listas de permitidos para que haya poco ruido, añadirla al paso previo al commit y a tu pipeline, y decidir qué hacer con cada hallazgo real, que significa revocar la clave y crear otra. No hemos medido nada de esto.
Errores típicos de configuración
- Escanear solo los ficheros actuales. Un secreto borrado del código sigue en el historial de git. El comando
gites el que lee el historial. - Ignorar el código de salida. Un pipeline que no se detiene con el código 1 puede pasar con fugas dentro.
- Permitir demasiado. Una lista de permitidos amplia o un comentario
gitleaks:allowsobre un secreto real lo esconde de todos los escaneos posteriores. - Tomar un escaneo limpio como prueba. Significa que ningún patrón coincidió, no que no exista ningún secreto.
- Dejar la clave válida tras encontrarla. Revócala y crea una nueva.
Cómo comprobar que funciona
Documentación oficial y nuestro planteamiento, no algo que hayamos ejecutado: en un repositorio de prueba desechable, con un valor falso que parezca una clave, ejecuta el escaneo y espera un hallazgo y el código de salida 1. Luego quita el valor falso y vuelve a ejecutarlo para ver el código 0. No uses nunca una clave real para esta prueba.
Por dónde empezar
No probamos la herramienta, así que no ofrecemos tutorial. Sigue el README oficial: httpsHTTPS La versión segura del protocolo de las direcciones web: cifra lo que viaja entre el visitante y tu sitio y comprueba que el sitio es el verdadero. Toca otra vez para abrir el glosario://github.com/gitleaks/gitleaks
Qué no hemos podido confirmar
No descargamos, instalamos ni ejecutamos Gitleaks, así que todo lo anterior es la descripción del propio README. No leímos la documentación del proyecto más allá del README, ni sus reglas en detalle, ni el código. La página de versiones mostraba la v8.30.1 con la fecha 21 de marzo y sin año, así que no podemos decir el año de publicación; también mostraba 26 commits en la rama principal posteriores a esa versión. No sabemos lo bien que detecta secretos en la práctica, cuántas falsas alarmas da ni lo rápida que es con un historial grande. No leímos nada del proyecto que se menciona como nuevo foco del autor. No hemos comparado Gitleaks con otros escáneres de secretos.
Relacionado
Glosario: secreto. Si una clave se ha filtrado, mira nuestro runbook 02, incidente con una clave de API.
Más herramientas gratuitas
Otras fichas de esta sección.
- CrowdSec: un motor gratuito y de código abierto que lee tus registros, detecta atacantes y los bloquea, con una lista de bloqueo compartida por la comunidad: Motor de detección y bloqueo de intrusiones (lee registros, bloquea IP abusivas)
- Lynis: una auditoría gratuita que revisa la configuración de seguridad de un servidor Linux y te dice qué corregir: Herramienta de auditoría y endurecimiento de seguridad (se ejecuta en el propio equipo)
- Semgrep: escanea tu propio código en busca de errores y fallos de seguridad antes de publicar, gratis y de código abierto: Escáner de análisis estático de código (línea de comandos)
- Bitwarden: un gestor de contraseñas de código abierto que tu equipo puede alojar, con opciones gratuitas y de pago: Gestor de contraseñas (servicio alojado y servidor autoalojable)
- OpenVAS: un escáner gratuito que revisa tus servidores y aplicaciones en busca de debilidades conocidas: Escáner de vulnerabilidades (parte de Greenbone Community Edition)
- OSV-Scanner: comprueba si las librerías de tu proyecto tienen vulnerabilidades conocidas, gratis y de código abierto: Escáner de vulnerabilidades de dependencias (línea de comandos)
- Trivy: escanea tus contenedores, carpetas de código y dependencias en busca de vulnerabilidades conocidas, gratis y de código abierto: Escáner de vulnerabilidades y configuración (línea de comandos)
- Wazuh: una plataforma de código abierto que vigila tus servidores en busca de actividad sospechosa: Plataforma de monitorización de seguridad (agentes, servidor, indexador y panel)
- Restic: copias de seguridad cifradas que se pueden restaurar, gratis y de código abierto: Programa de copias de seguridad (línea de comandos)
- SkillSpector: revisa una skill de un agente de IA antes de instalarla: Escáner de seguridad para skills de agentes de IA (línea de comandos)
Fuentes
Síguenos
Fichas nuevas y noticias de seguridad: YouTube (@safet2ship) e Instagram (@safet2ship).