> ## Documentation Index
> Fetch the complete documentation index at: https://zeropath.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Registros privados Maven, Gradle e sbt

> Conecte Artifactory ou Nexus, verifique o acesso a pacotes privados e confira a cobertura após o scan.

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:

| Seu build | Conexão | Autenticação |
| - | - | - |
| Maven (`pom.xml`) | **Maven / Gradle** | Basic ou Bearer token |
| Gradle (`build.gradle` ou `build.gradle.kts`) | **Maven / Gradle** | Basic ou Bearer token |
| sbt (`build.sbt`) | **sbt (Scala / Java)** | Apenas Basic: usuário e senha ou token de identidade |

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](https://zeropath.com/app/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`:

```kotlin theme={null}
pluginManagement {
    repositories {
        maven { url = uri("https://mycorp.jfrog.io/artifactory/maven-virtual/") }
        gradlePluginPortal()
    }
}
```

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:

| Campo | O que informar |
| - | - |
| **Maven repository URL** | A URL HTTPS do repositório virtual ou de grupo, incluindo as dependências de fontes públicas. |
| **Username** e **Password / identity token** | Uma conta com acesso de leitura às bibliotecas e plugins. sbt usa autenticação Basic. |
| **Authentication realm** | O realm retornado pelo desafio de autenticação HTTP do registro. O Artifactory costuma usar `Artifactory Realm`; confirme com o administrador do registro. |
| **Private package to verify** | Uma coordenada publicada em layout Maven, como `com.example:shared-library_2.12:1.2.3`. Inclua o sufixo Scala do nome do artefato publicado. |
| **Ivy repository URL (optional)** | Um repositório Ivy HTTPS se o launcher ou os plugins sbt usarem layout Ivy. Deve usar o mesmo host, porta e credenciais da URL Maven. |
| **Ivy metadata path** | Obrigatório ao fornecer uma URL Ivy. Informe o caminho relativo de um arquivo XML de metadados existente, como `org.example/plugin/scala_2.12/sbt_1.0/1.0/ivys/ivy.xml`, sem barra inicial. |

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](https://zeropath.com/docs/pt/sca/coverage.md#read-and-act-on-warnings) e confira o
   acesso ao registro e a configuração do build antes de repetir o scan.

> [!NOTE]
>
> **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](https://zeropath.com/docs/pt/sca/coverage.md#gradle-and-sbt-lockfiles).
Se o scan indicar um erro na conexão de registro salva, corrija a conexão antes
de repetir o scan.

> [!WARNING]
>
> 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

| O que você vê | O que verificar |
| - | - |
| O pacote de validação é público | Escolha um pacote interno cujo POM não possa ser lido anonimamente. Uma dependência pública não verifica suas credenciais. |
| Unauthorized, 401 ou 403 | Confira usuário, validade do token, modo de autenticação e permissões de leitura para o repositório e o pacote. |
| O POM do pacote privado não pôde ser lido | Confira a URL completa, a coordenada exata e o POM publicado. Para artefatos Scala, inclua o sufixo publicado, como `_2.12` ou `_2.13`. |
| Authentication realm mismatch | Use o realm do desafio HTTP do registro. Consulte o administrador se ele diferir do padrão. |
| Os metadados Ivy não puderam ser lidos | Confira URL Ivy, caminho XML relativo e permissões de leitura. As URLs Maven e Ivy devem compartilhar host e porta. |
| Um plugin Gradle não foi resolvido | Confira `pluginManagement.repositories`, os metadados e o acesso ao repositório do plugin. |
| A conexão funciona, mas a resolução falha | Leia o aviso do manifesto. Confira acesso a outros pacotes, POMs pai, BOMs, launcher ou plugins sbt e fontes públicas. A validação testa apenas o pacote escolhido. |
| Uma conexão JVM salva está inutilizável | Leia o erro do scan, edite a conexão, corrija a URL ou as credenciais, salve e execute um novo scan. |

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.