Power BI Embedded を使用して分析ワークスペースおよびレポートをセキュリティで保護

[アーティクル]
03/21/2023

メモ

この機能は、Microsoft Dynamics 365 Finance、Enterprise Edition (2017 年 7 月) (バージョン 7.2) 以降のリリースでサポートされています。

概要

この記事では、Microsoft Power BI Embedded を使用して提供される、分析ワークスペースとレポートのセキュリティ保護を支援するアプリケーション開発者向けの手順を提供します。ビューアーのアクセス権に基づいてレポートおよびデータセット両方へのアクセスを保護するための推奨方法について説明します。この記事に記載されている手法を使用することにより、ユーザーからレポートを非表示にし、有効な会社のコンテキストに基づいて、特定のユーザーに適したデータセットを表示するためにレポートをフィルター処理することができます。

必要条件

プラットフォーム更新プログラム 8 以降を実行する開発環境へのアクセス
Microsoft Power BI Desktop を使用して作成され、エンティティ格納データベースから取得されたデータモデルを持つ分析レポート (.pbix ファイル)

概要

既存のアプリケーションワークスペースを拡張する場合でも、自身のワークスペースを追加する場合でも、埋め込み分析ビューを使用して、ビジネスデータの洞察的でインタラクティブなビューを提供できます。新しい分析ワークスペースおよびレポートを追加する前に、コンテンツを保護するための戦略を確立することは重要です。

Power BI Embedded を使用して分析ソリューションを開発する際には、いくつか注意すべき点があります。分析レポートはメニュー項目を使用して保護されます。レポートにアクセスすると、すべての閲覧者はレポートに定義されている基礎データモデルにアクセスできます。サービスオプションはレポートデータセットを戻しフィールドを自動的に非表示にすることが可能ですが、レポートのすべての閲覧者はデータモデル内のフィールドに有効的にアクセスできます。また、レポートがクライアントに表示される方法に影響を与える X++ 拡張機能が使用できます。 フィルター ウィンドウとレポート タブの両方を非表示にすることができます。ただし、Microsoft Power BI フィルターは、クライアント側のスクリプトインジェクションを使用して変更できます。

推奨事項

シナリオ固有の .pbix ファイルを作成して分析ビューを作成する:

ワークスペースを使用して提供される領域の概要
題材固有の分析レポート

メモ

これらの分析レポートは、中堅企業や大規模企業に影響を与えるデータを含むレポートを配信するために使用されることがよくあります。

分析レポートを作成する方法の詳細については、Power BI Desktop の使い方を参照してください。このページは、魅力的な分析レポート作成ソリューションの作成に役立つ素晴らしいソースです。

埋め込み Power BI レポートを通して提供される分析ビューのセキュリティを強化する

Power BI レポートフィルターと フィルター ウィンドウは、分析タブに埋め込まれたレポートにセッションコンテキストを渡すためのメカニズムとして機能します。フィルター ウィンドウの表示のオンとオフを切り替える機能は、セキュリティ機能ではありません。 Power BI レポートフィルターと、フィルター ウィンドウを非表示および表示する機能は、アプリケーションデザイナーが行うユーザーエクスペリエンス (UX) の決定です。

定義されている行レベルのセキュリティは Power BI レポートによって継承されていません。代わりに、アプリケーション開発者は、ワークスペースまたはレポートのセキュリティを高めることができます。

分析タブの分析ワークスペースのセキュリティを強化する

分析ワークスペースはフォームコントロールに表示される埋め込まれた Power BI レポートです。次の手順を完了しない限り、ワークスペースにアクセスできるすべてのユーザーには分析タブが表示され、Power BI レポートにアクセスできます。

分析ワークスペースのメニュー項目を追加します。

ユーザーがメニュー項目にアクセスできることを確認するために、フォームの初期化に hasMenuItemAccess アプリケーションプログラミングインターフェイス (API) が使用されていることを確認します。

// Note: secure entry point into the Workspace's Analytics report
if (Global::hasMenuItemAccess(menuItemDisplayStr(FMClerkWorkspace), MenuItemType::Display))
{
    FMPBIWorkspaceController controller = new FMPBIWorkspaceController();
    PBIReportHelper::initializeReportControl('FMPBIWorkspaces', powerBIReportGroup);
}

上記のロジックは、Power BI ビューアーコントロールの初期化を阻止します。したがって、空のタブがページに表示されます。既定では、フレームワークは自動的に空のタブを非表示にします。したがって、分析タブは非表示になっており、ユーザーが分析ワークスペースに関連付けられているメニュー項目へのアクセス権を持たない場合はアクセスできません。

分析レポートのセキュリティを強化する

アプリケーションの埋め込み Power BI レポートは、メニュー項目を使用してセキュリティで保護されます。アプリケーションのメニュー項目を使用して Power BI レポートに直接アクセスを試みるユーザーに、エラーが表示されます。分析レポートのセキュリティを確保するには、これらの手順に従います。

レポートまたは適切なタブのメニュー項目を追加します。既定では、その他のタブが選択されていない場合、レポートの最初のタブが表示されます。
メニュー項目を PowerBIEmbedded_App コンフィギュレーションキーにリンクします。

このメニュー項目は、Power BI Embedded サービスの可用性に関連付けられています。サービスを使用できない場合は、アプリケーションからメニュー項目のリンクが削除されます。

会社ごとの分析ワークスペースおよびレポートのセキュリティを強化する

Power BI ワークスペースとレポートは会社が保護できます (たとえば、DataAreaID 値など)。アプリケーションソリューションは、分析ワークスペースとレポートで会社レベルのセキュリティのために、次の手順を適用する必要があります。

このシナリオでは、Contoso USA の販売マネージャーが確認するワークスペースとレポートは、Contoso USA に関連するデータに限定されます。レポートビューアーは、会社のコンテキストが変更されない限り、他の会社に関連付けられたデータにアクセスできないようにする必要があります。

Microsoft Visual Studio プロジェクト内のリソースをダブルクリックして、Power BI Desktop で分析レポートを開きます。
モデリングタブで、ロールの管理をクリックします。
会社フィールドを含むデータモデル内の列に対して新しいロールを作成します。新しいロールに CompanyFilter と名前を付けます。会社によるアクセスを制限するために、データモデルに会社フィールドが必要です。
テーブルフィルターの DAX 式 フィールドに、[COMPANY]=username() と入力します。
ルールが機能することを確認するには、モデリング タブで ロールとして表示 をクリックします。ダイアログボックスで、次のフィールドを設定します。
1. なしチェックボックスをオフにします。
2. その他のユーザー チェックボックスをオンにし、テキストボックスに USMF と入力します。
3. CompanyFilter チェックボックスをオンにします。

これでレポートに、USMF 企業を経営しているかのようなデータが表示されます。

次の方法で共有