Saltar para o conteúdo principal
Use a Análise de Composição de Software (SCA) para encontrar versões vulneráveis na sua branch e entender como entram no build. A ZeroPath compara as dependências que consegue resolver com avisos de segurança. Revise os caminhos das dependências, as evidências de alcançabilidade e a cobertura antes de escolher o que atualizar.

Execute o primeiro scan de dependências

  1. Conecte seu repositório. Confira a branch que deseja escanear e faça commit dos manifestos e lockfiles compatíveis.
  2. Em Settings do repositório, abra Full scans e confira se Full Scan Issue Types inclui SCA. O SCA vem ativado por padrão. Desative Custom Rules Only para que o scan completo execute a análise de SCA. Se estiver desativado em Dependencies, ative também SCA Scanning nessa seção.
  3. Selecione Scan repository, escolha a branch e inicie um scan completo. Quando terminar, abra a aba Inventory do repositório e confira a branch e o commit.
  4. Em Inventory → Overview, confira a resolução de manifestos da branch selecionada. Se a cobertura estiver incompleta, revise os avisos e corrija os arquivos ou a configuração do scan.

Registros privados de pacotes

Se a resolução dos pacotes exigir autenticação, configure a conexão com o registro privado antes de executar o scan. Para Maven, Gradle e sbt, consulte o guia de registros JVM.

Encontre o inventário e os achados

Escolha a visualização conforme a tarefa.

Aba Inventory do repositório

Inventory mostra o scan de dependências mais recente disponível para a branch selecionada. A visualização começa na branch padrão do repositório ou usa o scan mais recente disponível quando não há branch padrão registrada. Em Dependencies, confira o horário do scan e o commit ao lado da branch quando estiverem disponíveis. Use Dependencies para inspecionar as versões e os caminhos de um pacote.

PR de correção e fluxo atual do issue

Patch PR filtra pela aceitação do PR de correção. Current workflow indica o status atual do issue vinculado, mesmo ao consultar um scan antigo. Um issue resolvido pode aparecer em Not accepted se não houver PR de correção aceito. Abra o issue vinculado para revisar a decisão.

Priorize, corrija e verifique

  1. Abra um achado e confira a versão afetada e o caminho da dependência. Se o pacote for transitivo, siga o caminho até a dependência direta que o inclui na aplicação.
  2. Revise as evidências de alcançabilidade e o aviso de segurança. A alcançabilidade, a exploração conhecida e a severidade indicam aspectos diferentes da urgência.
  3. Revise o upgrade proposto ou faça a alteração manualmente. Quando o upgrade incluir um relatório de impacto, use-o para identificar os pontos de chamada que podem exigir testes.
  4. Faça commit do manifesto e do lockfile atualizados. Verifique a correção com um scan da branch afetada. Se o achado continuar aberto, confira o commit escaneado, as outras versões instaladas e os avisos de cobertura.

Mantenha os dados de dependências atualizados

Para agendar scans recorrentes, abra Settings → Dependencies → Dependency rescan schedule → Manage Schedule. Escolha um intervalo de pelo menos 24 horas entre execuções. Use Dependency scan branches para selecionar as branches. Se a lista estiver vazia, a ZeroPath usa a branch padrão do repositório. Ative os alertas de CVE para receber avisos sobre novas vulnerabilidades em dependências já inventariadas. Quando habilitado, o Supply Chain Intel também mostra evidências sobre ameaças em pacotes e verifica alterações de dependências npm e PyPI no GitHub.

Como a ZeroPath resolve dependências

O scan lê o commit selecionado, encontra os manifestos e lockfiles e resolve as dependências diretas e transitivas conforme os arquivos e o acesso aos registros permitem. A ZeroPath compara as versões resolvidas com avisos de segurança e registra as licenças. O inventário e os achados ficam associados à branch e ao commit do scan. Quando a resolução estiver incompleta, leia o aviso de cobertura do arquivo afetado. A falta de um lockfile compatível pode impedir a resolução de versões transitivas. Um erro de acesso ao registro pode impedir a resolução do pacote.

Outros guias de SCA

Escaneie uma imagem de contêiner

Use o escaneamento de contêineres para verificar os pacotes dentro de uma imagem construída ou as imagens referenciadas por um repositório.