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

本页介绍了如何设置远程代码库以访问和下载 Assured OSS 软件包。您可以通过两种方式设置远程代码库：JFrog Artifactory 或 Sonatype Nexus。如需详细了解代码库选项，请参阅可信 OSS 代码库选项。

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

准备工作

  1. 将 Assured OSS 与 Security Command Center 集成。

  2. 验证连接 访问 Security Command Center。

使用 JFrog Artifactory 设置远程仓库

  1. 登录 JFrog Artifactory 仓库管理器。确保您拥有创建新的远程代码库所需的权限。
  2. 选择用于在代码库管理器中创建新的远程代码库的选项。
  3. 选择适当的代码库类型（例如，对于 Java 选择 Maven，对于 Python 选择 PyPi）。

  4. （可选）测试与 Java、Python 或 JavaScript 代码库的连接 将其配置为

    1. 在 Repository Key 字段中，为 远程仓库

    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

  5. 如需创建新的远程代码库，请输入以下信息：

    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 替换为 ID 选择的项目的角色 Assured OSS。

    3. 在用户名字段中，输入 _json_key_base64。

    4. 在密码字段中，提供 服务账号 JSON 密钥文件。将整个 base64 编码的字符串用作密码。如需获取 base64 编码的字符串，请运行命令 base64 key-filename.json。

    5. 对于仅限 Python 的项目，在 Registry URL 字段中，输入

      https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
      。

  6. 点击创建远程代码库。

    对于 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 Build Tool 或 pip）以使用此新的远程代码库。

已知问题

即使使用 Test 按钮测试连接， 连接配置正确。我们建议您创建远程代码库，无论测试按钮行为如何。换一种方式 确认连接，请参阅验证连接。

使用 Sonatype Nexus 设置远程代码库

  1. 登录您的 Sonatype Nexus 代码库管理器。确保您已拥有 创建新的远程代码库所需的权限。
  2. 选择用于创建新代码库的选项。
  3. 选择适当的代码库类型（例如，对于 Java 选择 Maven，对于 Python 选择 PyPi）。

  4. 为新代码库输入以下详细信息：

    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。

  5. 在 HTTP 下，选择身份验证。

  6. 指定下列内容：

    1. 在身份验证类型字段中，输入 Username。
    2. 在用户名字段中，输入 _json_key_base64。
    3. 在密码字段中，提供服务账号 JSON 密钥文件的 base64 编码字符串。将单行中的整个 base64 编码字符串用作密码。要获取 base64 编码的字符串，请运行 命令 base64 key-filename.json。

  7. 点击创建代码库。

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

后续步骤