此页面由 Cloud Translation API 翻译。

使用远程仓库下载 Assured OSS 软件包

本页介绍了如何设置远程仓库以访问和下载 Assured OSS 软件包。

本文档仅适用于 Assured OSS 付费层级。对于免费层级，请参阅使用远程代码库下载 Assured OSS 软件包。

准备工作

将 Assured OSS 与 Security Command Center 集成。
为请求的服务帐号验证与 Security Command Center 的连接。

概览

Assured OSS 软件包存储在 Google 管理的 Artifact Registry 代码库中。您可以使用以下某种方法访问和下载 Assured OSS 提供的 OSS 软件包：

设置一个远程（也称为镜像或代理）代码库，以充当 Assured OSS Artifact Registry 代码库的代理。您需要连接到远程代码库以下载软件包。这种方法常用于使用仓库管理器（如 Jfrog Artifactory 或 Sonatype Nexus）访问开源软件的组织。
直接使用服务帐号从 Maven、Gradle 或 pip 等构建工具连接到 Assured OSS Artifact Registry 代码库。

远程代码库的工作流

以下部分介绍了如何设置远程仓库以访问和下载 Assured OSS 软件包。您可以通过以下两种方式设置远程仓库：JFrog Artifactory 或 Sonatype Nexus。

使用 JFrog Artifactory 设置远程仓库

登录 JFrog Artifactory 仓库管理器。确保您拥有创建新的远程代码库所需的权限。
选择用于在代码库管理器中创建新的远程代码库的选项。
选择相应的代码库类型（例如，对于 Java，选择 Maven；对于 Python，选择 PyPi）。
（可选）按照以下步骤测试与 Java、Python 或 JavaScript 代码库的连接：
1. 在代码库密钥字段中，输入远程代码库的唯一名称或标识符。
2. 在网址字段中，输入以下内容之一：
  - Java：
```
https://us-maven.pkg.dev
```
  - Python：
```
https://us-python.pkg.dev
```
  - JavaScript：
```
https://us-npm.pkg.dev
```
  请勿输入完整的域名，因为这可能会返回 HTTP 404 或 HTTP 405 状态代码。
3. 将其余字段留空。
4. 点击测试。如果您看到以下输出，则表示连接成功：
  
  Successfully connected to server
如需创建新的远程仓库，请输入以下信息：
1. 在代码库密钥字段中，输入远程代码库的唯一名称或标识符。例如 assured-oss-java-repo。
2. 在网址字段中，输入以下内容之一：
  - Java：
```
https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
```
  - Python：
```
https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
```
  - JavaScript：
```
https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm
```
  将 PROJECT_ID 替换为您在设置 Assured OSS 时选择的项目的 ID。
3. 在用户名字段中，输入 _json_key_base64。
4. 在密码字段中，提供服务帐号 JSON 密钥文件的 base64 编码字符串。在一行中使用整个 base64 编码的字符串作为密码。如需获取 base64 编码的字符串，请运行命令 base64 key-filename.json。
5. 仅对于 Python，在注册表网址字段中，输入
```
https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
```
  。
点击创建远程代码库。

对于 Python 软件包，请在获取的网址后附加 /simple。在 pip install 命令中使用该网址作为 index-url 下载所需的 Python 软件包。例如，如果获取的代码库网址为 https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo，则相应的 index-url 为 https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple。

设置新的远程仓库后，请配置构建工具（例如 Apache Maven、Gradle 构建工具或 pip），以使用以下新的远程仓库。

已知问题

即使连接配置正确，使用测试按钮测试连接也可能会返回错误。我们建议您创建远程仓库，而不考虑测试按钮的行为。如需了解确认连接的另一种方法，请参阅验证您的连接。

使用 Sonatype Nexus 设置远程代码库

登录您的 Sonatype Nexus 代码库管理器。确保您拥有创建新的远程代码库所需的权限。
选择创建新代码库的选项。
选择相应的代码库类型（例如，对于 Java，选择 Maven；对于 Python，选择 PyPi）。
为新代码库输入以下详细信息：
1. 在名称字段中，输入远程代码库的唯一名称或标识符。
2. 在远程存储字段中，从以下选项中选择：
  - Java：
```
https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
```
  - Python：
```
https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
```
  - JavaScript：
```
https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm
```
  将 PROJECT_ID 替换为您在设置 Assured OSS 时选择的项目的 ID。
在 HTTP 下，选择身份验证。
指定以下内容：
1. 在身份验证类型字段中，输入 Username。
2. 在用户名字段中，输入 _json_key_base64。
3. 在密码字段中，提供服务帐号 JSON 密钥文件的 base64 编码字符串。在一行中使用整个 base64 编码字符串作为密码。如需获取 base64 编码的字符串，请运行命令 base64 key-filename.json。
点击创建代码库。

设置新的远程仓库后，将构建工具（例如 Apache Maven、Gradle Build Tool 或 pip）指向这个新的远程仓库。