Menyematkan dengan Amazon QuickSight APIs - Amazon QuickSight

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 atau quicksight: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 dan UpdateDashboardPermissions 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 dengan namespace 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 panggilan GenerateEmbedUrlForAnonymousUser atau GenerateEmbedUrlForRegisteredUserAPI.

    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:

  1. Untuk otentikasi, gunakan server aplikasi Anda untuk mengautentikasi pengguna. Setelah otentikasi di server Anda, buat dasbor tertanam URL menggunakan AWS SDK yang Anda butuhkan.

  2. Di portal atau aplikasi web Anda, sematkan QuickSight menggunakan yang dihasilkanURL. Untuk menyederhanakan proses ini, Anda dapat menggunakan Amazon QuickSight EmbeddingSDK, tersedia di NPMJSdan. 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.