Mendownload paket Assured OSS menggunakan repositori jarak jauh

Halaman ini menjelaskan cara menyiapkan repositori jarak jauh untuk mengakses dan mendownload Paket Assured OSS. Anda memiliki dua opsi untuk menyiapkan repositori jarak jauh: JFrog Artifactory atau Sonatype Nexus. Untuk informasi selengkapnya tentang opsi repositori, lihat repositori Assured OSS lainnya.

Dokumen ini hanya berlaku untuk tingkat premium Assured OSS. Sebagai paket gratis, lihat Download Paket Assured OSS menggunakan remote repositori Anda.

Sebelum memulai

  1. Integrasikan Assured OSS dengan Security Command Center.

  2. Memvalidasi konektivitas ke Security Command Center untuk akun layanan yang diminta.

Menyiapkan repositori jarak jauh menggunakan JFrog Artifactory

  1. Login ke pengelola repositori JFrog Artifactory. Pastikan bahwa Anda memiliki hak istimewa yang diperlukan untuk membuat repositori jarak jauh baru.
  2. Pilih opsi untuk membuat repositori jarak jauh baru di pengelola repositori Anda.
  3. Pilih jenis repositori yang sesuai (misalnya, pilih Maven untuk Java atau PyPi untuk Python).

  4. Atau, uji koneksi ke repositori Java, Python, atau JavaScript menggunakan langkah-langkah berikut:

    1. Di kolom Repository Key, masukkan nama atau ID unik untuk repositori jarak jauh.

    2. Pada kolom URL, masukkan salah satu opsi berikut:

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

      Jangan masukkan nama domain lengkap karena tindakan ini dapat menampilkan 404 HTTP atau Kode status HTTP 405.

    3. Biarkan kolom lainnya kosong.

    4. Klik Uji. Koneksi berhasil jika Anda melihat output berikut:

      Successfully connected to server

  5. Untuk membuat repositori jarak jauh baru, masukkan informasi berikut:

    1. Di kolom Kunci Repositori, masukkan nama atau ID unik untuk repositori jarak jauh. Contoh, assured-oss-java-repo.

    2. Pada kolom URL, masukkan salah satu opsi berikut:

      • 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

      Ganti PROJECT_ID dengan ID yang dipilih saat menyiapkan Terjamin OSS.

    3. Di kolom User Name, masukkan _json_key_base64.

    4. Di kolom Password, berikan string berenkode base64 dari file kunci JSON akun layanan tertentu. Gunakan seluruh string berenkode base64 dalam satu baris sebagai {i>password<i}. Untuk mendapatkan string berenkode base64, jalankan metode perintah base64 key-filename.json.

    5. Khusus untuk Python, di kolom Registry URL, masukkan 

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

  6. Klik Create Remote Repository.

    Untuk paket Python, tambahkan URL yang diperoleh dengan /simple. Gunakan URL sebagai index-url di perintah pip install untuk mendownload Python yang diperlukan paket. Misalnya, jika URL repositori yang diperoleh https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo, maka index-url yang sesuai adalah https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple.

Setelah repositori jarak jauh baru disiapkan, konfigurasikan alat build Anda (untuk misalnya, Apache Maven, Gradle Build Tool, atau pip) untuk menggunakan remote baru ini repositori resource.

Masalah umum

Menguji koneksi menggunakan tombol Test dapat menampilkan error meskipun dikonfigurasi dengan benar. Sebaiknya Anda membuat remote repositori terlepas dari perilaku tombol pengujian. Cara lain untuk untuk mengonfirmasi koneksi, lihat Memvalidasi koneksi.

Menyiapkan repositori jarak jauh menggunakan Sonatype Nexus

  1. Login ke pengelola repositori Sonatype Nexus Anda. Pastikan Anda memiliki hak istimewa yang diperlukan untuk membuat repositori jarak jauh baru.
  2. Pilih opsi untuk membuat repositori baru.
  3. Pilih jenis repositori yang sesuai (misalnya, pilih Maven untuk Java atau PyPi untuk Python).

  4. Masukkan detail berikut untuk repositori baru:

    1. Di kolom Nama, masukkan nama atau ID unik untuk remote repositori resource.

    2. Pada kolom Remote Storage, pilih dari opsi berikut:

      • 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

      Ganti PROJECT_ID dengan ID yang dipilih saat menyiapkan Terjamin OSS.

  5. Di bagian HTTP, pilih Authentication.

  6. Tentukan nilai berikut:

    1. Di kolom Authentication type, masukkan Username.
    2. Di kolom Nama Pengguna, masukkan _json_key_base64.
    3. Di kolom Password, berikan string berenkode base64 dari file kunci JSON akun layanan tertentu. Gunakan seluruh string yang dienkode base64 dalam satu baris sebagai {i>password<i}. Untuk mendapatkan string berenkode base64, jalankan metode perintah base64 key-filename.json.

  7. Klik Create Repository.

Setelah repositori jarak jauh baru disiapkan, arahkan alat build Anda (misalnya, Apache Maven, Gradle Build Tool, atau pip) untuk menggunakan repositori jarak jauh baru ini.

Langkah selanjutnya