Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menyematkan dengan Amazon QuickSight APIs
Berlaku untuk: Enterprise Edition |
Pemirsa yang dituju: QuickSight Pengembang Amazon |
Hanya ada beberapa langkah yang terlibat dalam proses penyematan analitik yang sebenarnya menggunakan. QuickSight APIs
Sebelum Anda mulai, pastikan untuk memiliki item berikut di tempat:
-
Siapkan IAM izin yang diperlukan untuk identitas pemanggil yang digunakan oleh aplikasi Anda yang akan menggunakan AWS SDK untuk melakukan API panggilan. Misalnya, berikan izin untuk mengizinkan
quicksight:GenerateEmbedUrlForAnonymousUser
atauquicksight:GenerateEmbedUrlForRegisteredUser
tindakan. -
Untuk menyematkan pengguna terdaftar, bagikan QuickSight aset dengan mereka sebelumnya. Untuk pengguna otentikasi baru, ketahui cara memberikan akses ke aset. Salah satu cara untuk melakukannya adalah dengan menambahkan semua aset ke QuickSight folder. Jika Anda lebih suka menggunakan QuickSight API, gunakan
DescribeDashboardPermissions
danUpdateDashboardPermissions
API operasi. Untuk informasi selengkapnya, lihat DescribeDashboardPermissionsatau UpdateDashboardPermissionsdi QuickSight APIReferensi Amazon. Jika Anda ingin berbagi dasbor dengan semua pengguna di namespace atau grup, Anda dapat berbagi dasbor dengannamespace
atau.group
-
Jika Anda menyematkan dasbor, pastikan Anda memiliki ID dasbor yang ingin Anda sematkan. ID dasbor adalah kode di URL dasbor. Anda juga bisa mendapatkannya dari dasborURL.
-
QuickSight Administrator harus secara eksplisit mengaktifkan domain tempat Anda berencana untuk menyematkan analitik Anda. QuickSight Anda dapat melakukan ini dengan menggunakan Kelola QuickSight, Domain, dan Penyematan dari menu profil, atau Anda dapat menggunakan
AllowedDomains
parameter panggilanGenerateEmbedUrlForAnonymousUser
atauGenerateEmbedUrlForRegisteredUser
API.Opsi ini hanya terlihat oleh QuickSight administrator. Anda juga dapat menambahkan subdomain sebagai bagian dari domain. Untuk informasi selengkapnya, lihat Izinkan daftar domain saat runtime dengan QuickSight API.
Semua domain dalam daftar izin statis Anda (seperti pengembangan, pementasan, dan produksi) harus diizinkan secara eksplisit, dan harus digunakan. HTTPS Anda dapat menambahkan hingga 100 domain ke daftar izinkan. Anda dapat menambahkan domain saat runtime dengan QuickSight API operasi.
Setelah semua prasyarat selesai, penyematan QuickSight melibatkan langkah-langkah berikut, yang dijelaskan secara lebih rinci nanti:
-
Untuk otentikasi, gunakan server aplikasi Anda untuk mengautentikasi pengguna. Setelah otentikasi di server Anda, buat dasbor tertanam URL menggunakan AWS SDK yang Anda butuhkan.
-
Di portal atau aplikasi web Anda, sematkan QuickSight menggunakan yang dihasilkanURL. Untuk menyederhanakan proses ini, Anda dapat menggunakan Amazon QuickSight EmbeddingSDK, tersedia di NPMJS
dan. GitHub Kustomisasi JavaScript SDK ini dirancang untuk membantu Anda mengintegrasikan secara efisien QuickSight ke dalam halaman aplikasi Anda, mengatur default, menghubungkan kontrol, mendapatkan panggilan balik, dan menangani kesalahan.
Anda dapat menggunakan log AWS CloudTrail audit untuk mendapatkan informasi tentang jumlah dasbor yang disematkan, pengguna pengalaman tertanam, dan tingkat akses.
Topik
- Menyematkan QuickSight dasbor Amazon dengan QuickSight API
- Menyematkan QuickSight visual Amazon dengan QuickSight APIs
- Menyematkan fungsionalitas penuh QuickSight konsol Amazon untuk pengguna terdaftar
- Menyematkan Amazon Q dalam pengalaman Tanya QuickSight Jawab Generatif
- Menyematkan bilah pencarian Amazon QuickSight Q (Klasik)
- Menyematkan analitik menggunakan operasi GetDashboardEmbedURL dan GetSessionEmbedURL API