Saltar para o conteúdo principal

Visão Geral

A extensão ZeroPath Security integra a plataforma ZeroPath diretamente ao VS Code. Veja scans de segurança, navegue por vulnerabilidades e aplique patches gerados por IA sem sair do seu ambiente de desenvolvimento.

Instalação

1

Abrir as Extensões

No VS Code, pressione Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (macOS).
2

Pesquisar e Instalar

Pesquise por “ZeroPath Security” e clique em Install.
3

Começar

Clique no ícone da ZeroPath na Activity Bar (barra lateral esquerda) para abrir o painel de configuração.

Pré-requisitos

  • VS Code versão 1.74.0 ou superior
  • Git instalado e no seu PATH
  • Seu workspace deve ser um repositório Git com um remote chamado origin
  • Visualizar scans e issues do repositório exige que a URL do remote origin corresponda a um repositório que foi adicionado à ZeroPath e escaneado por ela
  • Uma conta ZeroPath com credenciais de API (obtenha em Settings → API keys)

Autenticação

  1. Clique no ícone da ZeroPath na Activity Bar (barra lateral esquerda).
  2. Clique em “Configure Credentials” na tela de boas-vindas.
  3. Insira seu API Token ID e seu API Token Secret (obtidos no dashboard da ZeroPath em Settings → API keys).
  4. Selecione seu VCS provider (GitHub, GitLab, Bitbucket, Gerrit ou Generic).
As credenciais são armazenadas com segurança no Secret Storage do VS Code (armazenamento criptografado no nível do sistema operacional — Keychain no macOS, Credential Manager no Windows, libsecret no Linux). Elas nunca são gravadas em settings.json. A extensão detecta automaticamente sua organização a partir do seu token de API e associa seu workspace ao repositório ZeroPath correspondente usando a URL do seu remote Git. A extensão adiciona um painel dedicado na barra lateral, acessível pelo ícone da ZeroPath na Activity Bar.

Seção de Scans

  • Veja os 5 scans mais recentes do seu repositório
  • Filtre por tipo de scan: Full Scans, PR Scans ou Both
  • Cada scan mostra:
    • Badge de status (completed, running, failed)
    • Contagem de issues abertas
    • Tipo de scan e timestamp
  • Clique em um scan para carregar as issues associadas a ele

Seção de Issues

  • Pesquise issues por título, descrição, arquivo, classe de vulnerabilidade ou severidade
  • Issues ordenadas por pontuação de prioridade, depois por severidade e depois por confiança
  • Cada issue mostra:
    • Título, badge de severidade (com código de cores) e status
    • Arquivo afetado e número da linha
    • Indicador de disponibilidade de patch
  • Expanda qualquer issue para ver:
    • Descrição completa e orientação de remediação
    • Pontuação, severidade, confiança, CWEs
    • Trecho do código afetado
    • Diff do patch (se disponível)
    • Link para o dashboard da ZeroPath

Cores de Severidade

Comandos

Todos os comandos estão acessíveis pela Command Palette (Cmd/Ctrl+Shift+P):

Scans de Código Sob Demanda

Para revisar o arquivo ou o diff em que você está trabalhando, execute zeropath scan-code no terminal do VS Code. Consulte Scans de código sob demanda para ver as opções da CLI, o contexto de repositório e a API.

Aplicando Patches

A extensão oferece três fluxos de trabalho para patches:
Quando um achado tem um patch gerado por IA, a visão expandida da issue mostra um botão “Apply This Patch” ao lado de uma prévia do diff com destaque de sintaxe. Clicar nele aplica o patch localmente via git apply.
Para issues sem um patch existente, clique em “Request Patch” na barra lateral. A ZeroPath vai gerar uma correção no lado do servidor, e a barra lateral será atualizada quando o patch estiver pronto.

Configuração

Configure a extensão pelas Configurações do VS Code (Cmd/Ctrl+,):

Solução de Problemas

Certifique-se de ter uma pasta aberta no VS Code com um diretório .git inicializado.
Verifique se o seu repositório tem um remote origin: execute git remote -v.
Verifique se suas credenciais de API estão corretas e se o seu token tem acesso a pelo menos uma organização. Defina zeropath.organizationId manualmente nas configurações se a detecção automática falhar.
Certifique-se de não ter alterações não commitadas que conflitem com o patch. Tente fazer pull das alterações mais recentes primeiro.