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:- Formato ZP-ID
- URL do Dashboard
Referencie uma ou mais issues pelo seu UUID:Separadas por vírgula para múltiplas issues:
Onde Encontrar o UUID da Issue
Navegue até a página de detalhes da issue no dashboard do ZeroPath. O UUID aparece na URL: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: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ênciaZP-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.