Konfigurasi Box

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

Pratinjau publik: Fitur penelusuran dan tindakan gabungan tersedia dalam pratinjau publik. Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui 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 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 Authentication method 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 Aplikasi Platform Saya di Konsol Developer Box.

2. Di tab Konfigurasi, lakukan yang berikut:

   1. Di bagian Tingkat akses aplikasi, pilih Akses aplikasi + Perusahaan.

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

      

      Konfigurasi aplikasi Box.

   2. Di bagian Cakupan aplikasi, 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, 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, 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 Enterprise event stream untuk melacak perubahan yang akan diproses.
      	Manage groups	Diperlukan untuk mengambil daftar grup dan anggotanya. Hal ini sangat penting untuk kontrol akses selama penyerapan.

      Catatan: Jika Anda hanya ingin menggunakan penyimpanan data untuk penelusuran dan tidak ingin 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.

3. Di bagian Tambahkan dan kelola kunci publik, klik Buat pasangan kunci publik/pribadi.

   • Kunci publik 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 membuat kunci Anda sendiri, lihat panduan penyiapan pasangan kunci Box.

4. Klik Simpan perubahan.

Memberi otorisasi aplikasi Box

Untuk mengizinkan aplikasi Box dari Konsol developer, lakukan hal berikut:

1. Di Box Developer Console, pilih aplikasi Platform, lalu buka tab Authorization.
2. Klik Tinjau dan kirim.

3. Pada 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 Otorisasi aplikasi dari daftar drop-down.
5. Dalam dialog Beri otorisasi aplikasi, klik Beri otorisasi untuk menyelesaikan proses otorisasi.

Mendapatkan informasi autentikasi Box

Untuk mendapatkan informasi autentikasi Box, lakukan langkah-langkah berikut:

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

• ID Enterprise: Dapatkan dari tab Setelan umum.

  

  Dapatkan ID Perusahaan.

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

  

  Dapatkan konfigurasi klien.

• Kunci pribadi, ID Kunci, dan Frasa sandi: Parameter ini dibuat dan didownload ke file lokal dari tab Konfigurasi di bagian Tambahkan dan kelola kunci publik saat mengonfigurasi aplikasi.

  

  Menambahkan dan mengelola kunci publik.