Konfigurasi Box

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

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

Membuat aplikasi Box

1. Login ke Box Developer Console dengan akun administrator Anda.
2. Klik Create platform app.
3. Pilih Jenis aplikasi sebagai Aplikasi kustom.
4. Masukkan Nama aplikasi.

5. Atur properti berikut:

   • Tujuan: Integrasi.
   • Kategori: AI.
   • Sistem eksternal: Google Cloud Gemini Enterprise.

6. Pilih metode autentikasi sebagai Server Auth - JWT.

7. Klik Create App.

Mengonfigurasi aplikasi Box

1. Di Box Developer Console, pilih Platform app dari halaman My Platform Apps.

   

   Halaman My Platform Apps di Box Developer Console.

2. Di tab Konfigurasi, lakukan yang berikut:

   1. Di bagian tingkat akses Aplikasi, pilih Akses Aplikasi + Enterprise.

      Catatan: Akses App + Enterprise diperlukan untuk mengambil file, komentar, dan tugas dari akun pengguna perorangan. Selain itu, tingkat akses ini diperlukan untuk fungsi sinkronisasi inkremental. Streaming peristiwa Enterprise mengandalkan level ini untuk mengidentifikasi dan mengambil file, komentar, dan tugas baru serta yang dimodifikasi secara efisien.

      

      Konfigurasikan 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.
      Penelusuran dan tindakan gabungan	Write all files and folders stored in Box	Diperlukan untuk menyalin file, mengupload file, dan mendownload file, mengambil komentar dan tugas, serta 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 data mereka.
      	Manage enterprise properties	Diperlukan untuk fungsi sinkronisasi inkremental, karena memfasilitasi penggunaan streaming peristiwa Enterprise untuk melacak perubahan untuk penyerapan.
      	Manage groups	Diperlukan untuk mengambil daftar grup dan anggotanya. Hal ini penting untuk kontrol akses selama penyerapan.

      Catatan: Jika Anda hanya ingin menggunakan penyimpanan data untuk penelusuran dan tidak untuk 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 melibatkan pembaruan konten di Box. Untuk mengetahui informasi selengkapnya, lihat tindakan

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

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

4. Klik Simpan perubahan.

Memberikan otorisasi pada aplikasi Box

Untuk mengizinkan aplikasi Box dari Developer console, lakukan hal berikut:

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

3. Dalam dialog Tinjau pengiriman otorisasi aplikasi, klik Kirim.

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

   

   Permintaan otorisasi berhasil dikirim.

Untuk mengizinkan 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 menu drop-down.
5. Dalam dialog Authorize app, klik Authorize untuk menyelesaikan proses otorisasi.

Mendapatkan informasi autentikasi Box

Untuk mendapatkan informasi autentikasi Box, lakukan hal berikut:

1. Di Box Developer Console, pilih Platform app dari halaman My Platform Apps.

• Enterprise ID: Dapatkan dari tab General settings.

  

  Dapatkan ID Enterprise.

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

  

  Mendapatkan konfigurasi klien.

• Kunci pribadi, Key ID, dan Frasa sandi: 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.