Real-Time ダッシュボード項目を JavaScript または TypeScript Web アプリケーションに埋め込む前に、Microsoft Fabric埋め込みを設定します。 ワークスペースには、Microsoft Fabric容量、Real-Time ダッシュボード項目へのユーザー アクセス、委任されたアクセス許可を使用したMicrosoft Entra ID アプリの登録、ローカル開発ツールが割り当てられている必要があります。
Microsoft Fabric Embed は、サポートされているMicrosoft Fabric項目を埋め込むためのパブリック プレビュー機能です。
Note
Microsoft Fabric埋め込みはパブリック プレビュー段階です。 サポートされている項目の種類、認証、およびプレビュー コントラクトの制限については、「Microsoft Fabric埋め込みの制限事項」を参照してください。
Microsoft Fabric埋め込みセットアップの前提条件
前提条件の一覧については、「Microsoft Fabric Embed を使用するには何が必要ですか?」を参照してください。
Fabric ワークスペースを構成する
Microsoft Fabric埋め込みでは、委任されたユーザー アクセスがサポートされます。 サインインMicrosoft Entra IDユーザーは、埋め込みアプリケーションで同じアイテムをレンダリングする前に、Microsoft Fabricで Real-Time ダッシュボード項目を開くことができる必要があります。
- Microsoft Fabricを開きます。
- Real-Time ダッシュボード項目を含むワークスペースを開きます。
- ワークスペースがアクティブなMicrosoft Fabric容量に割り当てられていることを確認します。
- 埋め込み Real-Time ダッシュボードアイテムを表示するユーザーが、ワークスペースと Real-Time ダッシュボード項目に対するビューアー以上のアクセス権を持っていることを確認します。
成功チェック: ワークスペースにアクティブな容量の割り当てが表示され、ユーザーはMicrosoft Fabric ポータルで Real-Time ダッシュボード項目を直接開くことができます。
Important
サインインしているユーザーが、Microsoft Fabricのワークスペースまたは Real-Time ダッシュボード項目にアクセスできない場合、埋め込みMicrosoft Fabricは埋め込みアプリケーションにアイテムをレンダリングしません。
ユーザー サインイン用のMicrosoft Entra ID アプリを登録する
JavaScript または TypeScript アプリケーションでは、ユーザーをサインインさせ、Microsoft Fabric Embed の委任されたアクセス トークンを要求するために、Microsoft Entra ID アプリの登録が必要です。
Azure portal にサインインする
ページの右上隅にあるアカウントを選択して、Microsoft Entra テナントを選択します。
[アプリの登録] を選択します。 このオプションが表示されない場合は、検索します。
アプリの登録で、[新規登録] を選択します。
以下のフィールドに記入してください。
- 名前 - アプリケーションに名前を付けます。
- サポートされているアカウントの種類 - アプリケーションを使用できるユーザーを選択します。 シングルテナント アプリの場合は この組織ディレクトリのみに含まれるアカウント を、クロステナントのシナリオの場合は 任意の組織ディレクトリに含まれるアカウント を選択します。
(省略可能)[ リダイレクト URI ] ボックスにリダイレクト URL を追加します。
登録を選択します。 アプリが登録されると、アプリの概要ページが表示され、 そこでアプリケーション ID を取得できます。 後で使用できるように、 アプリケーション ID とすべての情報を [ 概要 ] ボックスにコピーして保存します。 Microsoft Fabric埋め込み環境を使用する準備ができました。
成功チェック: アプリ登録の概要には、アプリケーションが Microsoft Authentication Library (MSAL) 認証に使用するクライアント ID とテナント ID が表示されます。
Note
これらの値を利用可能な状態にしておいてください。 アプリケーションで認証を構成するときに使用します。
Microsoft Fabric Embed の委任された API アクセス許可を追加する
アプリは、Fabric埋め込み、項目の読み取りアクセス、およびオプションのワークスペース検出に対して委任された API アクセス許可を要求する必要があります。 Microsoft Fabric埋め込みには、委任されたユーザーアクセス許可を使用します。
アプリの登録で、 API のアクセス許可を開きます。
アクセス許可の追加 を選択します。
シナリオに一致する委任されたアクセス許可を追加します。
組織で管理者の同意が必要な場合は、テナント管理者に同意を求めます。
Note
シナリオに必要な、必要最小限の委任されたアクセス許可を要求してください。
| 許可 | いつ使用するか | Purpose |
|---|---|---|
Fabric.Embed |
Microsoft Fabric の埋め込みに必要です。 | サポートされているMicrosoft Fabric項目をアプリケーションに埋め込むことができます。 |
KQLDashboard.Read.All |
Real-Time ダッシュボード項目の優先読み取りアクセス許可。 | アプリケーションで、サインインしているユーザーがアクセスできる Real-Time Dashboard 項目を読み取ることを許可します。 |
Item.Read.All |
シナリオで、より広範なFabric項目の読み取りアクセスが必要な場合にのみ使用します。 | サインインしているユーザーがアクセスできるFabric項目をアプリケーションで読み取ることができます。 |
Workspace.Read.All |
アプリケーションが Microsoft Fabric REST API を使用してワークスペースまたはアイテム ID を検出する場合にのみ必要です。 | サインイン中のユーザーによる読み取り専用のワークスペースの検出を許可します。 |
成功チェック: アプリの登録には、Fabric.Embed、1 つの項目の読み取りアクセス許可、Workspace.Read.Allが含まれます。これは、アプリケーションが MICROSOFT FABRIC REST API を使用して ID を検出する場合のみです。
Web アプリ用のローカル開発ツールをインストールする
埋め込み Real-Time ダッシュボード項目をホストする JavaScript または TypeScript アプリケーション用に、次のツールとライブラリをインストールします。
- Fabric Embed SDK パッケージをインストールするためのNode.jsと npm
- コード エディター (Visual Studio Code など)。
- Microsoft Entra ID認証用の JavaScript のMicrosoft Authentication Library (MSAL)
Web アプリに Fabric Embed SDK パッケージをインストールする
埋め込まれた Real-Time Dashboard 項目をホストする Web アプリケーションに、パブリック プレビュー版の Fabric Embed SDK パッケージをインストールします。 パッケージの名前とバージョンは、プレビュー中に変更される可能性があります。 プレビュー リリースで提供されるパッケージ名を使用します。
npm install @microsoft/fabric-embed
成功チェック: Fabric埋め込み SDK パッケージがアプリケーションのpackage.json依存関係に表示されます。
ワークスペースと Real-Time ダッシュボード ID を収集する
また、Microsoft Fabric REST API を使用して、ワークスペース ID と Real-Time ダッシュボード項目 ID をプログラムで収集することもできます。 Microsoft Fabric ポータルから ID をコピーするのではなく、セットアップ スクリプトまたはアプリケーションで ID を検出する必要がある場合は、Microsoft Fabric REST API を使用します。
List Workspaces API を使用してワークスペース ID を取得します。
GET https://api.fabric.microsoft.com/v1/workspacesワークスペースを
displayNameで検索し、そのid値をコピーします。リスト アイテム API を使用して、Real-Time ダッシュボード項目 ID を取得します。
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboard<workspaceId>を前の手順のワークスペース ID に置き換えます。 応答で、Real-Time ダッシュボード項目をdisplayNameで検索し、そのid値をコピーします。 その値を埋め込み構成の項目 ID として使用します。
Note
Microsoft Fabric REST API では、Real-Time ダッシュボード項目の項目タイプの値は KQLDashboard です。
必要に応じて、次の呼び出しによって項目 ID を検証します:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>
Get Item API を使用して、ワークスペース ID とアイテム ID によって、想定される Real-Time Dashboard アイテムが特定されることを確認します。
成功チェック: リスト アイテムの応答には、予想されるダッシュボード displayName、アイテム ID の id 値、およびアイテムの種類の値 KqlDashboardが含まれます。