埋め込みアプリケーションのトラブルシューティング

[アーティクル]
12/27/2023

この記事では、Power BI からコンテンツを埋め込むときに発生する可能性がある一般的な問題について説明します。

トラブルシューティングツール

Fiddler のトレース

Fiddler は、HTTP トラフィックを監視する Telerik 提供の無償ツールです。クライアントコンピューターから Power BI API によるトラフィックを確認できます。このツールでは、エラーとその他の関連する情報が表示される場合があります。

Fiddler ツールの出力ウィンドウのスクリーンショット。Power BI API の HTTP トラフィックが表示されています。

ブラウザーで F12 キーを押してフロントエンドデバッグを実行する

F12 キーを押すと、ブラウザー内で開発者ウィンドウが起動します。このツールを使用すると、ネットワークトラフィックやその他重要な情報を確認できます。

Web ブラウザーの開発者ウィンドウの [ネットワーク] タブのスクリーンショット。ネットワークトラフィックが表示されています。

Power BI 応答からエラーの詳細を抽出する

このコードスニペットは、HTTP 例外からエラーの詳細を抽出する方法を示しています。

public static string GetExceptionText(this HttpOperationException exc)
{
    var errorText = string.Format("Request: {0}\r\nStatus: {1} ({2})\r\nResponse: {3}",
    exc.Request.Content, exc.Response.StatusCode, (int)exc.Response.StatusCode, exc.Response.Content);
    if (exc.Response.Headers.ContainsKey("RequestId"))
    {
        var requestId = exc.Response.Headers["RequestId"].FirstOrDefault();
        errorText += string.Format("\r\nRequestId: {0}", requestId);
    }

    return errorText;
}

要求 ID (およびエラーの詳細をトラブルシューティングのために) をログに記録することをお勧めします。 Microsoft サポートに連絡する際に、要求 ID を指定してください。

アプリの登録

アプリ登録エラー

Azure portal または Power BI アプリ登録ページ内のエラーメッセージは、アプリを登録するための十分な権限がない場合に通知されます。アプリケーションを登録するには、Microsoft Entra テナントの管理者になる必要があります。または、非管理者ユーザーのアプリケーション登録を有効にする必要があります。

新しいアプリを登録したとき、Power BI サービスが Azure portal に表示されない

少なくとも 1 名のユーザーを Power BI に登録する必要があります。 API 一覧に Power BI サービスが表示されない場合、Power BI にユーザーが登録されていません。

アプリケーションオブジェクト ID とプリンシパルオブジェクト ID の違いは何ですか?

Microsoft Entra アプリを登録する場合は、"オブジェクト ID" と呼ばれる 2 つのパラメータがあります。このセクションでは、各パラメーターの目的と、それを取得する方法について説明します。

アプリケーションオブジェクト ID

アプリケーションオブジェクト ID (単に "オブジェクト ID" とも呼ばれます) は、Microsoft Entra アプリケーションオブジェクトの一意の ID です。

アプリケーションオブジェクト ID を取得するには、Microsoft Entra アプリに移動し、[概要] からコピーしてください。

Azure portal ウィンドウのスクリーンショット。Microsoft Entra アプリケーションの [概要] ブレードにオブジェクト ID が表示されています。

プリンシパルオブジェクト ID

プリンシパルオブジェクト ID (単に "オブジェクト ID" とも呼ばれます) は、Microsoft Entra アプリケーションに関連付けられたサービスプリンシパルオブジェクトの一意の ID です。

プリンシパルオブジェクト ID を取得するには、Microsoft Entra アプリに移動し、[概要] の [ローカルディレクトリの管理対象アプリ] にあるアプリリンクを選択してください。

Azure portal ウィンドウのスクリーンショット。Microsoft Entra アプリケーションの [概要] ブレードの [ローカルディレクトリでのマネージドアプリケーション] オプションが表示されています。

[プロパティ] セクションから、 [オブジェクト ID] をコピーします。

Azure portal ウィンドウのスクリーンショット。Microsoft Entra アプリケーションの [概要] ブレードのプロパティセクションにプリンシパルオブジェクト ID が表示されています。

認証

AADSTS70002 または AADSTS50053 で認証が失敗しました

(AADSTS70002: 資格情報の検証エラー。AADSTS50053: 正しくないユーザー ID またはパスワードでのサインインの試行回数が上限に達しました)

Power BI Embedded と Microsoft Entra 直接認証を使用している場合、サインインしようとすると前のメッセージのようなメッセージを受け取ることがあります。これは、直接認証が有効になっていないためです。

組織またはサービスプリンシパルにスコープ設定された Microsoft Entra ポリシーを使用して、直接認証をオンに戻すことができます。

このポリシーは、アプリごとにのみ有効にすることをお勧めします。

このポリシーを作成するには、ポリシーを作成して割り当てるディレクトリに対してグローバル管理者である必要があります。ポリシーを作成してこのアプリケーションの SP に割り当てるサンプルスクリプトを次に示します。

Microsoft Graph PowerShell SDK をインストールします。

次の PowerShell コマンドを 1 行ずつ実行します (結果として、変数 $sp に複数のアプリケーションが含まれていないことを確認します)。

Connect-MgGraph -Scopes "Directory.Read.All","Policy.ReadWrite.ApplicationConfiguration"

$sp = Get-MgServicePrincipal -Filter "DisplayName eq 'Name_Of_Application'"

$policy = New-MgBetaPolicyActivityBasedTimeoutPolicy -Definition @("{`"AllowCloudPasswordValidation`":true}") `
   -DisplayName EnableDirectAuth -IsOrganizationDefault:$false

$params = @{
   "@odata.id" = "https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies/$policy.Id"
}
New-MgBetaServicePrincipalClaimMappingPolicyByRef -ServicePrincipalId $sp.Id `
   -BodyParameter $params

ポリシーを割り当てたら、テストを行う前に、約 15 秒から 20 秒、伝達のための時間を待機します。

有効な ID が与えられた GenerateToken が失敗する

いくつかの理由から、有効な ID が与えられた GenerateToken が失敗することがあります。

セマンティックモデルが有効な ID に対応していない。
ユーザー名が指定されていない。
ロールが指定されていない。
DatasetId が指定されていない。
ユーザーに正しいアクセス許可が与えられていない。

問題を特定するには、次の手順をお試しください。

データセットの取得を実行します。プロパティ IsEffectiveIdentityRequired は true ですか?
すべての EffectiveIdentity にはユーザー名が必要です。
IsEffectiveIdentityRolesRequired が true の場合は、ロールが必要です。
すべての EffectiveIdentity には DatasetId が必要です。
Analysis Services の場合、マスターユーザーをゲートウェイ管理者にする必要があります。

AADSTS90094: 許可には管理者権限が必要です

症状:

同意を与えるとき、管理者以外のユーザーがアプリケーションに初めてサインインすると、次のいずれかのエラーが返されます。

  ConsentTest needs permission to access resources in your organization that only an admin can grant. Ask an admin to grant permission to this app before you can use it.

  AADSTS90094: The grant requires admin permission.

Consent Test のアクセス許可エラーを示す、Azure portal ウィンドウのサインインダイアログのスクリーンショット。

管理者ユーザーは正常にサインインし、同意を許可することができます。

根本原因:

ユーザーの同意がテナントに対して無効です。

いくつかの修正方法が可能です:

テナント全体に対するユーザーの同意を有効にする (すべてのユーザー、すべてのアプリケーション)。

Azure portal で、[Microsoft Entra ID]>[ユーザーとグループ]>[ユーザー設定] の順に移動してください。
[ユーザーはアプリが自身の代わりに会社のデータにアクセスすることを許可できます] 設定を有効にし、変更を保存します。

Azure portal のスクリーンショット。

管理者は、テナント全体または特定のユーザーのいずれかを対象として、アプリケーションへのアクセス許可を付与することができます。

CS1061 エラー

次のエラーが発生した場合は、Microsoft.IdentityModel.Clients.ActiveDirectory をダウンロードしてください。

'AuthenticationContext' does not contain a definition for 'AcquireToken' and no accessible 'AcquireToken' accepting a first argument of type 'AuthenticationContext' could be found (are you missing a using directive or an assembly reference?)

別のテナント (ゲストユーザー) の Microsoft Entra トークン

"組織向けに埋め込む" ときに、Microsoft Entra のゲストユーザーがコンテンツにアクセスできるようにするには、authorityUri パラメータでテナント ID を指定する必要があります。

組織のテナントで認証するための URL:

https://login.microsoftonline.com/common/v2.0
ゲスト Microsoft Entra ユーザーを認証するための URL:

https://login.microsoftonline.com/<tenant ID>

ご自分のテナント ID を見つけるには、「Microsoft Entra テナント ID とプライマリドメイン名を検索する」の手順を使用してください。

詳しくは、「アプリケーションのマルチテナント化」を参照してください。

データソース

ISV が同じデータソースに対して複数の資格情報を求める

データソースには、1 つのマスターユーザーに対して 1 つの資格情報セットを与えることができます。異なる資格情報を使用する必要がある場合は、追加のマスターユーザーを作成します。次に、マスターユーザーのコンテキストごとに異なる資格情報を割り当て、そのユーザーの Microsoft Entra トークンを使用して埋め込みます。

IError オブジェクトによる埋め込みアプリケーションのトラブルシューティング

JavaScript SDK から error イベントによって返される IError オブジェクトを使用して、アプリケーションをデバッグし、エラーの原因に対する理解を深めます。

IError オブジェクトを取得したら、使用している埋め込みの種類に応じた、該当する一般的なエラーのテーブルを確認する必要があります。 IError のプロパティとテーブル内のプロパティを比較し、エラーの考えられる理由を見つけてください。

Power BI ユーザー向けに埋め込む場合に発生する一般的なエラー

メッセージ	詳細なメッセージ	エラーコード	考えられる理由
TokenExpired	Access token has expired, resubmit with a new access token (アクセストークンの期限が切れました。新しいアクセストークンを使用して再送信してください)	403	トークンの有効期限が切れました
PowerBIEntityNotFound	Get report failed (レポートの取得に失敗しました)	404	レポート ID が正しくありませんレポートが存在しません
正しくないパラメーター	powerbiToken parameter not specified (powerbiToken パラメーターが指定されていません)	該当なし	アクセストークンが指定されていませんレポート ID が指定されていません
LoadReportFailed	Fail to initialize - Couldn't resolve cluster (初期化できません - クラスターを解決できませんでした)	403	不正なアクセストークン埋め込みの種類がトークンの種類に一致しません
PowerBINotAuthorizedException	Get report failed (レポートの取得に失敗しました)	401	グループ ID が正しくありません許可されていないグループです
TokenExpired	Access token has expired, resubmit with a new access token. (アクセストークンの期限が切れました。新しいアクセストークンを使用して再送信してください。) Couldn't render a report visual titled: (次のタイトルのレポートのビジュアルを表示できませんでした:) <ビジュアルのタイトル>	該当なし	データのクエリトークンの有効期限が切れました
OpenConnectionError	ビジュアルを表示できません。 Couldn't render a report visual titled: (次のタイトルのレポートのビジュアルを表示できませんでした:) <ビジュアルのタイトル>	該当なし	容量に関連するレポートをセッションで開いているときに容量が一時停止または削除されました
ExplorationContainer_FailedToLoadModel_DefaultDetails	このレポートに関連付けられているモデルスキーマを読み込むことができません。サーバーに接続できることを確認して、もう一度やり直してください。	該当なし	容量が一時停止されました容量が削除されました

Power BI 以外のユーザー向けに埋め込む場合に発生する一般的なエラー (埋め込みトークンを使用)

メッセージ	詳細なメッセージ	エラーコード	理由
TokenExpired	Access token has expired, resubmit with a new access token (アクセストークンの期限が切れました。新しいアクセストークンを使用して再送信してください)	403	トークンの有効期限が切れました
LoadReportFailed	Get report failed (レポートの取得に失敗しました)	404	レポート ID が正しくありませんレポートが存在しません
LoadReportFailed	Get report failed (レポートの取得に失敗しました)	403	レポート ID がトークンに一致しません
LoadReportFailed	Get report failed (レポートの取得に失敗しました)	500	レポートが指定した ID が GUID ではありません
正しくないパラメーター	powerbiToken parameter not specified (powerbiToken パラメーターが指定されていません)	該当なし	アクセストークンが指定されていませんレポート ID が指定されていません
LoadReportFailed	Fail to initialize - Couldn't resolve cluster (初期化できません - クラスターを解決できませんでした)	403	トークンの種類が正しくないか、無効なトークンです
PowerBINotAuthorizedException	Get report failed (レポートの取得に失敗しました)	401	グループ ID が正しくないか、許可されていません
TokenExpired	Access token has expired, resubmit with a new access token. (アクセストークンの期限が切れました。新しいアクセストークンを使用して再送信してください。) Couldn't render a report visual titled: (次のタイトルのレポートのビジュアルを表示できませんでした:) <ビジュアルのタイトル>	該当なし	データのクエリトークンの有効期限が切れました
OpenConnectionError	ビジュアルを表示できません。 Couldn't render a report visual titled: (次のタイトルのレポートのビジュアルを表示できませんでした:) <ビジュアルのタイトル>	該当なし	容量に関連するレポートをセッションで開いているときに容量が一時停止または削除されました
ExplorationContainer_FailedToLoadModel_DefaultDetails	このレポートに関連付けられているモデルスキーマを読み込むことができません。サーバーに接続できることを確認して、もう一度やり直してください。	該当なし	容量が一時停止されました容量が削除されました

レポートの取得が失敗する - エラー 401 - 自動的に解決される

"ユーザー所有データ" シナリオでは、ユーザーが 401 エラーを受け取ることがありますが、これは Power BI ポータルにアクセスした後で自動的に解決されます。 401 エラーが発生する場合は、「ユーザーのアクセス許可を更新する」で説明されているように、アプリに RefreshUserPermissions の呼び出しを追加します。

セマンティックモデル

ユーザーに表示されるデータの一部を管理する

セマンティックモデルに対する読み取りアクセス許可を持つすべてのユーザーには、スキーマ全体 (テーブル、列、メジャー) とすべてのデータが表示されます。同じセマンティックモデル内の生データと集計データに対して、表示アクセス許可を個別に制御することはできません。

ユーザーが表示できるデータの部分を管理するには、次のいずれかの方法を使用します。

Power BI の行レベルのセキュリティ (RLS) を使用した行レベルのフィルター処理。
オブジェクトレベルのセキュリティ (OLS)。
データを異なるセマンティックモデルに分離します。たとえば、集計データのみが含まれるセマンティックモデルを作成し、そのセマンティックモデルのみに対するアクセス権をユーザーに付与することができます。

コンテンツレンダリング

埋め込まれた Power BI 項目 (レポートやダッシュボードなど) でのレンダリングの問題を解決するには、このセクションを確認してください。

Power BI 項目が Power BI サービスに読み込まれたことを確認する

アプリケーション "または埋め込み API" に関する問題を除外するには、Power BI サービス (powerbi.com) で項目を表示できることを確認します。

Power BI 項目が Power BI 埋め込み分析プレイグラウンドに読み込まれたことを確認する

アプリケーションの問題を除外するには、Power BI 埋め込み分析プレイグラウンドで Power BI 項目を表示できることを確認します。

アクセストークンの有効期限が切れていないことを確認する

セキュリティ上の理由から、アクセストークン (Microsoft Entra トークンまたは埋め込みトークン) の有効期間は限られています。アクセストークンを常に監視し、必要に応じて更新する必要があります。詳細については、アクセストークンの更新に関するページをご覧ください。

パフォーマンス

埋め込みコンテンツを最大限に活用するには、Power BI 埋め込み分析のベストプラクティスに従うことをお勧めします。

埋め込みセットアップツール

埋め込みセットアップツールに関するページに移動し、サンプルアプリケーションをすばやくダウンロードすることができます。その後、アプリケーションとサンプルを比較できます。

前提条件

埋め込みセットアップツールを使う前に、適切な前提条件がすべてあることを確認します。 Power BI Pro アカウントと Microsoft Azure サブスクリプションが必要です。

Power BI Pro にサインアップしていない場合は、無料の試用版にサインアップしてください。
Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。
独自の Microsoft Entra テナントセットアップが必要です。
Visual Studio がインストールされている必要があります (バージョン 2013 以降)。

一般的な問題

埋め込みセットアップツールを使ってテストするときに発生する可能性がある一般的な問題は次のとおりです。

顧客サンプルアプリケーションへの埋め込みの使用

顧客向けの埋め込みエクスペリエンスを使用している場合、PowerBI-Developer-Samples.zip ファイルを保存して解凍します。その後、PowerBI-Developer-Samples-master\App Owns Data フォルダーを開き、PowerBIEmbedded_AppOwnsData.sln ファイルを実行します。

[アクセス許可の付与] を選ぶと ([アクセス許可の付与] ステップ)、次のエラーが発生します。

AADSTS70001: Application with identifier <client ID> wasn't found in the directory <directory ID>

解決するには、ポップアップを閉じ、数秒待ってから、もう一度やり直してください。この操作を数回繰り返す必要があるかもしれません。アプリケーション登録プロセス完了から外部 API で使用可能になるまでの時間間隔が問題の原因です。

サンプルアプリを実行すると、次のエラーメッセージが表示されます。

Password is empty. Please fill password of Power BI username in web.config.

このエラーは、サンプルアプリケーションに挿入されていない唯一の値がユーザーパスワードであるために発生します。ソリューションの Web.config ファイルを開き、pbiPassword フィールドにユーザーのパスワードを入力します。

エラーが発生した場合は、次のようにします。

AADSTS50079: The user is required to use multi-factor authentication.

MFA が有効になっていない Microsoft Entra アカウントを使用する必要があります。

組織のサンプルアプリケーションでの埋め込みの使用

組織向けの埋め込みエクスペリエンスを使用している場合、PowerBI-Developer-Samples.zip ファイルを保存して解凍します。 PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app フォルダーを開き、pbi-saas-embed-report.sln ファイルを実行します。

組織向けの埋め込みサンプルアプリを実行すると、次のエラーが発生します。

AADSTS50011: The reply URL specified in the request doesn't match the reply URLs configured for the application: <client ID>

このエラーは、Web サーバーアプリケーションに対して指定されているリダイレクト URL が、サンプルの URL と異なるためです。サンプルアプリケーションを登録する場合は、リダイレクト URL として https://localhost:13526/ を使用します。

登録済みのアプリケーションを編集する場合は、Microsoft Entra 登録済みアプリケーションを更新し、アプリケーションから Web API へのアクセスが提供されるようにします。

Power BI のユーザープロファイルまたはデータを編集する場合は、Power BI データの編集方法を確認してください。

エラーが発生した場合は、次のようにします。

AADSTS50079: The user is required to use multi-factor authentication.

MFA が有効になっていない Microsoft Entra アカウントを使用する必要があります。

詳しくは、「Power BI Embedded に関してよく寄せられる質問」をご覧ください。

追加のサポートが必要な場合は、サポートに問い合わせるか、Azure portal でサポートチケットを作成し、発生したエラーメッセージを指定してください。

Power BI Embedded に関してよく寄せられる質問

他にわからないことがある場合は、 Power BI コミュニティに質問する

埋め込みアプリケーションのトラブルシューティング

トラブルシューティングツール

Fiddler のトレース

ブラウザーで F12 キーを押してフロントエンドデバッグを実行する

Power BI 応答からエラーの詳細を抽出する

アプリの登録

アプリ登録エラー

新しいアプリを登録したとき、Power BI サービスが Azure portal に表示されない

アプリケーションオブジェクト ID とプリンシパルオブジェクト ID の違いは何ですか?

アプリケーションオブジェクト ID

プリンシパルオブジェクト ID

認証

AADSTS70002 または AADSTS50053 で認証が失敗しました

有効な ID が与えられた GenerateToken が失敗する

AADSTS90094: 許可には管理者権限が必要です

CS1061 エラー

別のテナント (ゲストユーザー) の Microsoft Entra トークン

データソース

ISV が同じデータソースに対して複数の資格情報を求める

IError オブジェクトによる埋め込みアプリケーションのトラブルシューティング

Power BI ユーザー向けに埋め込む場合に発生する一般的なエラー

Power BI 以外のユーザー向けに埋め込む場合に発生する一般的なエラー (埋め込みトークンを使用)

レポートの取得が失敗する - エラー 401 - 自動的に解決される

セマンティックモデル

ユーザーに表示されるデータの一部を管理する

コンテンツレンダリング

Power BI 項目が Power BI サービスに読み込まれたことを確認する

Power BI 項目が Power BI 埋め込み分析プレイグラウンドに読み込まれたことを確認する

アクセストークンの有効期限が切れていないことを確認する

パフォーマンス

埋め込みセットアップツール

前提条件

一般的な問題

顧客サンプルアプリケーションへの埋め込みの使用

組織のサンプルアプリケーションでの埋め込みの使用

フィードバック

フィードバック

その他のリソース

埋め込みアプリケーションのトラブルシューティング

トラブルシューティング ツール

Fiddler のトレース

ブラウザーで F12 キーを押してフロントエンド デバッグを実行する

Power BI 応答からエラーの詳細を抽出する

アプリの登録

アプリ登録エラー

新しいアプリを登録したとき、Power BI サービスが Azure portal に表示されない

アプリケーション オブジェクト ID とプリンシパル オブジェクト ID の違いは何ですか?

アプリケーション オブジェクト ID

プリンシパル オブジェクト ID

認証

AADSTS70002 または AADSTS50053 で認証が失敗しました

有効な ID が与えられた GenerateToken が失敗する

AADSTS90094: 許可には管理者権限が必要です

CS1061 エラー

別のテナント (ゲスト ユーザー) の Microsoft Entra トークン

データ ソース

ISV が同じデータ ソースに対して複数の資格情報を求める

IError オブジェクトによる埋め込みアプリケーションのトラブルシューティング

Power BI ユーザー向けに埋め込む場合に発生する一般的なエラー

Power BI 以外のユーザー向けに埋め込む場合に発生する一般的なエラー (埋め込みトークンを使用)

レポートの取得が失敗する - エラー 401 - 自動的に解決される

セマンティック モデル

ユーザーに表示されるデータの一部を管理する

コンテンツ レンダリング

Power BI 項目が Power BI サービスに読み込まれたことを確認する

Power BI 項目が Power BI 埋め込み分析プレイグラウンドに読み込まれたことを確認する

アクセス トークンの有効期限が切れていないことを確認する

パフォーマンス

埋め込みセットアップ ツール

前提条件

一般的な問題

顧客サンプル アプリケーションへの埋め込みの使用

組織のサンプル アプリケーションでの埋め込みの使用

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

トラブルシューティングツール

ブラウザーで F12 キーを押してフロントエンドデバッグを実行する

アプリケーションオブジェクト ID とプリンシパルオブジェクト ID の違いは何ですか?

アプリケーションオブジェクト ID

プリンシパルオブジェクト ID

別のテナント (ゲストユーザー) の Microsoft Entra トークン

データソース

ISV が同じデータソースに対して複数の資格情報を求める

セマンティックモデル

コンテンツレンダリング

アクセストークンの有効期限が切れていないことを確認する

埋め込みセットアップツール

顧客サンプルアプリケーションへの埋め込みの使用

組織のサンプルアプリケーションでの埋め込みの使用