Microsoft Fabric埋め込みでは、サポートされているMicrosoft Fabric項目をブラウザー ベースの Web アプリケーションに追加または埋め込むことができます。 Fabric ポータルを開くのではなく、ユーザーがアプリケーション内のFabricコンテンツを表示して操作する場合は、Fabric埋め込みを使用します。
この記事では、埋め込みMicrosoft Fabricのしくみ、どのプレビュー要件が適用されるか、埋め込むことができるFabric項目について説明します。
Microsoft Fabric の埋め込みを使用するには何が必要ですか?
開始する前に、次の内容があることを確認します。
- サインインしているMicrosoft Entra ユーザーのMicrosoft Fabric テナントと委任されたアクセス トークンへのアクセス。
- Microsoft Entra ID アプリの登録を作成または更新するアクセス許可
- 有効なMicrosoft Fabric キャパシティ (F SKU)
- そのキャパシティに割り当てられたMicrosoft Fabricワークスペース
- Real-Time ダッシュボード項目を含むワークスペースへのビューアー以上のアクセス権
- ワークスペースでアクセスできる Real-Time ダッシュボード項目
- Microsoft Entra ID のユーザー サインインを使用する JavaScript または TypeScript の Web アプリケーション
- 開発用コンピューターにインストールされている Node.js と npm
- Fabric 埋め込みソフトウェア開発キット (SDK)
Microsoft Fabric で Microsoft Fabric Embed を使用するのはどのような場合ですか?
Fabric Embed は、カスタム アプリケーション、ポータル、ビジネス ワークフローなど、ユーザーが既に使用しているアプリケーションやワークフロー内にリアルタイム ダッシュボード分析を表示します。 埋め込みエクスペリエンスでは、個別のアクセス モデルではなく、Fabricガバナンス、ワークスペースのアクセス許可、およびMicrosoft Entra IDユーザー ID が使用されます。
次のことが必要な場合は、Microsoft Fabric Embed を使用します:
- パブリック プレビュー中に JavaScript または TypeScript Web アプリケーション内に Real-Time ダッシュボードを表示する
- ユーザーがFabricコンテンツを探索している間、ユーザーがアプリケーションに残ることを許可する
- アクセス制御には、Microsoft Fabric のガバナンス、Fabric ワークスペースのアクセス許可、Microsoft Entra ID を使用します
- 基になるFabric項目に既にアクセスできるユーザー向けのユーザー ベースの埋め込みエクスペリエンスを構築する
Microsoft Fabric Embed プレビューでは、どの種類のアイテムがサポートされていますか?
パブリック プレビュー期間中、Microsoft Fabric埋め込みでは、Real-Time ダッシュボードのみがサポートされます。
Microsoft Fabric 埋め込みプレビューの認証と承認のしくみ
Microsoft Fabric埋め込みでは、委任されたユーザー認証が使用されます。 Microsoft Entra IDサインインしているユーザーに委任されたトークンを発行します。これはアプリ専用またはサービス プリンシパル トークンではありません。 このユーザー ベースの認証モデルでは、サインインしているユーザーの代わりにコンテンツが埋め込まれており、Fabricはそのユーザーのアクセス許可に基づいてアクセスを強制します。
Microsoft Fabric埋め込みプレビュー ソリューションを計画するときは、次の認証と承認の要件を使用します。
| 認証要件 | Microsoft Fabric Embed のプレビュー動作 |
|---|---|
| ユーザー サインイン | アプリケーションは、Microsoft Entra IDを使用してユーザーをサインインします。 |
| 委任されたトークン | このアプリケーションは、Fabric の埋め込みと項目へのアクセスに対する委任されたアクセス許可を要求しています。 |
| ワークスペースとアイテムへのアクセス | サインインしているユーザーは、ワークスペースと Real-Time ダッシュボード項目とリアルタイム ダッシュボード データ ソースにアクセスできる必要があります。 |
| リダイレクト URI | Microsoft Entra アプリの登録には、アプリケーションで使用されるリダイレクト URI が含まれている必要があります。 |
Microsoft Fabric Embed にはどの Fabric 容量が必要ですか?
Microsoft Fabric Embed では、リアルタイム ダッシュボードを含むワークスペースが Fabric 容量 (F SKU) を使用している必要があります。 Fabric 容量は、Fabric ワークロードとアイテムで使用されるコンピューティング リソースを提供します。 埋め込みエクスペリエンスを構築する前に、ダッシュボードを含むワークスペースをFabric容量に割り当てます。
| 容量の要件 | Microsoft Fabric の埋め込み機能にとって何を意味するのか |
|---|---|
| Fabric キャパシティ (F SKU) | Real-Time ダッシュボード ワークスペースは、埋め込みエクスペリエンスで Fabric 容量を使用する必要があります。 |
| ファブリックの試用容量 | Microsoft Fabric Embed は、Fabric trial capacity で説明されている制限に従って、Fabric の試用版容量をサポートします。 |
Microsoft Fabric の埋め込みの制限事項
Microsoft Fabric埋め込みパブリック プレビューには、次の制限があります。
- Real-Time ダッシュボードのみがサポートされています。パブリック プレビュー中は、Microsoft Fabric埋め込みを使用して他のFabric項目の種類を埋め込むはできません。
- 委任されたユーザー認証のみがサポートされています。ユーザーはMicrosoft Entra IDを使用してサインインする必要があります。 サービス プリンシパル (アプリ専用) 認証はサポートされていません。
- アプリ所有データの埋め込みはサポートされていません- Microsoft Fabric埋め込みプレビューでは、Fabricアイテムにアクセスできないユーザーのアプリ専用トークンやコンテンツの埋め込みをサポートしていません。 サインインしているユーザーは、Fabricでアイテムを開くことができる必要があります。
- Power BI アイテムには Power BI Embedded analytics を使用します - Power BI Embedded analytics を使用して、Power BI レポート、ダッシュボード、またはタイルを埋め込みます。Microsoft Fabric Embed プレビューでは、それらは Fabric アイテムとして埋め込まれません。
- プレビュー コントラクトが変更される可能性があります 。SDK パッケージ名、API サーフェス、イベント、型名、および構成コントラクトは、一般公開前に変更される可能性があります。 アプリケーションを更新する前に、パブリック プレビューリリース ノートを確認してください。
次のステップ
Microsoft Fabric埋め込みプレビュー ソリューションの ID、容量、製品コンテキストを準備するには、次のリソースを使用します。