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/ouhttps://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:versionexato, comocom.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.Plugins privados do Gradle
Declare o repositório de plugins privados empluginManagement.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:
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.- Em Assets → Repositories, abra o repositório. Selecione a branch escaneada em Inventory e confira a resolução dos manifestos em Overview.
- Em Inventory → Dependencies, procure uma biblioteca interna conhecida e uma de suas dependências transitivas esperadas, incluindo as versões resolvidas.
- 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.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.
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.