Fazer o download de pacotes do Assured OSS usando um repositório remoto

Para acessar e baixar pacotes do Assured Open Source Software (Assured OSS), configure um repositório remoto do JFrog Artifactory ou do Sonatype Nexus. Essa configuração permite que você use um proxy e faça o download de pacotes do Assured OSS pelo gerenciador de artefatos atual. Para mais informações sobre as opções de repositório, consulte Opções de repositório do Assured OSS.

Este documento se aplica ao nível sem custo financeiro. Para o nível Premium, consulte Fazer o download de pacotes do Assured OSS usando um repositório remoto.

Antes de começar

  1. Ative o Assured OSS.

  2. Valide a conectividade com o Assured OSS para as contas de serviço solicitadas.

Configurar um repositório remoto usando o JFrog Artifactory

  1. Faça login no gerenciador de repositórios do JFrog Artifactory. Verifique se você tem os privilégios necessários para criar um novo repositório remoto.
  2. Selecione a opção para criar um novo repositório remoto no gerenciador de repositórios.
  3. Selecione o tipo de repositório apropriado (por exemplo, selecione Maven para Java, PyPi para Python ou Go para Go).

  4. Se quiser, teste a conexão com o repositório Java ou Python seguindo estas etapas:

    1. No campo Chave do repositório, insira um nome ou identificador exclusivo para o repositório remoto.

    2. No campo URL, insira uma das seguintes opções:

      • Java: 
        https://us-maven.pkg.dev
      • Python: 
        https://us-python.pkg.dev
      • JavaScript: 
        https://us-npm.pkg.dev
      • Go: 
        https://us-go.pkg.dev

      Não insira o nome de domínio completo, porque essa ação pode retornar um código de status HTTP 404 ou HTTP 405.

    3. Deixe os outros campos em branco.

    4. Clique em Testar. A conexão será bem-sucedida quando você encontrar a seguinte saída:

      Successfully connected to server

  5. Para criar um novo repositório remoto, insira as seguintes informações:

    1. No campo Chave do repositório, insira um nome ou identificador exclusivo para o repositório remoto. Por exemplo, assured-oss-java-repo.

    2. No campo URL, insira uma das seguintes opções:

      • Java: 
        https://us-maven.pkg.dev/cloud-aoss/java
      • Python: 
        https://us-python.pkg.dev/cloud-aoss/python
      • Go: 
        https://us-go.pkg.dev/cloud-aoss/go

    3. No campo Nome de usuário, digite _json_key_base64.

    4. No campo Senha, forneça a string codificada em Base64 do arquivo de chave JSON da conta de serviço. Use a string inteira codificada em base64 em uma única linha como senha. Para receber a string codificada em base64, execute o comando cat key-filename.json | base64.

    5. Somente para Python, no campo URL do registro, insira: 

      https://us-python.pkg.dev/cloud-aoss/python
       No campo URL, digite: 
      https://us-python.pkg.dev

    6. Somente para Go, na guia Configurações avançadas, selecione Ignorar solicitações HEAD.

  6. Clique em Criar repositório remoto.

    Para pacotes Python, anexe o URL recebido com /simple. Use o URL como index-url no comando pip install para fazer o download dos pacotes Python necessários. Por exemplo, se o URL do repositório for https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo, o index-url correspondente será https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

Depois que o novo repositório remoto for configurado, configure suas ferramentas de build (por exemplo, Apache Maven, Gradle Build Tool ou pip) para usar esse novo repositório remoto.

Problemas conhecidos

Testar a conexão usando o botão Testar pode retornar um erro, mesmo que a conexão esteja configurada corretamente. Recomendamos que você crie o repositório remoto, independentemente do comportamento do botão de teste. Para outra maneira de confirmar uma conexão, consulte Validar sua conexão.

Configurar um repositório remoto usando o Sonatype Nexus

  1. Faça login no gerenciador de repositórios do Sonatype Nexus. Verifique se você tem os privilégios necessários para criar um novo repositório remoto.
  2. Selecione a opção para criar um novo repositório.
  3. Selecione o tipo de repositório apropriado (por exemplo, selecione Maven para Java, PyPi para Python ou Go para Go).

  4. Insira os seguintes detalhes do novo repositório:

    1. No campo Nome, insira um nome ou identificador exclusivo para o repositório remoto.

    2. No campo Armazenamento remoto, escolha uma das seguintes opções:

      • Java: 

        https://us-maven.pkg.dev/cloud-aoss/java

      • Python: 

        https://us-python.pkg.dev/cloud-aoss/python

      • Go: 

        https://us-go.pkg.dev/cloud-aoss/go

  5. Em HTTP, selecione Autenticação.

  6. Especifique o seguinte:

    1. No campo Tipo de autenticação, insira Username.
    2. No campo Nome de usuário, digite _json_key_base64.
    3. No campo Senha, forneça a string codificada em Base64 do arquivo de chave JSON da conta de serviço. Use toda a string codificada em base64 em uma única linha como senha. Para receber a string codificada em base64, execute o comando cat key-filename.json | base64.

  7. Clique em Criar repositório.

Depois que o novo repositório remoto for configurado, direcione suas ferramentas de build (por exemplo, Apache Maven, Gradle Build Tool ou pip) para usar esse novo repositório remoto.

A seguir