次の方法で共有

Azure Digital Twins の既知の問題

この記事では、Azure Digital Twins に関連する既知の問題について説明します。

Azure Digital Twins Explorer はプライベート エンドポイントをサポートしていません

問題の説明: Azure Digital Twins Explorer では、 プライベート リンク を使用してパブリック アクセスを無効にする Azure Digital Twins インスタンスで使用しようとすると、エラーが表示されます。 [モデルのフェッチ中にエラーが発生しました] というポップアップが表示される場合があります。

これは私に影響しますか? 原因 解決策
プライベート エンドポイント/Private Link で Azure Digital Twins を使用している場合、Azure Digital Twins Explorer でインスタンスを表示しようとすると、この問題が影響を受けます。 Azure Digital Twins Explorer では、プライベート エンドポイントのサポートは提供されていません。 独自のバージョンの Azure Digital Twins Explorer コードベースをクラウドにプライベートにデプロイできます。 これを行う方法については、「 Azure Digital Twins Explorer: クラウドでの実行」を参照してください。 または、代わりに API と SDK を 使用して Azure Digital Twins インスタンスを管理することもできます。

Cloud Shell の "400 クライアント エラー: 無効な要求"

問題の説明:https://shell.azure.comで実行されている Cloud Shell のコマンドは、"400 Client Error: Bad Request for url: http://localhost:50342/oauth2/token" というエラーで断続的に失敗し、その後に完全なスタック トレースが続く場合があります。

これは私に影響しますか? 原因 解決策
Azure Digital Twins では、この問題は次のコマンド グループに影響します。

az dt route

az dt model

az dt twin		 これは、Cloud Shell の既知の問題の結果です。 Cloud Shell からトークンを取得すると、400 クライアント エラー: 無効な要求で断続的に失敗します。

Azure Digital Twins インスタンスの認証トークンと Cloud Shell の既定の マネージド ID ベースの認証に問題があります。

Cloud Shell のマネージド ID 認証に問題がない異なる種類の認証トークン (Azure Resource Manager に基づく) を使用するため、 az dt または az dt endpoint コマンド グループからの Azure Digital Twins コマンドには影響しません。		 この問題を解決する 1 つの方法は、Cloud Shell で az login コマンドを再実行し、次のログイン手順を完了することです。 このアクションにより、マネージド ID 認証からセッションが切り替わり、根本問題が回避されます。 その後、コマンドを再実行できます。

それ以外の場合は、Azure portal で Cloud Shell ペインを開き、そこから Cloud Shell の作業を完了できます。
Azure portal アイコン バーの Cloud Shell アイコンのスクリーンショット。

最後に、Azure CLI コマンドを ローカルで実行できるように、マシンに Azure CLI をインストールする方法もあります。 ローカル CLI では、この問題は発生しません。

Azure.Identity 1.2.0 での対話型ブラウザー認証に関する問題

問題の説明:Azure.Identity ライブラリのバージョン 1.2.0 を使用して Azure Digital Twins アプリケーションで認証コードを記述すると、InteractiveBrowserCredential メソッドに問題が発生する可能性があります。 この問題は、ブラウザー ウィンドウで認証しようとすると、"Azure.Identity.AuthenticationFailedException" のエラー応答として発生します。 ブラウザー ウィンドウが完全に起動しないか、ユーザーを正常に認証しているように見えますが、クライアント アプリケーションはエラーで失敗します。

これは私に影響しますか? 原因 解決策
影響を受けるメソッドは、次の記事で使用されます。

クライアント アプリをコーディングする

アプリ認証コードを記述する

Azure Digital Twins API と SDK		 一部のユーザーは、 Azure.Identity ライブラリのバージョン 1.2.0 でこの問題を抱えていました。 解決するには、 新しいバージョン の Azure.Identityを使用するようにアプリケーションを更新します。 ライブラリのバージョンを更新した後、ブラウザーは期待どおりに読み込んで認証する必要があります。

Azure.Identity 1.3.0 での既定の Azure 資格情報認証に関する問題

問題の説明:Azure.Identity ライブラリのバージョン 1.3.0 を使用して認証コードを記述する場合、一部のユーザーは、これらの Azure Digital Twins ドキュメント全体の多くのサンプルで使用される DefaultAzureCredential メソッドに関する問題を経験しています。この問題は、コードが認証を試みたときに"Azure.Identity.AuthenticationFailedException: SharedTokenCacheCredential 認証が失敗しました" というエラー応答として発生します。

これは私に影響しますか? 原因 解決策
DefaultAzureCredential は、認証を含むこのサービスのほとんどのドキュメント例で使用されます。 DefaultAzureCredential ライブラリのバージョン 1.3.0 でAzure.Identityを使用して認証コードを記述していて、このエラー メッセージが表示される場合は、この問題が影響を受けます。 Azure.Identity ライブラリとその認証クラスDefaultAzureCredentialに関する構成の問題が発生している可能性があります。 このクラスは、順番に試行されるいくつかの資格情報の種類を含むラッパーです。 この問題は、認証フローが SharedTokenCacheCredential の種類に達したときに発生する可能性があります。 これを解決する方法の 1 つは、現在SharedTokenCacheCredentialに対して開かれている DefaultAzureCredential の問題で説明されているように、資格情報からAzure.Identityを除外することです。 次の省略可能なパラメーターを使用してSharedTokenCacheCredential クラスをインスタンス化することで、資格情報からDefaultAzureCredentialを除外できます。new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });
もう 1 つのオプションは、Azure.Identity などの以前のバージョンのを使用するようにアプリケーションを変更することです。 以前のバージョンを使用しても、Azure Digital Twins に機能的な影響はありません。これにより、受け入れ可能なソリューションになります。

「az dt」コマンドは、古い「azure-iot」拡張機能では失敗します。

問題の説明:az dt コマンド セットの CLI コマンドは、バージョン 2.70.0 以降の Azure CLI と共に、0.26.0 (0.26.0 は許容可能) より前のバージョンの azure-iot 拡張機能を使用している場合は失敗します。 エラー メッセージは AttributeError で終わります 。'CredentialAdaptor' オブジェクトには属性 'signed_session' がありません。

これは私に影響しますか? 原因 解決策
この問題は、バージョン 2.70.0 以降の Azure CLI と、0.26.0 より前のバージョンにある az dt 拡張機能のバージョンを使用している場合に、azure-iotコマンドを実行する機能に影響します。 az version コマンドを使用して CLI のバージョンを確認し、azure-iot コマンドを使用してaz extension show拡張機能のバージョンを確認できます。 Azure CLI のバージョン 2.70.0 以降で azure-iot コマンドを実行するには、az dt CLI 拡張機能のバージョン 0.26.0 以降が必要です。 az extension update コマンドを使用して、azure-iot拡張機能を最新バージョンに更新します。

次のステップ

Azure Digital Twins のセキュリティとアクセス許可の詳細を確認します。