Saltar para o conteúdo principal
Os analisadores de SCA do ZeroPath reconhecem os seguintes ecossistemas de fábrica:

npm / Yarn / pnpm

PyPI

Go modules

Maven / Gradle / SBT / Ivy

NuGet

RubyGems

crates.io (Cargo)

Packagist / Composer

Hex (Elixir)

Pub (Dart/Flutter)

Swift

Haskell (Hackage)

R (CRAN)

Cada registro de dependência rastreia se o ZeroPath a viu declarada diretamente ou trazida transitivamente, para que você possa aplicar políticas diferentes a escolhas próprias e a bibliotecas de terceiros. Dependências de desenvolvimento e opcionais declaradas nos seus manifestos também são inventariadas; a alcançabilidade ajuda a separar descobertas relevantes em runtime do ruído exclusivo de desenvolvimento.

Como a resolução funciona

O ZeroPath resolve seu grafo de dependências diretamente a partir dos seus manifestos sempre que possível. Também usa lockfiles commitados e resolução com ferramentas nativas nos ecossistemas suportados. O contrato prático é por ecossistema, resumido na tabela abaixo. Duas regras valem em todos os lugares:
  • Dependências diretas ainda podem ser escaneadas quando o grafo transitivo não pode ser construído, conforme descrito abaixo. O Ivy nativo exige uma resolução completa; uma falha deixa esse manifesto sem análise e gera um aviso de cobertura.
  • Versões desconhecidas não são adivinhadas. Se uma versão não pode ser determinada, por exemplo um intervalo não resolvido ou uma cadeia de pais quebrada, o pacote ainda é registrado no seu inventário e SBOM, mas não é comparado com vulnerabilidades. Isso evita falsos positivos causados por versões adivinhadas.
Pacotes privados? Siga o guia de Maven, Gradle e sbt. Maven e Gradle compartilham uma conexão; sbt precisa de uma conexão própria. Após conectar, execute um novo scan e confira a cobertura.

Cobertura sem um lockfile commitado

Para cada ecossistema marcado como Apenas dependências diretas, um lockfile ausente significa que as dependências transitivas não são resolvidas e os especificadores de intervalo permanecem ambíguos, prejudicando o pareamento de vulnerabilidades transitivas e a completude do SBOM. O ZeroPath ainda registra suas dependências diretas e sinaliza o manifesto com um aviso Transitive dependencies unresolved para que a lacuna fique visível. Veja Cobertura e avisos para saber como resolvê-la, incluindo os comandos para gerar cada lockfile.
Para npm/Yarn/pnpm, Maven e um requirements.txt totalmente fixado com ==, um lockfile commitado é opcional — ele apenas torna os scans mais rápidos e mais determinísticos.

Artefatos compilados e vendorizados

Artefatos JVM binários commitados no seu repositório, como JARs e WARs, são escaneados em busca dos pacotes embutidos dentro deles. Esses pacotes aparecem no seu inventário ao lado das dependências declaradas em código-fonte, com um selo de tipo de origem Compiled (por exemplo, JAR, WAR), para que você veja bibliotecas vendorizadas ou pré-compiladas que uma análise apenas de manifestos deixaria passar. O inventário de Dependencies permite filtrar por Source Type para isolar descobertas compiladas vs. declaradas em código-fonte.

Notas por ecossistema

Faça commit do pnpm-lock.yaml do workspace e dos manifestos dos membros que ele cobre. O ZeroPath lê as dependências do projeto em lockfiles pnpm suportados, inclusive quando o lockfile contém um documento de configuração separado. Se faltarem dependências declaradas, consulte os avisos de cobertura e gere um lockfile atualizado.
O ZeroPath trata o sufixo +incompatible usado por pacotes Go pré-módulos (versão principal 2+), pareando versões como v3.2.0+incompatible com advisories conhecidos. Pseudo-versões do Go (por exemplo, v0.0.0-20231215084216-abcdef123456) são snapshots de commit, não releases publicados, então o ZeroPath as registra no inventário mas não tenta parear versões de advisories com elas.
Builds multi-módulo (reactor) são totalmente resolvidos: o ZeroPath indexa cada POM no repositório e resolve referências <parent> entre módulos mesmo quando <relativePath/> está vazio ou ausente, de modo que um filho pode herdar versões de <dependencyManagement> do pai de um irmão. POMs pai que declaram dependências apenas em <dependencyManagement> são capturados, e artefatos com classifier são atribuídos ao pacote correto. Quando um POM pai não pode ser resolvido local ou remotamente, versões herdadas por meio dessa cadeia são tratadas como não resolvidas em vez de adivinhadas.
Além das declarações simples em build.gradle(.kts), o ZeroPath também reconhece dependências declaradas por meio de catálogos de versões (libs.versions.toml), convention plugins, restrições de platform/BOM e o Kotlin DSL. As transitivas podem vir da resolução nativa Gradle ou de um gradle.lockfile commitado. Para bibliotecas ou plugins privados, configure a conexão Maven / Gradle.Se um plugin de build precisar de Java mais recente, o ZeroPath pode tentar a resolução novamente com um JDK instalado que seja compatível com o plugin e com a versão do Gradle. Se nenhum JDK for compatível, confira o aviso de resolução.
O ZeroPath resolve ivy.xml com o Ivy nativo, preservando as versões selecionadas, os mapeamentos de configuração, os descritores herdados, as exclusões e os caminhos transitivos. Os pacotes usam a identidade Maven organisation:module. Isso funciona no SCA padrão e no de próxima geração. A resolução lê metadados sem compilar o projeto nem baixar JARs das dependências. O ivysettings.xml no mesmo diretório suporta resolvedores Maven, URL, filesystem, chain e dual, configurações incluídas e arquivos de propriedades. Arquivos locais devem permanecer no repositório. Targets Ant, plugins personalizados, repositórios SSH/SFTP e propriedades calculadas por um build não são suportados e geram um aviso de cobertura. O patcher de upgrade Maven não atualiza arquivos Ivy.Conexões de registro Maven também fornecem credenciais para repositórios Ivy privados.
O ZeroPath registra dependências diretas a partir do build.sbt e pode resolver transitivas com sbt nativo. Também analisa lockfiles commitados: build.sbt.lock (sbt-dependency-lock) ou lock.sbt (sbt-lock). Conecte bibliotecas privadas e plugins de build pela conexão sbt. Confira os avisos de cobertura se o build ou a resolução de dependências falhar.A resolução nativa preserva o identificador publicado do artefato, incluindo o sufixo binário do Scala, por exemplo org.typelevel:cats-core_2.13.
Os ids de pacote são pareados sem diferenciar maiúsculas de minúsculas, então diferenças de capitalização entre um manifesto e o registro nunca causam uma perda. Opte pelo modo de lockfile do NuGet e faça commit de packages.lock.json (dotnet restore --use-lock-file --force-evaluate, NuGet 4.9+) para cobertura transitiva.
Crates binários commitam Cargo.lock por padrão, e o ZeroPath o usa diretamente. Crates de biblioteca comumente o omitem (conforme a orientação do Cargo); faça commit de Cargo.lock (cargo generate-lockfile) para cobertura transitiva. Um crate que resolve para múltiplas versões no mesmo grafo é reportado como pares (name, version) separados, de modo que cada um chega ao pareamento com advisories.
Todos os formatos comuns são suportados:
  • requirements.txt — formato padrão do pip
  • Pipfile — Pipenv ([packages] / [dev-packages])
  • pyproject.toml (Poetry) — incluindo dependências de grupo do 1.2+
  • pyproject.toml (PEP 621) — a tabela [project] usada por uv, hatch, flit, setuptools e pdm (tanto dependencies quanto optional-dependencies)
Cada descoberta registra a posição de um pacote no grafo (direto ou transitivo) e a cadeia que o introduziu, e linka de volta para o arquivo de manifesto e a linha exatos onde a dependência foi declarada, em vez do lockfile. Um pacote alcançado por múltiplos caminhos de dependência é deduplicado em uma única entrada de inventário, de modo que as contagens refletem pacotes únicos. Veja Raio de impacto para saber como a cadeia de dependência se torna impacto em pontos de chamada durante um upgrade.