Download Assured OSS packages using a remote repository

This page explains how you can set up a remote repository to access and download Assured OSS packages. You have two options for setting up a remote repository: JFrog Artifactory or Sonatype Nexus. For more information about repository options, see Assured OSS repository options .

This document applies to the free tier. For the premium tier, see Download Assured OSS packages using a remote repository .

Before you begin

Enable Assured OSS .
Validate connectivity to Assured OSS for the requested service accounts.

Set up a remote repository using JFrog Artifactory

Sign in to the JFrog Artifactory repository manager. Ensure that you have the required privileges to create a new remote repository.
Select the option to create a new remote repository in your repository manager.
Select the appropriate repository type (for example, select Maven for Java, PyPi for Python, or Go for Go).
Optionally, test the connection to the Java or Python repository using the following steps:
1. In the Repository Keyfield, enter a unique name or identifier for the remote repository.
2. In the URLfield, enter one of the following:
  - Java:
```
https://us-maven.pkg.dev
```
  - Python:
```
https://us-python.pkg.dev
```
  - Javascript:
```
https://us-npm.pkg.dev
```
  - Go:
```
https://us-go.pkg.dev
```
  Don't enter the complete domain name because this action might return an HTTP 404 or HTTP 405 status code.
3. Leave the remaining fields blank.
4. Click Test. The connection is successful when you see the following output:
  
  Successfully connected to server
To create a new remote repository, enter the following information:
1. In the Repository Keyfield, enter a unique name or identifier for the remote repository. For example, assured-oss-java-repo .
2. In the URLfield, enter one of the following:
  - 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. In the User Namefield, enter _json_key_base64 .
4. In the Passwordfield, provide the base64-encoded string of the service account JSON key file. Use the entire base64-encoded string in a single line as password. To get the base64-encoded string, run the command cat key-filename.json | base64 .
5. For Python only, in the Registry URLfield, enter
```
https://us-maven.pkg.dev/cloud-aoss/python
```
6. For Go only, in the Advanced Settingstab, select Bypass HEAD Requests.
Click Create Remote Repository.

For Python packages, append the obtained URL with /simple . Use the URL as the index-url in the pip install command to download the required Python packages. For example, if the obtained URL of the repository is https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo , then the corresponding index-url is https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple .

After the new remote repository is set up, configure your build tools (for example, Apache Maven, Gradle Build Tool, or pip) to use this new remote repository.

Known issues

Testing the connection using the Testbutton can return an error even if the connection is configured correctly. We recommend that you create the remote repository irrespective of the test button behavior. For another way of confirming a connection, see Validate your connection .

Set up a remote repository using Sonatype Nexus

Sign in to your Sonatype Nexus repository manager. Ensure that you have the required privileges to create a new remote repository.
Select the option to create a new repository.
Select the appropriate repository type (for example, select Maven for Java, PyPi for Python, or Go for Go).
Enter the following details for the new repository:
1. In the Namefield, enter a unique name or identifier for the remote repository.
2. In the Remote Storagefield, choose from the following:
  - 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
```
Under HTTP, select Authentication.
Specify the following:
1. In the Authentication typefield, enter Username .
2. In the Usernamefield, enter _json_key_base64 .
3. In the Passwordfield, provide the base64-encoded string of the service account JSON key file. Use the entire base64 encoded-string in a single line as password. To get the base64-encoded string, run the command cat key-filename.json | base64 .
Click Create Repository.

After the new remote repository is set up, point your build tools (for example, Apache Maven, Gradle Build Tool, or pip) to use this new remote repository.

Download Assured OSS packages using a remote repository

Before you begin

Set up a remote repository using JFrog Artifactory

Known issues

Set up a remote repository using Sonatype Nexus

What's next