Saltar para o conteúdo principal

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:
  • 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.
Se a validação falhar ou atingir seu limite, as detecções sem parecer ficam fora da fila de achados ativos. Um scan posterior pode avaliá-las novamente.

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_PATCHED e PATCH_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.
Mesmo que um segredo tenha sido commitado apenas brevemente, trate-o como comprometido. O histórico do Git preserva todos os dados commitados.
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.

Mascaramento de segredos da organização

Administradores podem abrir Settings → General → Secret Masking e selecionar Hide Descriptions para ocultar a descrição e o passo a passo gerados para achados de segredos. O ZeroPath mascara os valores e títulos independentemente dessa configuração.