Integrasi Dropbox

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, lihatMetode autentikasi.

Sebelum Anda mulai

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 di situs web Dropbox untuk membuat aplikasi.

• Untuk Kunci API: Token akses yang dihasilkan dari Konsol Aplikasi Dropbox di situs web Dropbox.

• Untuk persyaratan berlangganan Amazon Quick, lihatSiapkan integrasi di konsol.

Mengkonfigurasi Dropbox

Jika Anda menggunakan otentikasi aplikasi OAuth Default, lewati bagian ini dan buka. Menyiapkan konektor di Amazon Quick

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

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 di situs web Dropbox.

2. Pilih Buat aplikasi.

3. Untuk Pilih API, pilih Akses tercakup.

4. Pilih jenis akses yang Anda butuhkan:

   • Folder aplikasi - Menyediakan akses hanya ke folder tertentu.

   • Dropbox Lengkap — Menyediakan akses ke semua file dan folder.

5. Masukkan nama aplikasi dan pilih Buat aplikasi.

6. 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.

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

8. Pilih tab Izin dan pilih cakupan yang diperlukan integrasi Anda. Untuk cakupan yang direkomendasikan, lihatCakupan yang direkomendasikan.

Menghasilkan token akses untuk API Key

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

1. Masuk ke akun Dropbox Anda dan buka Konsol Aplikasi Dropbox di situs web Dropbox.

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

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

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

Cakupan yang direkomendasikan

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

Connect dari tab Tersedia

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.

2. Pada tab Tersedia, temukan Dropbox dan pilih Connect.

3. 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

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

1. Di konsol Amazon Quick, pilih Konektor.

2. Pilih tab Buat untuk tim Anda.

3. 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.

4. Masukkan Nama untuk konektor Anda. Secara opsional, pilih + Tambahkan Deskripsi untuk menambahkan deskripsi.

5. Untuk jenis Koneksi, pilih Jaringan publik.

6. 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.

   2. 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.

   3. 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.

7. Pilih Berikutnya.

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

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

10. 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.

11. Pilih Terbitkan.

Tindakan yang tersedia

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

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihatMengelola integrasi yang ada.

Masalah otentikasi

• Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth) — Pastikan akun Dropbox Anda aktif dan Anda dapat langsung masuk ke situs web Dropbox. 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.