Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasi Dropbox
<a name="dropbox-integration"></a>

Dengan konektor aksi Dropbox, Anda dapat mengakses platform Dropbox langsung di Amazon Quick melalui bahasa alami. Anda dapat mengunggah file, mengelola struktur folder, menghasilkan tautan berbagi, dan mencari konten tanpa meninggalkan Amazon Quick.

Amazon Quick mendukung beberapa metode otentikasi untuk Dropbox. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Anda mengautentikasi langsung dengan akun Dropbox Anda.
+ Aplikasi **OAuth khusus — Menggunakan aplikasi** OAuth yang dikelola pelanggan yang terdaftar di Dropbox. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
+ **Kunci API** — Menggunakan token akses Dropbox untuk otentikasi. Metode ini cocok untuk penggunaan individu atau pengujian.

Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

## Sebelum Anda mulai
<a name="dropbox-integration-prerequisites"></a>

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Dropbox aktif dengan akses ke file dan folder yang ingin Anda gunakan.
+ Untuk **aplikasi OAuth Khusus**: Akses ke [Konsol Aplikasi Dropbox](https://www.dropbox.com/developers/apps) di situs web Dropbox untuk membuat aplikasi.
+ Untuk **Kunci API**: Token akses yang dihasilkan dari [Konsol Aplikasi Dropbox](https://www.dropbox.com/developers/apps) di situs web Dropbox.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Mengkonfigurasi Dropbox
<a name="dropbox-source-setup"></a>

Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan buka. [Menyiapkan konektor di Amazon Quick](#dropbox-quicksuite-setup)

Untuk aplikasi Custom OAuth atau autentikasi API Key, selesaikan langkah-langkah yang berlaku di Dropbox sebelum Anda mengonfigurasi Amazon Quick.

### Membuat aplikasi Dropbox untuk aplikasi Custom OAuth
<a name="dropbox-register-oauth"></a>

Buat aplikasi di Dropbox App Console untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick.

1. Masuk ke akun Dropbox Anda dan buka [Konsol Aplikasi Dropbox](https://www.dropbox.com/developers/apps) di situs web Dropbox.

1. Pilih **Buat aplikasi**.

1. Untuk **Pilih API**, pilih Akses **tercakup.**

1. Pilih jenis akses yang Anda butuhkan:
   + **Folder aplikasi** - Menyediakan akses hanya ke folder tertentu.
   + **Dropbox Lengkap** — Menyediakan akses ke semua file dan folder.

1. Masukkan nama aplikasi dan pilih **Buat aplikasi**.

1. Pada halaman pengaturan aplikasi, catat nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
   + **Kunci aplikasi** — Ini adalah ID Klien Anda.
   + **Rahasia aplikasi** — Ini adalah rahasia Klien Anda.

1. Di bawah **OAuth 2**, di bagian **Redirect URI, tambahkan URL** callback Cepat Amazon: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. Pilih tab **Izin** dan pilih cakupan yang diperlukan integrasi Anda. Untuk cakupan yang direkomendasikan, lihat[Cakupan yang direkomendasikan](#dropbox-oauth-scopes).

### Menghasilkan token akses untuk API Key
<a name="dropbox-create-token"></a>

Buat token akses dari Dropbox App Console untuk autentikasi API Key.

1. Masuk ke akun Dropbox Anda dan buka [Konsol Aplikasi Dropbox](https://www.dropbox.com/developers/apps) di situs web Dropbox.

1. Pilih aplikasi Anda, atau buat yang baru jika diperlukan.

1. Di bawah **OAuth 2**, pilih **Hasilkan** untuk membuat token akses.

1. Salin dan simpan token yang dihasilkan dengan aman. Anda membutuhkannya saat mengonfigurasi Amazon Quick.

### Cakupan yang direkomendasikan
<a name="dropbox-oauth-scopes"></a>

Saat Anda membuat aplikasi Dropbox, konfigurasikan cakupan berikut di tab **Izin** berdasarkan tindakan yang ingin Anda gunakan.


**Cakupan yang direkomendasikan Dropbox**  

| Lingkup | Deskripsi | 
| --- | --- | 
| account\_info.read | Membaca informasi akun. | 
| account\_info.write | Memperbarui informasi akun. | 
| contacts.read | Membaca informasi kontak. | 
| contacts.write | Memperbarui informasi kontak. | 
| events.read | Membaca entri log peristiwa. | 
| events.write | Membuat entri log peristiwa. | 
| file\_requests.read | Membaca permintaan file. | 
| file\_requests.write | Membuat dan mengelola permintaan file. | 
| files.content.read | Membaca konten file. | 
| files.content.write | Membuat, memodifikasi, dan menghapus file. | 
| files.metadata.read | Membaca metadata file dan folder. | 
| files.metadata.write | Mengedit metadata file dan folder. | 
| files.permanent\_delete | Menghapus file secara permanen. | 
| files.team\_metadata.read | Membaca metadata file tim. | 
| files.team\_metadata.write | Mengedit metadata file tim. | 
| groups.read | Membaca informasi grup. | 
| groups.write | Mengelola grup. | 
| members.delete | Menghapus anggota tim. | 
| members.read | Membaca informasi anggota tim. | 
| members.write | Mengelola anggota tim. | 
| sessions.list | Daftar sesi aktif. | 
| sessions.modify | Memodifikasi sesi aktif. | 
| sharing.read | Membaca pengaturan berbagi dan tautan bersama. | 
| sharing.write | Membuat dan mengelola tautan bersama dan berbagi folder. | 
| team\_data.content.read | Membaca konten tim. | 
| team\_data.content.write | Mengelola konten tim. | 
| team\_data.governance.read | Membaca pengaturan tata kelola data tim. | 
| team\_data.governance.write | Mengelola pengaturan tata kelola data tim. | 
| team\_data.team\_space | Mengakses data ruang tim. | 
| team\_info.read | Membaca informasi tim. | 
| team\_info.write | Memperbarui informasi tim. | 

## Menyiapkan konektor di Amazon Quick
<a name="dropbox-quicksuite-setup"></a>

### Connect dari tab Tersedia
<a name="dropbox-quick-connect"></a>

Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab **Tersedia** tanpa konfigurasi tambahan.

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pada tab **Tersedia**, temukan **Dropbox** dan pilih **Connect**.

1. Selesaikan alur masuk Dropbox dan berikan izin yang diminta.

Untuk mengonfigurasi konektor dengan aplikasi OAuth Kustom atau Kunci API, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.

### Buat dari tab Buat untuk tim Anda
<a name="dropbox-full-setup"></a>

Setelah Anda menyelesaikan konfigurasi Dropbox yang diperlukan, buat konektor di Amazon Quick.

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **Dropbox**.
**catatan**  
Jika konektor Dropbox sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih **Tidak, buat yang baru**.

1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.

1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.

1. Untuk **Konfigurasi OAuth**, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.

   1. Untuk aplikasi **OAuth Default**:

      Tidak diperlukan kredensi tambahan. Pilih **Next** untuk melanjutkan.

   1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
      + **URL Dasar** (Opsional) — URL dasar API Dropbox. Contoh: `https://api.dropboxapi.com`
      + **ID Klien** — Kunci aplikasi dari aplikasi Dropbox Anda.
      + **Rahasia klien** — Rahasia aplikasi dari aplikasi Dropbox Anda.
      + **URL Token** — Titik akhir token. Contoh: `https://api.dropboxapi.com/oauth2/token`
      + **URL otorisasi** — Titik akhir otorisasi. Contoh: `https://www.dropbox.com/oauth2/authorize`
      + **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.

   1. Untuk **API Key**, konfigurasikan bidang berikut:
      + **URL Dasar** (Opsional) — URL dasar API Dropbox. Contoh: `https://api.dropboxapi.com`
      + **Kunci API** — Token akses Dropbox Anda.
      + **Email** (Opsional) — Alamat email yang dikaitkan dengan akun Dropbox Anda.

1. Pilih **Berikutnya**.

1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** Dropbox akan terbuka. Tinjau izin yang diminta dan pilih **Izinkan**.

1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.

1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.

1. Pilih **Terbitkan**.

## Tindakan yang tersedia
<a name="dropbox-integration-actions"></a>

Setelah Anda mengatur konektor, tindakan berikut tersedia.


**Tindakan Dropbox yang tersedia**  

| Kategori | Tindakan | Deskripsi | 
| --- | --- | --- | 
| Berkas | Daftar Berkas | Daftar file dalam folder. | 
| Berkas | Dapatkan File | Membaca isi file. | 
| Berkas | Impor Berkas | Mengunggah file ke Dropbox. | 
| Berkas | Cari Berkas | Mencari file atau folder berdasarkan nama atau konten. | 
| Berkas | Perbarui Lokasi File | Memindahkan file atau folder ke lokasi yang berbeda. | 
| Berkas | Dapatkan Tautan Sementara | Menghasilkan tautan unduhan sementara untuk file. | 
| Berkas | Dapatkan Metadata | Mengambil metadata untuk file atau folder. | 
| Berkas | Simpan File Dari URL | Menyimpan file ke Dropbox dari URL. | 
| Folder | Buat Folder | Membuat folder baru. | 
| Folder | Daftar Folder | Daftar folder yang dapat diakses pengguna. | 
| Operasi batch | Dapatkan Status Batch Move | Memeriksa status operasi batch move. | 
| Pembagian | Buat Tautan Bersama | Membuat tautan bersama untuk file atau folder. | 
| Pembagian | Daftar Tautan Bersama | Daftar link bersama untuk file atau folder. | 
| Pembagian | Perbarui Berbagi Folder | Berbagi folder dengan pengguna lain. | 
| Pembagian | Daftar File yang Diterima | Daftar file yang telah dibagikan pengguna lain dengan Anda. | 
| Permintaan berkas | Buat Permintaan File | Membuat permintaan file bagi orang lain untuk mengunggah file. | 
| Akun | Dapatkan Pengguna | Mengambil informasi tentang pengguna yang diautentikasi. | 
| Akun | Dapatkan Penggunaan Ruang | Mengambil penggunaan ruang penyimpanan untuk akun. | 

**catatan**  
Tindakan yang dapat Anda gunakan bergantung pada file dan folder yang dapat diakses oleh pengguna yang diautentikasi.

## Mengelola dan memecahkan masalah
<a name="dropbox-integration-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="dropbox-troubleshooting-auth"></a>
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** [— Pastikan akun Dropbox Anda aktif dan Anda dapat langsung masuk ke situs web Dropbox.](https://www.dropbox.com) Untuk aplikasi Custom OAuth, konfirmasikan bahwa URL pengalihan di aplikasi Dropbox Anda cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (Aplikasi OAuth Khusus)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan kunci aplikasi dan nilai rahasia aplikasi di aplikasi Dropbox Anda. Jika Anda membuat ulang rahasia aplikasi, perbarui nilainya di Amazon Quick.
+ **Kunci API ditolak** — Verifikasi bahwa token akses Anda aktif. Token dapat kedaluwarsa atau dicabut di Konsol Aplikasi Dropbox.
+ **Izin tidak memadai** — Pastikan aplikasi Dropbox Anda memiliki cakupan izin yang diperlukan untuk tindakan yang ingin Anda gunakan.