Quick BI:レポートにおける埋め込みデータ権限制御とパラメーター伝送のセキュリティ強化ソリューション

背景情報

Quick BI は、チケットベースのレポート埋め込みソリューションとして知られる、セキュリティ強化された埋め込み分析ソリューションを提供します。Quick BI Professional Edition を使用すると、リンク、アクセス、データ表示に対する包括的なセキュリティ制御を実装できます。このソリューションは、低コストで企業業務システムとの統合を支援し、ブランドを反映したデータプロダクトを効率的に構築します。

注意事項

チケットベースのレポート埋め込みソリューションを使用する際は、次の点に注意してください。

• ダッシュボード、ワークブック、データダッシュボード、アドホック分析レポート、データ入力レポート、またはダウンロードからのレポートのみを他のシステムに埋め込むことができます。

• グローバルパラメーター機能を試すには、Quick BI 運用オーナーにお問い合わせください。

• Quick BI Professional Edition は強化ソリューションをサポートしています。Pro エディションは基本ソリューションのみをサポートしています。

  基本ソリューションと強化ソリューションは異なる機能を提供します。詳細については、次の表をご参照ください。

  機能	基本ソリューション	強化ソリューション
  紐付けユーザー	レポートオーナー。この値は変更できません。	カスタマイズ可能。これにより、異なるユーザーに異なるビューを提供できます。
  アクセス回数	チケットあたり最大 100,000 回。	無制限。アクセス回数をカスタマイズできます。
  ウォーターマーク	サポートされていません。	サポートされています。 (大画面がウォーターマークをサポートしていない場合は適用されません。)
  有効期間	最大 240 分。	カスタマイズ可能。
  グローバルパラメーター	サポートされていません。	サポートされています。
  埋め込みブロック	サポートされていません。	サポートされています。
  リダイレクト数 説明 リダイレクト先のレポートでも埋め込みが有効になっている必要があります。	リダイレクトは 1 回のみ許可されます。 たとえば、レポート A がレポート B にリダイレクトされる場合、レポート B はレポート C にリダイレクトできません。	無制限のリダイレクトがサポートされています。 たとえば、レポート A がレポート B にリダイレクトされる場合、レポート B はレポート C にリダイレクトでき、レポート C は別のレポートにリダイレクトできます。

ステップ 1: レポートの埋め込みを有効にする

レポートの埋め込み機能は、レポートが公開済み状態の場合にのみ設定できます。

ステップ 2: API 操作を使用して AccessTicket を生成する

1. CreateTicket API 操作を呼び出して、レポート埋め込みに必要なチケットを生成します。

   説明

   AccessTicket の生成に使用されるアカウントには、次の制限が適用されます。

   • [テナント管理] > [ユーザー管理] でアカウントが無効になっている場合、新しい AccessTicket を生成することはできません。ただし、既存の AccessTicket は引き続き使用可能です。

   • [テナント管理] > [ユーザー管理] でアカウントが削除されている場合、新しい AccessTicket を生成することはできず、既存の AccessTicket は無効になります。

   次の表は、AccessTicket の生成に設定できるパラメーターについて説明します。

   パラメーター名	タイプ	説明
   WorksId	String	埋め込みが有効になっているレポートの ID。 ダッシュボード、ワークブック、データダッシュボード、ダウンロードからのレポート、アドホック分析レポート、およびデータ入力レポートがサポートされています。
   CmptId	String	上記レポートのいずれかのウィジェットの ID。 ウィジェット ID を取得するには、QueryWorksBloodRelationship API 操作を呼び出します。
   TicketNum	Integer	チケット数。 デフォルト値: 1。 推奨値: 1。 最大値: 99999。 チケットがアクセスに使用されるたびに、チケットの残りの使用可能回数が 1 つ減ります。
   UserId	String	Quick BI ユーザーの ID。これはご利用の Alibaba Cloud アカウント ID ではありません。 QueryUserInfoByAccount API 操作を呼び出してユーザー ID を取得できます。例: fe67f61a35a94b7da1a34ba174a7****。 説明 [UserId] または [AccountName] のいずれかに値を入力します。両方とも空欄のままにした場合、デフォルトでレポートのオーナーが使用されます。行レベルの権限を設定するには、「付録 1: 行レベルの権限を設定する」をご参照ください。
   AccountName	String	ユーザーアカウントの名前。 ユーザーが wangwu のような Alibaba Cloud アカウントを使用している場合、形式は [Alibaba Cloud アカウント] です。例: wangwu。 ユーザーが zhangsan**@aliyun.cn のような RAM ユーザーを使用している場合、形式は [Alibaba Cloud アカウント:RAM ユーザー] です。例: wangwu:zhangsan**。 説明 [UserId] または [AccountName] に値を入力します。 両方を空のままにした場合、デフォルトでレポートのオーナーが使用されます。 行レベルの権限を設定するには、「付録 1: 行レベルの権限を設定する」をご参照ください。
   AccountType	Integer	ユーザーアカウントのタイプ。 1: Alibaba Cloud アカウント 3: Quick BI 固有のアカウント 5: RAM ユーザー 説明 AccountName を指定する場合は、AccountType も指定する必要があります。
   ExpireTime	Integer	有効期限。 単位: 分。 デフォルト値: 240。これはページデバッグの最大値です。API 操作を使用してこの値をカスタマイズできます。最大値は Integer 型の最大値です。
   WatermarkParam	String	レポートのウォーターマークパラメーター。 値は 50 文字を超えることはできません。
   GlobalParam	String	レポートフィルター条件の グローバルパラメーター。 値は JSON 文字列です。 説明 グローバルパラメーター機能を使用するには、Quick BI 運用オーナーにお問い合わせください。

   説明

   • リンク共有を防ぐには、TicketNum を 1 に設定します。この設定は、生成されたサードパーティ埋め込みリンクが 1 回のみアクセス可能であることを意味します。

   • レポートを埋め込む際、[WatermarkParam] ウォーターマークパラメーターを紐付けることができます。

2. AccessTicket を生成します。

   サンプルコードについては、「SDK 例」をご参照ください。

   次のコードは、返された結果の例を示しています。

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

   説明

   result フィールドの値は、この API 呼び出しによって生成された AccessTicket です。この例では、AccessTicket は fd138bcb-****-4fde-b413-81bcee59bdb6 です。

ステップ 3: シングルサインオン URL の連結

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

1. Quick BI ドメイン名を取得する。

   たとえば、中国 (香港) リージョンの Quick BI サイトのドメイン名は bi-cn-hongkong.data.aliyun.com です。ご利用の特定の環境のドメイン名を使用する必要があります。

2. レポートプレビュー URL を取得する。

   次のリストは、異なるタイプのレポートのプレビューページ URL を提供します。必要な URL を選択してください。

   • ダッシュボード: token3rd/dashboard/view/pc.htm

   • ワークブック: token3rd/report/view.htm

   • データダッシュボード: token3rd/screen/view/pc.htm

   • ダウンロード: token3rd/offline/view/pc.htm

   • アドホック分析: token3rd/analysis/view/pc.htm

   • データ入力: token3rd/dataform/view.htm

3. レポート編集ページで、レポート ID を取得する。

   • ダッシュボード ID。例: d01****c5f。

     ダッシュボード編集ページで、アドレスバーから pageId の値を取得します。

     

   • ワークブック ID。例: d0****3ba88。

     ワークブック編集ページで、アドレスバーからワークブック ID を取得します。

   • データダッシュボード ID。例: 3c****26b。

     データダッシュボード編集ページで、アドレスバーから pageId の値を取得します。

     

   • ダウンロード ID。例: b2****47。

     ダウンロード編集ページで、アドレスバーから pageId の値を取得します。

     

   • アドホック分析 ID。例: 7f****da。

     アドホック分析編集ページで、アドレスバーから pageId の値を取得します。

     

   • データ入力 ID。例: 29****53。

     データ入力編集ページで、アドレスバーから pageId の値を取得します。

     

4. Quick BI ドメイン名、レポートプレビュー URL、レポート ID、および ステップ 2 の AccessTicket を連結して、リクエスト URL を作成します。

   • ダッシュボード URL 形式: https://<Quick BI domain name>/<Report preview URL>?pageId=<Report ID>&accessTicket=<AccessTicket>

   • ワークブック URL 形式: https://<Quick BI domain name>/<Report preview URL>?id=<Report ID>&accessTicket=<AccessTicket>

   • データダッシュボード URL 形式: https://<Quick BI domain name>/<Report preview URL>?pageId=<Report ID>&accessTicket=<AccessTicket>

   • ダウンロード URL 形式: https://<Quick BI domain name>/<Report preview URL>?pageId=<Report ID>&accessTicket=<AccessTicket>

   • アドホック分析 URL 形式: https://<Quick BI domain name>/<Report preview URL>?id=<Report ID>&accessTicket=<AccessTicket

   • データ入力 URL 形式: https://<Quick BI domain name>/<Report preview URL>?id=<Report ID>&accessTicket=<AccessTicket>

付録 1: 行レベルの権限設定

UserId および accountName パラメーターを指定しない場合、埋め込みレポートの表示権限はデフォルトでレポートオーナーの権限になります。特定のユーザーの権限を紐付けるには、次の図の指示に従って行レベルの権限を設定し、UserId または AccountName パラメーターを設定します。詳細については、「行レベルおよび列レベルの権限」をご参照ください。

付録 2: グローバルパラメーターの生成

ターゲットダッシュボードまたはワークブックで必要なグローバルパラメーターを設定します。これらのグローバルパラメーターは、レポートを紐付けたり AccessTicket を生成したりする際に使用されます。

[
  {
    "paramKey": "price", // グローバルパラメーターキー
    "joinType": "and",   // 結合タイプ。「and」を使用します。
    "conditionList": [
      {
        "operate": "=", // オペレーター。以下の説明をご参照ください。
        "value": "1"    // 値。複数の値の場合は、["1", "2"] のように配列を使用します。
      },
      {
        "operate": "=", // オペレーター。以下の説明をご参照ください。
        "value": "2"    // 値。複数の値の場合は、["1", "2"] のように配列を使用します。
      }
    ]
  },
  {
    "paramKey": "area", // グローバルパラメーターキー
    "joinType": "and",   // 結合タイプ。「and」を使用します。
    "conditionList": [
      {
        "operate": "in",          // オペレーター
        "value": ["North China","South China"]    // 値。複数の値の場合は、配列を使用します。
      }
    ]
  }
]

付録 3: 埋め込み可能なレポート数