Skip to content
KitploitKITPLOIT
HerramientasExploitsBlog
Log in
Enviar
HerramientasExploitsBlog
Enviar

¡Herramientas de Hacking, PenTest y Ciberseguridad para tu Arsenal de Seguridad!

Kitploit es un directorio de herramientas de hacking, ciberseguridad y pentesting. Descubre las últimas actualizaciones de proyectos para encontrar vulnerabilidades, analizar sistemas, automatizar pruebas y fortalecer tu seguridad.

FeedsContactoPrivacidad© 2026 Kitploit

Directorio de Herramientas

Categorías

Ver todas las categorías
Loading categories
Herramientas/GitLabGitLab/daveyd347/secrets-scanner
Herramientas DefensivasAnálisis EstáticoEscáneres de VulnerabilidadesAnálisis de CódigoScripting y AutomatizaciónDevSecOpsDetección de SecretosSeguridad de Cadena de Suministro
GitLabdaveyd347/secrets-scanner

Secrets Scanner

Escáner de secretos sin dependencias para código fuente e historial de git que detecta claves de API, tokens y claves privadas filtradas, con salida redactada y un job de GitLab CI listo para usar.

Ver RepositorioSitio web
hace 19h 52mAún no revisado
Compartir

secretscan

Un pequeño escáner de secretos sin dependencias para código fuente y el historial de git, con un job de GitLab CI listo para usar.

Encuentra claves de API, tokens, claves privadas y contraseñas filtradas antes de que lleguen a producción, incluidos secretos que se commitearon una vez y se "eliminaron" después pero que siguen presentes en el historial.

$ secretscan scan . --history
[HIGH    ] url-credentials              deploy.sh:1 (commit 79831acaf3, Dev <[email protected]>)
           Credentials embedded in a URL: Fake********
[HIGH    ] aws-access-key-id            settings.py:1 (commit 79831acaf3, Dev <[email protected]>)
           AWS access key ID: AKIA************

2 potential secret(s) found.

En esa demo, la clave de AWS se eliminó de settings.py en un commit posterior. Un escaneo simple del archivo indica que el repositorio está limpio, pero la clave aún se puede recuperar con git log -p, por lo que sigue estando filtrada.

Características

  • 16 reglas integradas: AWS, GitHub, GitLab (PATs y tokens de runner), Slack, Stripe, Google, OpenAI, Anthropic, claves privadas PEM, JWTs, credenciales en URLs y una regla genérica de password = "...".
  • Filtrado por entropía (entropía de Shannon) en las reglas genéricas ruidosas, además de un filtro de marcadores de posición para valores como changeme, ${API_KEY}, {{ vault_token }} y <your-password>.
  • Escaneo del historial de Git: recorre cada commit del más antiguo al más reciente, examina solo las líneas añadidas y atribuye cada secreto al commit y autor que lo introdujo, con números de línea correctos.
  • Modo merge request: --rev-range base..HEAD escanea solo los commits nuevos.
  • Salida redactada por defecto, para que los propios registros del escáner nunca se conviertan en una segunda filtración.
  • Tres formatos de salida: texto legible, JSON y el esquema del informe de GitLab Secret Detection.
  • Supresión: .secretscanignore (globs estilo gitignore) e inline # secretscan:ignore.
  • Códigos de salida compatibles con CI con un umbral de severidad --fail-on.
  • Solo biblioteca estándar; Python 3.10+.

Instalación

pip install git+https://gitlab.com/DaveyD347/secrets-scanner.git
# or, from a clone
pip install -e ".[dev]"

Uso

secretscan scan                       # scan the current directory's files
secretscan scan path/to/repo --history        # files + entire git history
secretscan scan . --history-only              # history only
secretscan scan . --rev-range origin/main..HEAD   # only commits not yet on main
secretscan scan . --format json -o findings.json
secretscan scan . --fail-on high              # only fail on high/critical
secretscan rules                              # list rules
Código de salidaSignificado
0Sin hallazgos en o por encima de --fail-on
1Hallazgos en o por encima de --fail-on
2Error de uso (ruta incorrecta, no es un repositorio git, ...)

Suprimir falsos positivos

Añade un marcador en línea:

EXAMPLE_KEY = "..."  # secretscan:ignore

O crea .secretscanignore en la raíz del repositorio:

# test fixtures
tests/fixtures/
*.lock

GitLab CI

Añade el job reutilizable a cualquier proyecto:

include:
  - remote: "https://gitlab.com/DaveyD347/secrets-scanner/-/raw/main/templates/secretscan.gitlab-ci.yml"

El job clona el historial completo (GIT_DEPTH: 0), escanea solo los commits nuevos en las canalizaciones de merge request y el historial completo en caso contrario, hace fallar la canalización si encuentra hallazgos y sube gl-secret-detection-report.json como un informe secret_detection. En GitLab Ultimate esos hallazgos aparecen en el widget de seguridad del merge request y en el informe de vulnerabilidades; en otros niveles el informe se conserva igualmente como artefacto descargable. Configura SECRETSCAN_FAIL_ON para ajustar el umbral.

El propio .gitlab-ci.yml de este repositorio ejecuta lint, pruebas en Python 3.10 a 3.13 con cobertura, y ejecuta el escáner contra su propio historial.

Cómo funciona

  1. Las reglas (src/secretscan/rules.py) son expresiones regulares. El primer grupo de captura es el secreto. Las reglas genéricas también establecen una entropía mínima para que password = "aaaaaaaaaaaa" no se active.
  2. El escaneo de archivos recorre el árbol, omitiendo .git, node_modules, virtualenvs, binarios (detección de byte NUL), archivos de más de 2 MB y cualquier cosa en .secretscanignore.
  3. El escaneo del historial ejecuta git log --all --reverse -p --unified=0 y analiza el flujo de diff, rastreando el commit actual, el archivo y el número de línea del lado nuevo a partir de cada encabezado de hunk @@. Solo se comprueban las líneas +, por lo que un secreto se reporta una vez, en el commit que lo introdujo, en lugar de una vez por cada commit posterior.
  4. La generación de informes oculta los valores y elimina duplicados de un secreto que aparece tanto en el árbol de trabajo como en el historial.

Desarrollo

pip install -e ".[dev]"
pytest
ruff check . && ruff format --check .

Los fixtures de prueba nunca contienen credenciales reales. Los tokens falsos en tests/fakes.py se ensamblan a partir de piezas en tiempo de ejecución para que el repositorio en sí no contenga cadenas completas con forma de token. Eso mantiene limpio el autoescaneo de CI y evita activar la protección de push de GitLab.

Limitaciones e ideas

  • Regex más entropía siempre tendrá algunos falsos positivos y falsos negativos. No verifica las claves contra las API de los proveedores.
  • No escanea dentro de archivos comprimidos ni archivos binarios.
  • Posibles próximos pasos: reglas personalizadas desde un archivo TOML, un archivo de línea base para aceptar hallazgos existentes, un hook de pre-commit y salida SARIF.

Licencia

MIT

Descargar herramienta

Más Populares

Ver todos →

Descubre las herramientas más usadas por nuestra comunidad.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 El kit de herramientas OSINT definitivo: grafo de investigación, puntuación de confianza, familias de alias, mapa, línea de tiempo e informes. 49 módulos, más de 400 sitios, sin necesidad de claves API.

    732
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Aplicación de Ejecución con un Solo Toque GhostLock (CVE-2026-43499)

    506
  • 3

    ARTEX

    baarai/artex

    Plataforma de pruebas de penetración autónoma multiagente basada en LLM con agentes planificadores/trabajadores, grafos de activos y de exploración, registro de tráfico MITM y reevaluación de vulnerabilidades.

    405
  • 4

    redforge

    cybersecurity91/redforge

    Kit de herramientas de red team del lado del navegador con 102 herramientas offline para reconocimiento, generación de payloads, ataques de credenciales, criptografía, codificación y elaboración de informes de compromiso.

    342
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    El sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.

    261
  • 6

    antifox

    antifox-ai/antifox

    Plataforma de pruebas de penetración autónoma con múltiples agentes de IA que ejecuta reconocimiento, descubrimiento de superficie de ataque, validación de explotación y entrega de informes respaldados por evidencia.

    259

Explora todas las herramientas

Explora nuestra colección de herramientas

Ver todas las herramientas →