Saltar para o conteúdo principal
Conecte seu registro de pacotes para que o ZeroPath resolva bibliotecas internas e as dependências que elas trazem para sua aplicação. Use esta configuração quando um build Maven, Gradle ou sbt precisar de pacotes privados, POMs pai, BOMs ou plugins de build.

Escolha a conexão

Em Settings → Integrations → Registries → Package registries, escolha: As conexões se aplicam à organização. Você pode salvar uma conexão Maven / Gradle e uma conexão sbt. Se escanear os dois tipos de build, configure as duas conexões, mesmo que usem o mesmo registro e a mesma conta.

Antes de conectar

  • Você precisa da permissão Create Integrations.
  • Use uma conta ou token dedicado com acesso de leitura aos pacotes e plugins de build necessários para seus projetos.
  • Obtenha a URL HTTPS de um repositório virtual ou de grupo que disponibilize seus pacotes internos e funcione como proxy para as dependências públicas. Use o endpoint do repositório, como https://mycorp.jfrog.io/artifactory/maven-virtual/ ou https://nexus.example.com/repository/maven-public/, em vez da página de login do registro. A resolução nativa Maven direciona todos os repositórios para essa URL.
  • Escolha um pacote privado publicado cujo POM exija autenticação. Você precisará do group:artifact:version exato, como com.example:shared-library:1.2.3.
  • No ZeroPath hospedado, o registro deve estar acessível pela internet pública; endereços de redes privadas são rejeitados. Uma instância self-hosted pode usar registros em sua rede privada. HTTPS continua obrigatório, e endereços de loopback e de metadados de nuvem permanecem bloqueados.

Conecte Maven ou Gradle

1

Abra Package registries

Abra Settings → Integrations. Selecione Add Integration → Registries, localize Maven / Gradle em Package registries e clique em Connect.
2

Informe o repositório e as credenciais

Preencha Registry URL com a URL do repositório virtual ou de grupo.Para Basic, informe Username e Password / identity token. Para Bearer token, informe o token sem usuário. Se seu build Gradle lê .artifactory_credentials, ARTIFACTORY_USERNAME ou ARTIFACTORY_PASSWORD, escolha Basic para disponibilizar esses valores durante a configuração do build. Salve o segredo neste formulário, não no repositório ou na URL.
3

Verifique um pacote privado

Em Private package to verify, informe o group:artifact:version de um pacote privado publicado e clique em Connect registry. O ZeroPath verifica que o pacote exige autenticação e que suas credenciais permitem ler o POM. Não é necessário permitir listagem de diretórios.Para com.example:shared-library:1.2.3, o POM deve estar disponível em com/example/shared-library/1.2.3/shared-library-1.2.3.pom, relativo à URL do repositório. Um JAR sem POM não é suficiente para essa verificação.
A conexão fornece credenciais para consultas de POM/BOM Maven e para a resolução nativa de dependências Maven e Gradle. Ela também atende à configuração de builds Gradle que lê o arquivo ou as variáveis de ambiente do Artifactory citados acima.

Plugins privados do Gradle

Declare o repositório de plugins privados em pluginManagement.repositories, no settings.gradle ou settings.gradle.kts. Um repositório declarado apenas no bloco repositories do projeto não configura a resolução de plugins. Exemplo em settings.gradle.kts:
O ZeroPath fornece autenticação para repositórios Maven no host conectado, incluindo os repositórios de plugins declarados. O repositório deve conter o plugin e os metadados necessários; verificar o POM de uma biblioteca não comprova acesso aos plugins.

Conecte sbt

Em Package registries, clique em Connect para sbt (Scala / Java) e preencha estes campos: Clique em Connect registry. O ZeroPath verifica o POM privado e o arquivo de metadados Ivy, se fornecido. Peça ao administrador do registro o caminho Ivy exato; ele não é uma coordenada Maven nem uma listagem de diretório. As credenciais ficam disponíveis antes que o sbt inicie e carregue sua definição de build, incluindo dependências privadas do meta-build e plugins. Ivy, Coursier e builds que leem .artifactory_credentials ou ARTIFACTORY_USERNAME / ARTIFACTORY_PASSWORD podem usar a conexão. Não é necessário fazer commit dessas credenciais no projeto.

Execute um scan e confira a cobertura

Após conectar, execute um novo scan completo ou de SCA do repositório afetado. As conexões salvas são usadas automaticamente; resultados anteriores não são atualizados.
  1. Em Assets → Repositories, abra o repositório. Selecione a branch escaneada em Inventory e confira a resolução dos manifestos em Overview.
  2. Em Inventory → Dependencies, procure uma biblioteca interna conhecida e uma de suas dependências transitivas esperadas, incluindo as versões resolvidas.
  3. Se o scan falhar, leia o erro. Se a cobertura estiver incompleta, veja como consultar os avisos de manifesto e confira o acesso ao registro e a configuração do build antes de repetir o scan.
Connected confirma acesso ao pacote usado na verificação. O scan verifica o restante do build e suas dependências transitivas.
Gradle e sbt podem resolver transitivas com suas ferramentas nativas ou um lockfile commitado em formato suportado: gradle.lockfile, build.sbt.lock ou lock.sbt. Para evitar executar o build durante o scan, gere o lockfile 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. Veja a configuração e os comandos dos lockfiles. Se o scan indicar um erro na conexão de registro salva, corrija a conexão antes de repetir o scan.
Para pacotes Maven publicados apenas em repositórios privados, algumas dependências transitivas podem continuar sem resolução após conectar. Confira a cobertura do scan e contate o suporte com a URL do scan e as coordenadas dos pacotes afetados se faltarem dependências esperadas.

Solução de problemas

Se o aviso persistir, envie ao suporte a URL do scan, o caminho do manifesto, a mensagem do aviso e uma coordenada que deveria ter sido resolvida. Não inclua tokens ou senhas. Para trocar credenciais, use Edit e salve o novo segredo. Deixar o campo vazio mantém o segredo atual; alterar o modo de autenticação exige um novo segredo. As mudanças se aplicam aos próximos scans em toda a organização.