使用遠端存放區下載 Assured OSS 套件

本頁說明如何設定遠端存放區，以存取及下載 Assured OSS 套件。您可以透過 JFrog Artifactory 或 Sonatype Nexus 設定遠端存放區。如要進一步瞭解存放區選項，請參閱「Assured OSS 存放區選項」。

本文僅適用於 Assured 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、JavaScript 適用的 npm 或 Go 適用的 Go)。

  4. 您也可以選擇按照下列步驟測試與存放區的連線：

    1. 在「存放區金鑰」欄位中，輸入遠端存放區的專屬名稱或 ID。

    2. 在「URL」欄位中，輸入下列其中一項：

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

      請勿輸入完整的網域名稱，因為這項動作可能會傳回 HTTP 404 或 HTTP 405 狀態碼。

    3. 將剩餘欄位保留空白。

    4. 按一下「測試」。 看到下列輸出內容時，表示連線成功：

      Successfully connected to server

  5. 如要建立新的遠端存放區，請輸入下列資訊：

    1. 在「存放區金鑰」欄位中，輸入遠端存放區的專屬名稱或 ID。例如：assured-oss-java-repo。

    2. 在「URL」欄位中，輸入下列其中一項：

      • Java： 
        https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
      • Python： 
        https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
      • JavaScript (NPM)： 
        https://us-npm.pkg.dev/PROJECT_ID/assuredoss-javascript
      • Go：
        https://us-go.pkg.dev/PROJECT_ID/assuredoss-go

      將 PROJECT_ID 替換為您設定 Assured OSS 時選取的專案 ID。

    3. 在「User Name」(使用者名稱) 欄位中輸入 _json_key_base64。

    4. 在「密碼」欄位中，提供服務帳戶 JSON 金鑰檔案的 Base64 編碼字串。使用整行 base64 編碼字串做為密碼。如要取得 base64 編碼字串，請執行 cat key-filename.json | base64 -w 0 指令。

    5. 如果是 Python，請在「登錄網址」欄位中輸入下列內容： 

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

  6. 如果是 Go，請在「進階設定」分頁中選取「略過 HEAD 要求」。

  7. 按一下「Create Remote Repository」(建立遠端存放區)。

    如果是 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 設定遠端存放區

  1. 登入 Sonatype Nexus 存放區管理工具。確認您具備建立新遠端存放區的必要權限。
  2. 選取建立新存放區的選項。
  3. 選取適當的存放區類型 (例如，選取 Java 適用的 Maven、Python 適用的 PyPi、JavaScript 適用的 npm 或 Go 適用的 Go)。

  4. 輸入新存放區的下列詳細資料：

    1. 在「名稱」欄位中，輸入遠端存放區的專屬名稱或 ID。

    2. 在「Remote Storage」(遠端儲存空間) 欄位中，選擇下列其中一項：

      • Java： 

        https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java

      • Python： 

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

      • JavaScript (NPM)： 

        https://us-npm.pkg.dev/PROJECT_ID/assuredoss-javascript

      • Go： 

        https://us-go.pkg.dev/PROJECT_ID/assuredoss-go

      將 PROJECT_ID 替換為您設定 Assured OSS 時選取的專案 ID。

  5. 在「HTTP」下方，選取「驗證」。

  6. 指定下列屬性：

    1. 在「Authentication type」(驗證類型) 欄位中，輸入 Username。
    2. 在「Username」欄位中輸入 _json_key_base64。
    3. 在「密碼」欄位中，提供服務帳戶 JSON 金鑰檔案的 Base64 編碼字串。請使用整行 Base64 編碼字串做為密碼。如要取得 base64 編碼字串，請執行 cat key-filename.json | base64 指令。

  7. 點選「Create Repository」。

設定新的遠端存放區後，請將建構工具 (例如 Apache Maven、Gradle 建構工具或 pip) 指向這個新的遠端存放區。

後續步驟