Quick BI：Solusi Peningkatan Keamanan untuk Kontrol Izin Data Tertanam dan Penyaluran Parameter dalam Laporan

Informasi latar belakang

Quick BI menawarkan solusi analitik tersemat dengan peningkatan keamanan, dikenal sebagai solusi penyematan laporan berbasis tiket. Saat menggunakan Quick BI Edisi Profesional, Anda dapat menerapkan kontrol keamanan komprehensif untuk tautan, akses, dan tampilan data. Solusi ini membantu Anda berintegrasi dengan sistem bisnis perusahaan secara efisien dengan biaya rendah dan membangun produk data yang mencerminkan merek Anda.

Tindakan Pencegahan

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 Unduhan ke dalam sistem lain.

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

• Quick BI Edisi Profesional mendukung solusi yang ditingkatkan. Edisi Pro hanya mendukung solusi dasar.

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

  Fitur	Solusi dasar	Solusi yang ditingkatkan
  Pengguna Terlampir	Pemilik laporan. Nilai ini tidak dapat diubah.	Dapat disesuaikan. Memungkinkan Anda memberikan tampilan berbeda kepada pengguna yang berbeda.
  Jumlah Akses	Hingga 100.000 kali per tiket.	Tidak terbatas. Anda dapat menyesuaikan jumlah akses.
  Watermark	Tidak didukung.	Didukung. (Tidak berlaku jika layar besar tidak mendukung watermark.)
  Masa berlaku	Hingga 240 menit.	Dapat disesuaikan.
  Parameter Global	Tidak didukung.	Didukung.
  Blok penyematan	Tidak didukung.	Didukung.
  Jumlah pengalihan Catatan Penyematan juga harus diaktifkan untuk laporan yang dialihkan.	Hanya satu pengalihan yang diizinkan. Sebagai contoh, jika Laporan A dialihkan ke Laporan B, Laporan B tidak dapat dialihkan ke Laporan C.	Sejumlah pengalihan tidak terbatas didukung. Sebagai contoh, 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 Diterbitkan.

Langkah 2: Hasilkan AccessTicket menggunakan Operasi API

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

   Tabel berikut menjelaskan parameter yang dapat Anda konfigurasikan untuk menghasilkan AccessTicket.

   Parameter	Tipe	Deskripsi
   WorksId	String	ID laporan yang mana penyematan diaktifkan. Dasbor, buku kerja, dasbor data, laporan dari Unduhan, laporan analisis ad hoc, dan laporan entri data didukung.
   CmptId	String	ID widget dalam salah satu laporan sebelumnya. Untuk mendapatkan ID widget, panggil operasi API QueryWorksBloodRelationship.
   TicketNum	Integer	Jumlah kali tiket dapat digunakan. Nilai default: 1. Nilai yang direkomendasikan: 1. Nilai maksimum: 99999. Setiap kali tiket digunakan untuk akses, jumlah sisa kali tiket dapat digunakan 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 Anda meninggalkan keduanya kosong, pemilik laporan 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 [Akun Alibaba Cloud]. Contoh: wangwu. Jika pengguna menggunakan Pengguna RAM, seperti zhangsan**@aliyun.cn, formatnya adalah [Akun Alibaba Cloud:Pengguna RAM]. Contoh: wangwu:zhangsan**. Catatan Masukkan nilai untuk UserId atau AccountName. Jika Anda meninggalkan keduanya kosong, pemilik laporan digunakan secara default. Untuk mengonfigurasi izin tingkat baris, lihat Lampiran 1: Konfigurasi izin tingkat baris.
   AccountType	Integer	Tipe akun pengguna. 1: Akun Alibaba Cloud 3: Akun spesifik Quick BI 5: Pengguna RAM 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 menyesuaikan nilai ini menggunakan operasi API. Nilai maksimum adalah nilai maksimum dari tipe Integer.
   WatermarkParam	String	Parameter watermark laporan. Nilainya tidak boleh melebihi 50 karakter panjangnya.
   GlobalParam	String	parameter global untuk kondisi filter laporan. Nilainya adalah string JSON. Catatan Untuk menggunakan fitur parameter global, hubungi pemilik operasi Quick BI.

   Catatan

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

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

2. Hasilkan AccessTicket.

   Untuk kode contoh, 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 dari bidang result adalah AccessTicket yang dihasilkan oleh pemanggilan API ini. Dalam contoh ini, AccessTicket 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.

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

2. Dapatkan URL pratinjau laporan.

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

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

   • Workbook: token3rd/report/view.htm

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

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

   • Analisis Ad Hoc: token3rd/analysis/view/pc.htm

   • Entri Data: token3rd/dataform/view.htm

3. Di halaman pengeditan laporan, dapatkan ID laporan.

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

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

     

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

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

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

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

     

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

     Di halaman pengeditan Unduhan, dapatkan nilai pageId dari bilah alamat.

     

   • ID Analisis Ad Hoc. Contoh: 7f****da.

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

     

   • ID Entri Data. Contoh: 29****53.

     Di 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 Unduhan: 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 tersemat default ke 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 lebih lanjut, lihat Izin Tingkat Baris dan Kolom.

Lampiran 2: Pembuatan parameter global

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

[
  {
    "paramKey": "price", // Kunci parameter global
    "joinType": "and",   // Jenis 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",   // Jenis 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