Saltar para o conteúdo principal

Como Funciona

O ZeroPath pode gerar automaticamente correções de código para vulnerabilidades detectadas e abrir pull requests com a remediação. O sistema analisa o contexto da vulnerabilidade, escreve uma correção direcionada e a apresenta para sua revisão antes que qualquer mudança chegue ao seu código.
  • Patches gerados por IA — as correções são geradas por um agente de IA que entende a vulnerabilidade, o código ao redor e o padrão de remediação apropriado.
  • Humano no circuito — por padrão, os patches exigem aprovação explícita antes que um PR seja criado. Você revisa o diff, aprova, e o ZeroPath abre o PR.
  • Tanto SAST quanto SCA — vulnerabilidades em nível de código recebem correções de código; vulnerabilidades de dependências recebem atualizações de versão com as devidas atualizações de lockfile. PRs de correção automática são suportados para descobertas tanto de SAST quanto de SCA, de modo que patches de vulnerabilidades de dependências seguem o mesmo fluxo de revisão e merge das correções de código.

Solicitando um Patch

1

Navegue até uma Descoberta

Abra um achado e selecione Fix. Para gerar um patch, o ZeroPath precisa conseguir clonar o repositório pela conexão configurada.
2

Gere o Patch

Clique em “Generate Patch” na visão de detalhes da issue. O ZeroPath gera um diff git direcionado à vulnerabilidade.
3

Revise as Mudanças

Revise as mudanças propostas no dashboard.
4

Aprove ou Regenere

Selecione Approve and Issue Patch para solicitar um PR ou Adjust Patch para pedir uma revisão. Você pode enviar até 4.000 caracteres de feedback e comparar até três candidatos. Escolha o candidato que deseja usar. Para aplicar o patch manualmente, use Patch Diff → Download .diff.

Pull Requests Automáticos

Quando você aprova um patch (ou quando a geração automática de PRs está habilitada), o ZeroPath:
  1. Cria uma branch de correção para a branch do scan. Quando a branch do scan não está disponível, usa a branch padrão do repositório.
  2. Aplica a correção como um commit com uma mensagem descritiva.
  3. Abre um pull request com:
    • Um título claro descrevendo a correção (ex.: “Fix SQL injection in user authentication handler”)
    • Uma descrição cobrindo a vulnerabilidade, a correção, a causa raiz e a abordagem de implementação.
  4. Vincula o PR de volta à descoberta no ZeroPath para rastreamento.

Solicitando Mudanças Adicionais no GitHub

Depois que o ZeroPath abre um PR de patch no GitHub, os revisores podem solicitar mudanças comentando no PR com @ZeroPath e uma descrição concreta da edição. Se o ZeroPath conseguir verificar que o branch atual do PR é o branch de patch que ele criou, ele faz o commit da mudança solicitada nesse mesmo branch e responde com um resumo e a referência do commit.
PR comment
Se o branch não puder ser verificado, se o branch mudou enquanto a solicitação estava sendo preparada, ou se a solicitação for insegura, ambígua, impossível ou não relacionada ao patch, o ZeroPath responde sem enviar um commit. Veja Comandos do Bot para detalhes. Plataformas de VCS com suporte a auto-PR: A conexão precisa permitir o envio de commits e a abertura de PRs. Para importações de CVS, Gerrit e Git genérico, baixe o patch e aplique-o no seu fluxo normal.

Rastreamento do Ciclo de Vida do PR

O ZeroPath rastreia o status dos PRs gerados:
  • Open — o PR foi criado e aguarda revisão.
  • Accepted — o PR foi mesclado. Normalmente, o achado passa para Resolved. Confira o status atual e as evidências de verificação antes de concluir a remediação.
  • Rejected — o PR foi fechado sem merge.

O Que Pode Ser Corrigido Automaticamente

Vulnerabilidades de Código (SAST)

O agente de IA pode gerar correções para a maioria dos problemas de segurança em nível de código, incluindo:
  • Injeção de SQL
  • XSS
  • Path traversal
  • Injeção de comando
  • SSRF
  • Criptografia insegura
  • Verificações de autenticação/autorização ausentes
  • e mais…
Alguns tipos de vulnerabilidade não podem ser corrigidos automaticamente e serão marcados como tal:
  • Segredos hardcoded (exigem rotação manual e migração para um gerenciador de segredos)
  • Problemas complexos de lógica de negócio (condições de corrida, autorização entre múltiplos sistemas)
  • Problemas arquiteturais em que a causa raiz está fora do arquivo afetado
Quando uma descoberta não pode ser corrigida automaticamente, o ZeroPath agora fornece instruções de remediação explicando por que a correção não pôde ser gerada e quais passos manuais você deve seguir para resolver o problema.

Vulnerabilidades de Dependências (SCA)

Para dependências vulneráveis, o ZeroPath:
  • Procura a versão estável publicada mais próxima sem avisos conhecidos. Quando não há uma, procura a versão mais próxima que corrige o aviso em questão sem introduzir novos. Consulte a seleção de upgrades.
  • Para dependências diretas: atualiza a versão no seu arquivo de manifesto e regenera o lockfile usando o gerenciador de pacotes apropriado.
  • Para dependências transitivas: atualiza a dependência direta pai que traz o pacote vulnerável.
Ecossistemas suportados para patches de dependências:
  • npm / Node.js
  • Módulos Go
  • Rust / Cargo
  • Ruby / Bundler
  • Python / Poetry
  • Python / pip
  • Maven / Gradle
  • e mais…

Configuração

As configurações de geração de patches seguem a herança em níveis de organização/tag/repositório:

Referências a Tickets do Jira em Templates

Quando uma descoberta tem um ticket do Jira vinculado, você pode referenciá-lo nos templates de título de PR, descrição de PR, nome de branch e mensagem de commit usando os seguintes placeholders: Por exemplo, um template de nome de branch fix/{jira_id}/{vuln_class} produziria um branch como fix/PROJ-123/sql-injection quando a descoberta estiver vinculada a um ticket do Jira. Se nenhum ticket do Jira estiver vinculado, os placeholders são omitidos e o template é preenchido apenas com o contexto de vulnerabilidade disponível.

Configurações Específicas de SCA

Solução de Problemas

PRs de correção para achados de escaneamentos interrompidos

Você pode aprovar um patch para um achado que o ZeroPath registrou antes de o escaneamento ser interrompido. O ZeroPath tenta abrir o PR de correção solicitado. Se a tentativa falhar, o painel do patch exibe o motivo.

Erro de Permissão em Workflow do GitHub Actions

Se um patch modificar um arquivo de workflow do GitHub Actions (em .github/workflows/), a criação do PR pode falhar com um erro de permissão. O GitHub exige a permissão workflows para criar ou atualizar arquivos de workflow via API. Para resolver isso:
  • Aplique o patch manualmente — copie as mudanças sugeridas e faça o commit você mesmo.
  • Peça a um administrador do repositório para criar o PR — administradores com permissões suficientes podem enviar a mudança de workflow.
  • Conceda a permissão de workflows — se a política da sua organização permitir, adicione a permissão workflows à instalação do GitHub App do ZeroPath.

Violações de Regras do Repositório

Se o seu repositório tiver regras de proteção de branch que impõem formatos de mensagem de commit ou padrões de nomenclatura de branch, a criação do PR pode falhar. Atualize as regras do seu repositório ou ajuste os formatos de nome de branch e de mensagem de commit dos PRs do ZeroPath em Settings → Remediation → Pull request templates na página do repositório (consulte as configurações do scanner) e tente novamente.

Guia de Adoção

  1. Comece com patches sob demanda — clique em “Generate Patch” em descobertas individuais para avaliar a qualidade das correções geradas para o seu código.
  2. Habilite sugestões em PR scans — ative prScanAutoPatching para receber sugestões de correção como comentários inline nos seus pull requests.
  3. Ajuste os limiares — configure os limiares de patch e de PR para focar o auto-patching primeiro nas descobertas de alta severidade.
  4. Habilite o auto-patching em full scans — quando estiver confortável com a qualidade dos patches, habilite a geração automática de patches para full scans.
  5. Considere a criação automática de PRs — para equipes com ciclos de revisão rápidos, habilite o auto-PR para que os branches de correção sejam criados automaticamente.