Menyematkan dengan API QuickSight - Amazon QuickSight

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

Menyematkan dengan API QuickSight

 Berlaku untuk: Enterprise Edition 
   Pemirsa yang dituju: QuickSight Pengembang Amazon 

Hanya ada beberapa langkah yang terlibat dalam proses penyematan analitik yang sebenarnya menggunakan QuickSight API.

Sebelum Anda mulai, pastikan untuk memiliki item berikut di tempat:

  • Siapkan izin IAM yang diperlukan untuk identitas pemanggil yang digunakan oleh aplikasi Anda yang akan menggunakan AWS SDK untuk melakukan panggilan API. Misalnya, berikan izin untuk mengizinkan quicksight:GenerateEmbedUrlForAnonymousUser atau quicksight:GenerateEmbedUrlForRegisteredUser tindakan.

  • Untuk menyematkan pengguna terdaftar, bagikan QuickSight aset dengan mereka sebelumnya. Untuk pengguna autentikasi 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 operasi DescribeDashboardPermissions dan UpdateDashboardPermissions API. Untuk informasi selengkapnya, lihat DescribeDashboardPermissionsatau UpdateDashboardPermissionsdi Referensi Amazon QuickSight API. 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 URL dasbor.

  • QuickSight Administrator harus secara eksplisit mengaktifkan domain tempat Anda berencana untuk menyematkan analitik Anda. QuickSight Anda dapat melakukannya dengan menggunakan Kelola QuickSight, Domain, dan Penyematan dari menu profil, atau Anda dapat menggunakan AllowedDomains parameter panggilan GenerateEmbedUrlForRegisteredUser API GenerateEmbedUrlForAnonymousUser atau.

    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 API QuickSight .

    Semua domain dalam daftar izin statis Anda (seperti pengembangan, pementasan, dan produksi) harus diizinkan secara eksplisit, dan mereka harus menggunakan HTTPS. Anda dapat menambahkan hingga 100 domain ke daftar izinkan. Anda dapat menambahkan domain saat runtime dengan operasi QuickSight API.

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 URL dasbor yang disematkan menggunakan AWS SDK yang Anda butuhkan.

  2. Di portal atau aplikasi web Anda, sematkan QuickSight menggunakan URL yang dihasilkan. Untuk menyederhanakan proses ini, Anda dapat menggunakan Amazon QuickSight Embedding SDK, tersedia di NPMJS dan. GitHub JavaScript SDK yang disesuaikan ini dirancang untuk membantu Anda mengintegrasikan secara efisien QuickSight ke dalam halaman aplikasi, 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