Saltar para o conteúdo principal

Visão Geral

Quando você abre um PR que corrige uma vulnerabilidade conhecida, pode referenciar a issue na descrição do PR. O ZeroPath verificará automaticamente se as suas mudanças resolveriam a vulnerabilidade e informará os resultados no PR. Quando o PR é mesclado, o ZeroPath verifica novamente e atualiza o status da issue no dashboard.

Referenciando Vulnerabilidades

Adicione referências a issues do ZeroPath em qualquer lugar da descrição do seu PR usando qualquer um destes formatos:
Referencie uma ou mais issues pelo seu UUID:
Separadas por vírgula para múltiplas issues:
Ambos os formatos são insensíveis a maiúsculas e minúsculas. Você pode misturá-los livremente e incluir múltiplas referências por PR.

Onde Encontrar o UUID da Issue

Navegue até a página de detalhes da issue no dashboard do ZeroPath. O UUID aparece na URL:
Você também pode copiá-lo da visão de detalhes da issue.

Como Funciona

1

Abra um PR com Referências

Inclua uma ou mais referências ZP-ID ou URLs do dashboard na descrição do seu PR.
2

Verificação Pré-Merge

O ZeroPath verifica se cada vulnerabilidade referenciada seria resolvida pelas mudanças do seu PR e publica um comentário com os resultados. Isso é apenas informativo — o status da issue ainda não é alterado.
3

Itere se Necessário

Se a verificação reportar “still present”, envie commits adicionais e responda @ZeroPath retriage para executar novamente a verificação contra o código mais recente.
4

Faça o Merge do PR

Assim que a verificação confirmar “would fix”, faça o merge do PR normalmente.
5

Verificação Pós-Merge

Depois que o PR é mesclado, o ZeroPath executa automaticamente a verificação novamente contra o código mesclado no branch de destino. Se a correção for confirmada, a issue é marcada como resolved no dashboard.

Resultados

O ZeroPath publica um comentário no seu PR e atualiza um status de check em dois momentos — antes e depois do merge.

Comentário no PR

Pré-Merge (Informativo)

Pós-Merge (Atualização de Status)

Status do Check

Um status de check dedicado Fix Verification é publicado no commit do PR junto com o comentário. Você pode usar esse check em regras de proteção de branch para exigir que a verificação de correção passe antes do merge.

Reinvestigação

Se a verificação inicial reportar “still present” mas você acredita que a sua correção está correta, envie o código atualizado e responda com:
Isso repete a verificação no código mais recente do PR nas plataformas que oferecem o comando. No GitHub, a verificação inicial por referência também pode ser executada quando o PR é reaberto ou marcado como pronto para revisão.

Verificação automática de correções em novas análises do PR

Quando uma nova análise concluída do PR deixa de detectar um achado de SAST aberto e confirmado no mesmo PR, o ZeroPath pode verificar se o código foi corrigido. Ele verifica até cinco achados elegíveis por análise, dentro do tempo disponível. Uma correção confirmada é registrada como Verified Fixed, sem precisar de uma referência ZP-ID. O achado continua aberto se a verificação for inconclusiva, o tempo acabar ou a análise do PR ficar incompleta. A verificação automática se aplica a achados do mesmo PR. Para uma issue de outro scan, adicione uma referência na descrição do PR.

Notas Importantes

  • Para issues referenciadas na descrição do PR, o resultado pré-merge é informativo. O status muda quando a verificação confirma a correção após o merge.
  • Achados elegíveis. Referencie um achado em aberto de um scan de código ou de dependências do mesmo repositório.
  • Reabertura de issues. Um scan posterior pode reabrir uma issue resolvida se detectar novamente a vulnerabilidade.
  • Plataformas. GitHub, GitLab e Bitbucket fazem verificações por referência antes e depois do merge. O Azure DevOps Services faz a verificação pós-merge quando o evento de merge inclui o commit mesclado e o commit anterior da branch de destino.