Fichas de herramientasBasada en la documentación oficial, no probada por nosotros

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 git escanea el historial de un repositorio, dir escanea carpetas o ficheros y stdin escanea 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:allow en la línea, o un fichero .gitleaksignore con 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 .gitleaksignore está marcada como experimental en el README.
  • Los comandos antiguos detect y protect quedaron 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 git es 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:allow sobre 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.

Fuentes

Síguenos

Fichas nuevas y noticias de seguridad: YouTube (@safet2ship) e Instagram (@safet2ship).

Canal de YouTube · Instagram

Recibe los runbooks gratis

Listas de seguridad de una página para fundadores que construyen con IA. Primero te enviamos un correo de confirmación y después los runbooks.

Quiero los runbooks