Como Funciona
Habilite Secrets Detection em scans completos ou de pull request para procurar credenciais commitadas no código. Abra Issues → Secrets (em inglês) para conferir o arquivo afetado, o tipo de credencial e as evidências de verificação. Use o filtro Verified live secrets para encontrar credenciais que estavam ativas quando foram detectadas. Scans completos reúnem e deduplicam os resultados de vários detectores. O ZeroPath pode confirmar uma credencial diretamente quando um detector a verifica com o provedor. As demais detecções são revisadas em contexto para distinguir possíveis segredos de exemplos, arquivos de teste, chaves públicas e outros valores.Tipos de Segredos Detectados
O ZeroPath detecta uma ampla variedade de tipos de segredos de todos os principais provedores de nuvem e serviços. Alguns deles são:- Nuvem e Infraestrutura
- APIs e SaaS
- Bancos de Dados e Autenticação
- Padrões Genéricos
- Chaves de acesso e chaves secretas da AWS
- Chaves de conta de serviço do Google Cloud
- Credenciais e strings de conexão do Azure
- Tokens da DigitalOcean
- Chaves de API do Heroku
Modos de Escaneamento
Escaneamento Completo do Repositório
Scans completos verificam arquivos do repositório ou da partição em escopo. Confira qualquer aviso de scan parcial antes de usar os resultados.Escaneamento de PR
Scans de PR verificam os arquivos alterados e avaliam as detecções nas linhas modificadas. Achados que atingem os limites configurados podem aparecer como comentários inline e afetar o check.Verificação
A verificação com o provedor pode confirmar se uma credencial estava ativa na detecção. Confira esse resultado junto com a validação do achado:- Ativa na detecção — o provedor confirmou que a credencial estava ativa.
- Sem verificação — o ZeroPath não tem confirmação do provedor. Confira as evidências disponíveis e o estado da credencial com o provedor.
- Falso positivo — a validação descartou o achado, por exemplo, por se tratar de um valor de teste ou placeholder.
Aviso de Escaneamento Parcial
Um dos detectores do scan completo exclui arquivos grandes quando possível, com limite padrão de 5 MiB. Consulte o log do scan para ver as exclusões. Se o detector exceder o tempo limite, o ZeroPath informa que a cobertura de segredos é parcial. Os achados do outro detector ainda podem aparecer, e os achados já registrados são preservados. Confira o aviso e o escopo afetado antes de usar os resultados.Orientação de Remediação
Cada segredo detectado inclui:- Prévia do segredo com redação — uma versão parcialmente mascarada mostrando o suficiente para identificar a credencial (como os últimos quatro caracteres ou o rótulo do algoritmo para material de chave) sem expor o valor completo. Os valores de segredos são mascarados em todas as superfícies — incluindo o dashboard, a API, payloads de webhook, notificações, exportações e tickets de integração — para todos os usuários.
- Título da descoberta com redação — para descobertas de segredos, o título da vulnerabilidade é automaticamente substituído por um título determinístico baseado na localização que não contém o valor do segredo. Isso se aplica em todos os lugares onde o título aparece, incluindo payloads de webhook (como eventos
VULNERABILITY_PATCHEDePATCH_PR_DENIED), mensagens de notificação e respostas da API. - Guia de rotação — instruções específicas da plataforma para rotacionar a credencial comprometida (ex.: como regenerar uma chave de acesso da AWS, revogar um token do GitHub ou rotacionar uma chave de API do Stripe).
- Informações do detector — o tipo de segredo detectado e como ele foi identificado.
- Localização do arquivo — o arquivo e a linha exatos onde o segredo foi encontrado.
Resposta Recomendada
1
Rotacione a Credencial
Gere um novo segredo/chave no serviço afetado e revogue o antigo.
2
Remova do Código
Mova o segredo para variáveis de ambiente, um gerenciador de segredos (AWS Secrets Manager, HashiCorp
Vault etc.) ou o armazenamento de segredos do seu sistema de CI/CD.
3
Audite os Logs de Acesso
Verifique no serviço associado se houve acesso não autorizado durante a janela de exposição.
4
Previna Vazamentos Futuros
Adicione arquivos de configuração contendo segredos ao
.gitignore para prevenir commits acidentais.Registro de exposição
Abra Exposure snapshot no achado para conferir quem tinha acesso quando a credencial foi detectada. A visualização completa exige acesso de administrador da organização ou acesso MSP aplicável. Readers on the VCS mostra os leitores registrados no GitHub ou GitLab e indica a cobertura dos dados. Viewers in ZeroPath mostra quem tinha acesso ao achado no ZeroPath. Quando houver uma lista em Readers on the VCS, use Export CSV para baixar os leitores que correspondem à busca atual, incluindo os resultados de outras páginas.Configuração
O escaneamento de segredos é controlado pelas configurações do scanner, com herança em níveis de organização/tag/repositório:
O escaneamento de segredos roda como parte do pipeline de escaneamento mais amplo e compartilha as mesmas configurações de agendamento, notificação e integração das descobertas SAST.