Quick BI：Solusi Peningkatan Keamanan untuk Kontrol Izin Data dan Transmisi Parameter dalam Laporan yang Disematkan

Informasi Latar Belakang

Quick BI menawarkan solusi analitik tersemat yang ditingkatkan keamanannya, dikenal sebagai solusi penyematan laporan berbasis tiket. Dengan Quick BI Professional Edition, Anda dapat menerapkan kontrol keamanan komprehensif terhadap tautan, akses, dan tampilan data. Solusi ini membantu Anda mengintegrasikan sistem bisnis enterprise dengan biaya rendah dan membangun produk data yang mencerminkan merek Anda secara efisien.

Perhatian

Perhatikan hal-hal berikut saat menggunakan solusi penyematan laporan berbasis tiket:

• Anda hanya dapat menyematkan Dasbor, Buku kerja, Dasbor data, laporan analisis ad hoc, laporan entri data, atau laporan dari Downloads ke sistem lain.

• Untuk mencoba fitur parameter global, hubungi pemilik operasional Quick BI.

• Quick BI Professional Edition mendukung solusi yang ditingkatkan, sedangkan edisi Pro hanya mendukung solusi dasar.

  Solusi dasar dan solusi yang ditingkatkan menyediakan fitur yang berbeda. Untuk informasi selengkapnya, lihat tabel berikut.

  Kemampuan	Solusi dasar	Solusi yang ditingkatkan
  Pengguna yang dilampirkan	Pemilik laporan. Nilai ini tidak dapat diubah.	Dapat dikustomisasi, sehingga memungkinkan Anda memberikan tampilan berbeda kepada pengguna berbeda.
  Jumlah akses	Hingga 100.000 kali per tiket.	Tanpa Batas. Anda dapat mengkustomisasi jumlah akses.
  Watermark	Tidak didukung.	Didukung. (Hal ini tidak berlaku jika layar besar tidak mendukung watermark.)
  Periode validitas	Hingga 240 menit.	Dapat dikustomisasi.
  Parameter global	Tidak didukung.	Didukung.
  Penyematan Blok	Tidak didukung.	Didukung.
  Jumlah pengalihan Catatan Penyematan juga harus diaktifkan untuk laporan yang dituju oleh pengalihan.	Hanya satu pengalihan yang diizinkan. Misalnya, jika Laporan A dialihkan ke Laporan B, Laporan B tidak dapat dialihkan ke Laporan C.	Jumlah pengalihan tanpa batas didukung. Misalnya, jika Laporan A dialihkan ke Laporan B, Laporan B dapat dialihkan ke Laporan C, dan Laporan C dapat dialihkan ke laporan lain.

Langkah 1: Aktifkan Penyematan untuk Laporan

Anda hanya dapat mengonfigurasi fitur penyematan laporan saat laporan berada dalam status Published.

Langkah 2: Hasilkan AccessTicket menggunakan Operasi API

1. Panggil operasi API CreateTicket untuk menghasilkan tiket yang diperlukan untuk penyematan laporan.

   Catatan

   Batasan berikut berlaku untuk akun yang digunakan untuk menghasilkan AccessTicket:

   • Jika akun dinonaktifkan di Tenant Management > User Management, Anda tidak dapat menghasilkan AccessTicket baru. Namun, AccessTicket yang sudah ada tetap dapat digunakan.

   • Jika akun dihapus di Tenant Management > User Management, Anda tidak dapat menghasilkan AccessTicket baru, dan AccessTicket yang sudah ada menjadi tidak valid.

   Tabel berikut menjelaskan parameter yang dapat dikonfigurasi untuk menghasilkan AccessTicket.

   Nama parameter	Tipe	Deskripsi
   WorksId	String	ID laporan tempat penyematan diaktifkan. Dasbor, Buku kerja, Dasbor data, laporan dari Downloads, laporan analisis ad hoc, dan laporan entri data didukung.
   CmptId	String	ID widget dalam salah satu laporan di atas. Untuk mendapatkan ID widget, panggil operasi API QueryWorksBloodRelationship.
   TicketNum	Integer	Jumlah tiket. Nilai default: 1. Nilai yang direkomendasikan: 1. Nilai maksimum: 99999. Setiap kali tiket digunakan untuk akses, jumlah sisa penggunaan tiket berkurang satu.
   UserId	String	ID pengguna Quick BI. Ini bukan ID akun Alibaba Cloud Anda. Anda dapat memanggil operasi API QueryUserInfoByAccount untuk mendapatkan ID pengguna. Contoh: fe67f61a35a94b7da1a34ba174a7****. Catatan Masukkan nilai untuk UserId atau AccountName. Jika keduanya dikosongkan, pemilik laporan akan digunakan secara default. Untuk mengonfigurasi izin tingkat baris, lihat Lampiran 1: Konfigurasi Izin Tingkat Baris.
   AccountName	String	Nama akun pengguna. Jika pengguna menggunakan akun Alibaba Cloud, seperti wangwu, formatnya adalah [Alibaba Cloud account]. Contoh: wangwu. Jika pengguna menggunakan RAM user, seperti zhangsan**@aliyun.cn, formatnya adalah [Alibaba Cloud account:RAM user]. Contoh: wangwu:zhangsan**. Catatan Masukkan nilai untuk UserId atau AccountName. Jika keduanya dikosongkan, pemilik laporan akan digunakan secara default. Untuk mengonfigurasi izin ting kat baris, lihat Lampiran 1: Konfigurasi Izin Tingkat Baris.
   AccountType	Integer	Tipe akun pengguna. 1: Akun Alibaba Cloud 3: Akun khusus Quick BI 5: RAM user Catatan Jika Anda menentukan AccountName, Anda juga harus menentukan AccountType.
   ExpireTime	Integer	Waktu kedaluwarsa. Unit: menit. Nilai default: 240. Ini adalah nilai maksimum untuk debugging halaman. Anda dapat mengkustomisasi nilai ini menggunakan operasi API. Nilai maksimum adalah nilai maksimum tipe Integer.
   WatermarkParam	String	Parameter watermark laporan. Panjang nilai tidak boleh melebihi 50 karakter.
   GlobalParam	String	Parameter global untuk kondisi filter laporan. Nilainya adalah string JSON. Catatan Untuk menggunakan fitur parameter global, hubungi pemilik operasional Quick BI.

   Catatan

   • Untuk mencegah pembagian tautan, atur TicketNum ke 1. Pengaturan ini berarti tautan sematan pihak ketiga yang dihasilkan hanya dapat diakses sekali.

   • Saat menyematkan laporan, Anda dapat melampirkan parameter watermark WatermarkParam.

2. Hasilkan AccessTicket.

   Untuk contoh kode, lihat Contoh SDK.

   Kode berikut menunjukkan contoh hasil yang dikembalikan:

   {
     "requestId" : "7D784AB0-5B77-077E-B628-E782B58D3898",
     "result" : "fd138bcb-****-4fde-b413-81bcee59bdb6",
     "success" : true
   }

   Catatan

   Nilai bidang result adalah AccessTicket yang dihasilkan oleh panggilan API ini. Dalam contoh ini, AccessTicket-nya adalah fd138bcb-****-4fde-b413-81bcee59bdb6.

Langkah 3: Gabungkan URL Single Sign-on

https://bi-cn-hongkong.data.aliyun.com/token3rd/report/view.htm?id=<42****18ef6>&accessTicket=fd138bcb-****-4fde-b413-81bcee59bdb6&cmptId=XXX

1. Dapatkan nama domain Quick BI.

   Misalnya, nama domain untuk situs Quick BI di wilayah China (Hong Kong) adalah bi-cn-hongkong.data.aliyun.com. Gunakan nama domain lingkungan spesifik Anda.

2. Dapatkan URL pratinjau laporan.

   Daftar berikut menyediakan URL halaman pratinjau untuk berbagai jenis laporan. Pilih URL yang sesuai.

   • Dasbor: token3rd/dashboard/view/pc.htm

   • Buku kerja: token3rd/report/view.htm

   • Dasbor data: token3rd/screen/view/pc.htm

   • Downloads: token3rd/offline/view/pc.htm

   • Analisis ad hoc: token3rd/analysis/view/pc.htm

   • Entri data: token3rd/dataform/view.htm

3. Pada halaman pengeditan laporan, dapatkan ID laporan.

   • ID Dasbor. Contoh: d01****c5f.

     Pada halaman pengeditan dasbor, dapatkan nilai pageId dari bilah alamat.

     

   • ID Buku kerja. Contoh: d0****3ba88.

     Pada halaman pengeditan buku kerja, dapatkan ID buku kerja dari bilah alamat.

   • ID Dasbor data. Contoh: 3c****26b.

     Pada halaman pengeditan dasbor data, dapatkan nilai pageId dari bilah alamat.

     

   • ID Downloads. Contoh: b2****47.

     Pada halaman pengeditan Downloads, dapatkan nilai pageId dari bilah alamat.

     

   • ID analisis ad hoc. Contoh: 7f****da.

     Pada halaman pengeditan analisis ad hoc, dapatkan nilai pageId dari bilah alamat.

     

   • ID entri data. Contoh: 29****53.

     Pada halaman pengeditan entri data, dapatkan nilai pageId dari bilah alamat.

     

4. Gabungkan nama domain Quick BI, URL pratinjau laporan, ID laporan, dan AccessTicket dari Langkah 2 untuk membuat URL permintaan.

   • Format URL Dasbor: https://<nama domain Quick BI>/<URL pratinjau laporan>?pageId=<ID Laporan>&accessTicket=<AccessTicket>

   • Format URL Buku kerja: https://<nama domain Quick BI>/<URL pratinjau laporan>?id=<ID Laporan>&accessTicket=<AccessTicket>

   • Format URL Dasbor data: https://<nama domain Quick BI>/<URL pratinjau laporan>?pageId=<ID Laporan>&accessTicket=<AccessTicket>

   • Format URL Downloads: https://<nama domain Quick BI>/<URL pratinjau laporan>?pageId=<ID Laporan>&accessTicket=<AccessTicket>

   • Format URL analisis ad hoc: https://<nama domain Quick BI>/<URL pratinjau laporan>?id=<ID Laporan>&accessTicket=<AccessTicket

   • Format URL entri data: https://<nama domain Quick BI>/<URL pratinjau laporan>?id=<ID Laporan>&accessTicket=<AccessTicket>

Lampiran 1: Konfigurasi Izin Tingkat Baris

Jika Anda tidak menentukan parameter UserId dan accountName, izin tampilan untuk laporan yang disematkan secara default mengikuti izin pemilik laporan. Untuk melampirkan izin pengguna tertentu, ikuti petunjuk pada gambar berikut untuk mengonfigurasi izin tingkat baris, lalu atur parameter UserId atau AccountName.Untuk informasi selengkapnya, lihat Izin tingkat baris dan kolom.

Lampiran 2: Pembuatan Parameter Global

Atur parameter global yang diperlukan dalam dasbor atau buku kerja target. Parameter global ini digunakan saat Anda melampirkan laporan dan menghasilkan AccessTicket.

[
  {
    "paramKey": "price", // Kunci parameter global
    "joinType": "and",   // Tipe gabungan. Gunakan 'and'.
    "conditionList": [
      {
        "operate": "=", // Operator. Lihat deskripsi di bawah.
        "value": "1"    // Nilai. Untuk beberapa nilai, gunakan array, seperti ["1", "2"].
      },
      {
        "operate": "=", // Operator. Lihat deskripsi di bawah.
        "value": "2"    // Nilai. Untuk beberapa nilai, gunakan array, seperti ["1", "2"].
      }
    ]
  },
  {
    "paramKey": "area", // Kunci parameter global
    "joinType": "and",   // Tipe gabungan. Gunakan 'and'.
    "conditionList": [
      {
        "operate": "in",          // Operator
        "value": ["North China","South China"]    // Nilai. Untuk beberapa nilai, gunakan array.
      }
    ]
  }
]

Lampiran 3: Jumlah Laporan yang Dapat Disematkan