Skip to content
KitploitKITPLOIT
FerramentasExploitsBlog
Log in
Enviar
FerramentasExploitsBlog
Enviar

Ferramentas de Hacking, PenTest e Cibersegurança para o seu Arsenal de Segurança!

Kitploit é um diretório de ferramentas de hacking, cibersegurança e pentesting. Descubra as últimas atualizações de projetos para encontrar vulnerabilidades, analisar sistemas, automatizar testes e fortalecer sua segurança.

FeedsContatoPrivacidade© 2026 Kitploit

Diretório de Ferramentas

Categorias

Ver todas as categorias
Loading categories
Secrets Scanner — Scanner de segredos sem dependências para código-fonte e histórico do git que detecta chaves de API, tokens e chaves privadas vazados, com saída redigida e um job de CI do GitLab pronto para uso. | Kitploit
Ferramentas/GitLabGitLab/daveyd347/secrets-scanner
Ferramentas DefensivasAnálise EstáticaScanners de VulnerabilidadesAnálise de CódigoScripting e AutomaçãoDevSecOpsDetecção de SegredosSegurança da Cadeia de Suprimentos
Compartilhar
GitLab
daveyd347/secrets-scanner

Secrets Scanner

Scanner de segredos sem dependências para código-fonte e histórico do git que detecta chaves de API, tokens e chaves privadas vazados, com saída redigida e um job de CI do GitLab pronto para uso.

Ver RepositórioSite
há 20h 4mAinda não revisado

secretscan

Um pequeno scanner de segredos sem dependências para código-fonte e histórico do git, com um job de CI do GitLab pronto a usar.

Ele encontra chaves de API, tokens, chaves privadas e senhas vazadas antes de chegarem à produção, incluindo segredos que foram commitados uma vez e "removidos" depois, mas que continuam presentes no histórico.

$ 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.

Nessa demonstração, a chave da AWS foi excluída de settings.py em um commit posterior. Uma varredura simples de arquivos diz que o repositório está limpo, mas a chave ainda pode ser recuperada com git log -p, portanto ainda está vazada.

Recursos

  • 16 regras integradas: AWS, GitHub, GitLab (PATs e tokens de runner), Slack, Stripe, Google, OpenAI, Anthropic, chaves privadas PEM, JWTs, credenciais em URLs e uma regra genérica de password = "...".
  • Filtragem por entropia (entropia de Shannon) nas regras genéricas ruidosas, além de um filtro de placeholders para valores como changeme, ${API_KEY}, {{ vault_token }} e <your-password>.
  • Varredura do histórico do Git: percorre cada commit do mais antigo para o mais recente, examina apenas as linhas adicionadas e atribui cada segredo ao commit e ao autor que o introduziu, com números de linha corretos.
  • Modo merge request: --rev-range base..HEAD varre apenas os novos commits.
  • Saída redigida por padrão, para que os próprios logs do scanner nunca se tornem um segundo vazamento.
  • Três formatos de saída: texto legível, JSON e o esquema do relatório GitLab Secret Detection.
  • Supressão: .secretscanignore (globs no estilo gitignore) e # secretscan:ignore inline.
  • Códigos de saída amigáveis para CI com um limite de severidade --fail-on.
  • Biblioteca padrão pura; Python 3.10+.

Instalação

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 saídaSignificado
0Nenhum achado igual ou superior a --fail-on
1Achados iguais ou superiores a --fail-on
2Erro de uso (caminho inválido, não é um repositório git, ...)

Suprimindo falsos positivos

Adicione um marcador inline:

EXAMPLE_KEY = "..."  # secretscan:ignore

Ou crie .secretscanignore na raiz do repositório:

# test fixtures
tests/fixtures/
*.lock

GitLab CI

Adicione o job reutilizável a qualquer projeto:

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

A tarefa clona o histórico completo (GIT_DEPTH: 0), verifica apenas os novos commits em pipelines de merge request e o histórico completo nos demais casos, falha o pipeline ao encontrar achados e envia gl-secret-detection-report.json como um relatório secret_detection. No GitLab Ultimate, esses achados aparecem no widget de segurança do merge request e no relatório de vulnerabilidades; em outros níveis, o relatório ainda é mantido como artefato para download. Defina SECRETSCAN_FAIL_ON para ajustar o limite.

O próprio .gitlab-ci.yml deste repositório faz lint, testa em Python 3.10 a 3.13 com cobertura, e executa o scanner contra seu próprio histórico.

Como funciona

  1. Regras (src/secretscan/rules.py) são expressões regulares. O primeiro grupo de captura é o segredo. Regras genéricas também definem uma entropia mínima para que password = "aaaaaaaaaaaa" não dispare.
  2. Varredura de arquivos percorre a árvore, ignorando .git, node_modules, virtualenvs, binários (detecção de byte NUL), arquivos com mais de 2 MB e qualquer coisa em .secretscanignore.
  3. Varredura de histórico executa git log --all --reverse -p --unified=0 e analisa o fluxo de diff, rastreando o commit atual, o arquivo e o número da linha do lado novo a partir de cada cabeçalho de hunk @@. Apenas linhas + são verificadas, então um segredo é reportado uma vez, no commit que o introduziu, em vez de uma vez para cada commit posterior.
  4. Relatório oculta valores e remove duplicatas de um segredo que aparece tanto na árvore de trabalho quanto no histórico.

Desenvolvimento

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

Os fixtures de teste nunca contêm credenciais reais. Os tokens falsos em tests/fakes.py são montados a partir de partes em tempo de execução, de modo que o próprio repositório não contém nenhuma string completa com formato de token. Isso mantém a auto-verificação da CI limpa e evita acionar a proteção de push do GitLab.

Limitações e ideias

  • Regex mais entropia sempre terá alguns falsos positivos e falsos negativos. Não valida chaves junto às APIs dos provedores.
  • Não verifica dentro de arquivos compactados ou binários.
  • Próximos passos possíveis: regras personalizadas a partir de um arquivo TOML, um arquivo de baseline para aceitar descobertas existentes, um hook de pre-commit e saída SARIF.

Licença

MIT

Baixar ferramenta

Mais Populares

Ver todos →

Descubra as ferramentas mais usadas pela nossa comunidade.

Sem dados de popularidade ainda.

Explore todas as ferramentas

Navegue pela nossa coleção de ferramentas

Ver todas as ferramentas →