Confira os avisos e corrija as lacunas
- 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.
- 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.
- 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.txttotalmente 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.
Avisos de cobertura
Use uma chave de API para chamarPOST /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 oivy.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: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 nobuild.gradle ou
build.gradle.kts de cada projeto:
./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:
Notas operacionais
Saída determinística
Saída determinística
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.
Snapshots históricos
Snapshots históricos
Cada scan captura um inventário pontual no tempo, permitindo diffs entre
scans, exportações de SBOM e investigações
retroativas.
Datação de exposição
Datação de exposição
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.
Recuperação automática
Recuperação automática
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.