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 executa novamente a verificação de correção contra o código mais recente do PR. Diferentemente da verificação inicial (que roda apenas na abertura do PR), o retriage pode ser acionado a qualquer momento para verificar novamente após novos commits.

​
Notas Importantes

  • Os resultados pré-merge são informativos. O status da issue só é atualizado depois que o PR é mesclado e a verificação pós-merge confirma a correção.
  • Funciona para issues tanto de SAST quanto de SCA. Qualquer issue rastreada no dashboard do ZeroPath pode ser referenciada.
  • Autocorretivo. Se uma correção for marcada como resolvida incorretamente, o próximo full scan detectará novamente a vulnerabilidade e reabrirá a issue automaticamente.
  • Suportado no GitHub, GitLab e Bitbucket. O formato ZP-ID e as URLs do dashboard funcionam em todas as plataformas de VCS suportadas.