Konfigurasi Box

Pratinjau pribadi: Pembuatan dan penggunaan penyimpanan data menggunakan penyerapan data berada dalam pratinjau pribadi. Anda harus berada di daftar yang diizinkan untuk menggunakan penyimpanan data penyerapan data. Untuk ditambahkan ke daftar yang diizinkan, hubungi tim akun atau tim penjualan Anda.

Pratinjau publik: Fitur tindakan dan penelusuran gabungan berada dalam pratinjau publik. Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara menyiapkan dan mengonfigurasi konfigurasi pihak ketiga sebelum membuat penyimpanan data Box.

Membuat aplikasi Box

1. Login ke Konsol Developer Box dengan akun administrator Anda.
2. Klik Create platform app.
3. Pilih App type sebagai Custom app.
4. Masukkan App name.

5. Atur properti berikut:

   • Purpose: Integration.
   • Categories: AI.
   • External system: Google Cloud Gemini Enterprise.

6. Pilih Authentication method sebagai Server Auth - JWT.

7. Klik Create App.

Mengonfigurasi aplikasi Box

1. Di Konsol Developer Box, pilih aplikasi Platform dari halaman My Platform Apps.

   

   Halaman My Platform Apps di Konsol Developer Box.

2. Di tab Configuration, lakukan hal berikut:

   1. Di bagian App access level, pilih App + Enterprise access.

      Catatan: App + Enterprise access diperlukan untuk mengambil file, komentar, dan tugas dari akun pengguna individual. Selain itu, tingkat akses ini diperlukan untuk fungsi sinkronisasi inkremental. Aliran peristiwa perusahaan mengandalkan tingkat ini untuk mengidentifikasi dan mengambil file, komentar, dan tugas baru serta yang diubah secara efisien.

      

      Mengonfigurasi aplikasi Box.

   2. Di bagian Application scopes, pilih cakupan berdasarkan mode koneksi dari tabel berikut:

      Mode koneksi	Cakupan	Tujuan
      Penelusuran gabungan	Read all files and folders stored in Box	Diperlukan untuk mengambil komentar dan tugas, serta melihat pratinjau file untuk penelusuran.
      Tindakan dan penelusuran gabungan	Write all files and folders stored in Box	Diperlukan untuk menyalin, mengupload, dan mendownload file, serta mengambil komentar dan tugas, dan melihat pratinjau file untuk penelusuran.
      Penyerapan data	Read all files and folders stored in Box	Diperlukan untuk penyerapan data.
      	Manage users	Diperlukan untuk mengambil daftar pengguna, sehingga memungkinkan pengambilan file, komentar, dan tugas dari akun pengguna individual untuk penyerapan. Akun layanan administrator tidak secara inheren memiliki akses ke semua file milik pengguna. Header as-user memungkinkan sistem membuat permintaan API sebagai pengguna tertentu untuk mengakses datanya.
      	Manage enterprise properties	Diperlukan untuk fungsi sinkronisasi inkremental, karena memfasilitasi penggunaan aliran peristiwa perusahaan untuk melacak perubahan untuk penyerapan.
      	Manage groups	Diperlukan untuk mengambil daftar grup dan anggotanya. Hal ini penting untuk kontrol akses selama penyerapan.

      Catatan: Jika hanya ingin menggunakan penyimpanan data untuk penelusuran dan tidak melakukan tindakan apa pun yang mengubah konten di Box, Anda dapat membatasi cakupan ke Read all files and folders stored in Box. Cakupan Write all files and folders stored in Box diperlukan untuk Tindakan yang Didukung yang melibatkan pembaruan konten di Box.

3. Di bagian Add and manage public keys, klik Generate a public/private keypair.

   • Kunci publik otomatis diupload ke konsol dengan ID, yang digunakan saat membuat koneksi.
   • Anda dapat mendownload file konfigurasi dengan kunci pribadi dan sandi. Pastikan untuk menyimpan file ini untuk digunakan nanti.
   • Secara opsional, untuk membuat kunci Anda sendiri, lihat panduan penyiapan pasangan kunci Box.

4. Klik Save changes.

Memberikan otorisasi aplikasi Box

Untuk memberikan otorisasi aplikasi Box dari Konsol developer, lakukan hal berikut:

1. Di Konsol Developer Box, pilih aplikasi Platform, lalu buka tab Authorization.
2. Klik Review and submit.

3. Di dialog Review app authorization submission, klik Submit.

   Jika permintaan otorisasi berhasil dikirim, pesan konfirmasi berikut akan ditampilkan:

   

   Permintaan otorisasi berhasil dikirim.

Untuk memberikan otorisasi aplikasi Box dari pengelola aplikasi platform admin Box, lakukan hal berikut:

1. Login ke pengelola aplikasi platform admin Box dengan akun administrator Anda.
2. Pilih Aplikasi platform yang telah Anda konfigurasi.
3. Klik tiga titik (...) di baris yang sesuai.
4. Pilih Authorize app dari daftar drop-down.
5. Di dialog Authorize app, klik Authorize untuk menyelesaikan proses otorisasi.

Mendapatkan informasi autentikasi Box

Untuk mendapatkan informasi autentikasi Box, lakukan hal berikut:

1. Di Konsol Developer Box, pilih aplikasi Platform dari halaman My Platform Apps.

• Enterprise ID: Dapatkan dari tab General settings.

  

  Mendapatkan Enterprise ID.

• Client ID dan Client secret: Dapatkan dari tab Configuration di bagian OAuth 2.0 credentials.

  

  Mendapatkan konfigurasi klien.

• Private key, Key ID, dan Passphrase: Parameter ini dibuat dan didownload ke file lokal dari tab Configuration di bagian Add and manage public keys saat mengonfigurasi aplikasi.

  

  Menambahkan dan mengelola kunci publik.