Saltar para o conteúdo principal
A cobertura mostra quais manifestos a ZeroPath resolveu completamente e em quais arquivos os dados de dependências estão incompletos.

Confira os avisos e corrija as lacunas

  1. Em Assets → Repositories, abra o repositório e selecione a branch em Inventory → Overview. Confira a porcentagem de resolução de manifestos em SBOM coverage, quando disponível.
  2. Para descobrir o motivo e o caminho do arquivo, liste os avisos do repositório. As correções comuns incluem fazer commit de um lockfile compatível e corrigir o acesso ao registro.
  3. Execute outro scan na mesma branch após corrigir o problema. Confira os resultados antes de considerar resolvida a ausência de um pacote ou achado.

Cobertura de resolução

A resolução de manifestos é a proporção de manifestos encontrados que a ZeroPath resolveu por completo. A taxa pode ser baixa quando algumas dependências só foram resolvidas em parte ou ficaram sem resolução. Se a cobertura da branch ainda não tiver sido medida, execute um novo scan de dependências.

Fidelidade de resolução

A fidelidade descreve como a ZeroPath obteve o grafo de dependências.
  • Deterministic — resolvido a partir de um lockfile commitado (ou de um requirements.txt totalmente fixado com ==, que é tratado como equivalente a um lockfile), de modo que o inventário reflete exatamente as versões fixadas às quais seu build está travado.
  • Build-less — grafo transitivo completo resolvido diretamente do manifesto, sem necessidade de lockfile, incluindo a resolução nativa de Ivy. Veja Ecossistemas suportados para a matriz por ecossistema.
  • Degraded (direct-only) — apenas as suas dependências diretas foram resolvidas, por exemplo porque falta um lockfile obrigatório ou a resolução nativa falhou. Descobertas em dependências diretas ainda aparecem; apenas a cauda transitiva está ausente. Este é o estado a corrigir.
Para Ivy, uma falha de resolução deixa tanto as dependências diretas quanto as transitivas sem análise. Leia o aviso por manifesto; um resumo degradado do ecossistema não garante cobertura de dependências diretas para cada manifesto.

Avisos de cobertura

Use uma chave de API para chamar POST /api/v2/sca/listWarnings com organizationId e os IDs dos repositórios em repositoryIds. Por padrão, a resposta lista os avisos ativos e inclui o tipo, o caminho do arquivo e a mensagem. Use search para buscar o caminho de um manifesto ou lockfile e passe nextCursor como cursor para ler a página seguinte. Compare a data do aviso com a do scan que você está investigando.
Os três primeiros avisos dizem respeito à resolução de dependências e são resolvidos seguindo a orientação por manifesto para corrigir lockfiles, configurações ou acesso a registros. A variante de infraestrutura costuma se resolver ao repetir o scan; entre em contato com o suporte se a falha persistir. Uma anomalia de zero dependências é um sinal consultivo para reverificar e reescanear, não necessariamente uma correção de lockfile. Os três últimos são avisos transitórios de fonte de dados que geralmente se resolvem sozinhos no próximo scan.

Avisos de cobertura de lockfiles

Se um lockfile commitado não puder ser lido ou não cobrir todas as dependências declaradas, alguns pacotes podem ser analisados nas versões declaradas. As descobertas afetadas podem continuar abertas. Gere um novo lockfile com o gerenciador de pacotes, faça commit dele com os manifestos correspondentes e execute outro scan. Em workspaces pnpm, inclua o lockfile do workspace e os manifestos dos membros afetados.

Falhas de registro Maven, Gradle e sbt

Se o aviso identificar um POM Maven que não pôde ser lido, confirme se o POM da coordenada foi publicado e se o registro permite acesso de leitura. Se um build precisa de bibliotecas privadas, POMs pai, BOMs ou plugins, siga Registros privados Maven, Gradle e sbt. Maven e Gradle compartilham uma conexão; sbt usa uma conexão separada com realm de autenticação e repositório Ivy opcional. Uma conexão bem-sucedida verifica o pacote privado escolhido, não o build completo. Execute um novo scan, leia os avisos dos manifestos afetados e confira se os pacotes internos e transitivos esperados aparecem com versões resolvidas. Gradle e sbt podem resolver transitivas sem lockfile quando a resolução nativa funciona. Como alternativa, gere um lockfile suportado no seu ambiente de build com acesso ao registro e faça commit dele. Quando o manifesto é resolvido pelo lockfile, o ZeroPath não executa a resolução nativa do build. Se o scan indicar um erro na conexão de registro salva, corrija a conexão antes de repetir o scan.

Falhas de resolução Ivy

Assim como Maven, Ivy não exige um lockfile quando a resolução nativa funciona. Se ela falhar, tanto o SCA padrão quanto o de próxima geração mostram um aviso Dependency resolution failed para o ivy.xml afetado, em vez de um aviso Missing lockfile. Ivy exige uma resolução nativa bem-sucedida e não tem fallback limitado a dependências diretas. Verifique ivy.xml, seu ivysettings.xml no mesmo diretório, os arquivos incluídos e as propriedades necessárias. Targets Ant não são executados, então propriedades calculadas por um build devem ser fornecidas em configurações Ivy ou arquivos de propriedades commitados. Verifique também o acesso e as credenciais armazenadas para repositórios privados. Criar um lockfile não resolve uma falha de configuração Ivy. Veja Ecossistemas suportados para as configurações Ivy suportadas.

Por que as descobertas não desaparecem em um scan com falha

Quando um manifesto não pode ser resolvido durante um scan, o ZeroPath carrega adiante as descobertas de SCA existentes para ele em vez de marcá-las como resolvidas. Isso impede que uma vulnerabilidade confirmada desapareça silenciosamente por causa de uma falha transitória de resolução. Uma descoberta só é resolvida automaticamente quando seu manifesto foi analisado com sucesso e a vulnerabilidade realmente desapareceu.

Gere lockfiles antes de escanear

Quando o aviso indicar um lockfile ausente, gere e faça commit do arquivo suportado para aquele ecossistema. Para falhas de registro ou build JVM, confira primeiro a configuração do registro. Os comandos abaixo produzem os arquivos que o ZeroPath procura:
Para npm/Yarn/pnpm, Maven, Ivy e um requirements.txt totalmente fixado com == (que o ZeroPath trata como equivalente a um lockfile para resolução determinística), as dependências podem ser resolvidas sem lockfile — veja Ecossistemas suportados.

Lockfiles Gradle e sbt

Para Gradle, primeiro habilite o travamento de dependências no build.gradle ou build.gradle.kts de cada projeto:
Depois, resolva as dependências do projeto e gere o lockfile:
Em um build com vários projetos, execute a tarefa para cada subprojeto relevante, por exemplo ./gradlew :app:dependencies --write-locks. Faça commit dos arquivos gradle.lockfile gerados. Só são incluídas as configurações com travamento habilitado que a tarefa resolver; veja o guia de travamento de dependências do Gradle. Para sbt, instale o sbt-dependency-lock em project/plugins.sbt, depois gere e faça commit de build.sbt.lock:
Gere esses lockfiles no seu ambiente de build com acesso aos registros privados usados pelos projetos.
A plataforma de Agentes do ZeroPath inclui um playbook Coverage Autopilot que lê os avisos de cobertura registrados após cada scan, publica orientações por manifesto e pode abrir pull requests que geram lockfiles.

Notas operacionais

Inventários, alertas e SBOMs são gerados a partir do mesmo conjunto de dados ordenado, de modo que diffs e revisões permanecem estáveis de um scan para o outro.
Cada scan captura um inventário pontual no tempo, permitindo diffs entre scans, exportações de SBOM e investigações retroativas.
O SCA captura o commit git mais antigo que introduziu uma entrada de manifesto afetada, para que você veja há quanto tempo uma vulnerabilidade vive no seu histórico.
Scans são retomados após interrupções, falhas repetidas são limitadas, jobs obsoletos são limpos e inventários concluídos são reutilizados sempre que possível.