你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure 数字孪生已知问题

项目
04/26/2024

可在本文了解与 Azure 数字孪生相关的已知问题。

Azure Digital Twins Explorer 不支持专用终结点

问题描述：尝试将 Azure Digital Twins Explorer 与使用专用链接禁用公共访问的 Azure 数字孪生实例一起使用时，Azure Digital Twins Explorer 会显示错误。你可能会看到一个弹出窗口，显示“提取模型时出错”。

这是否会影响我？	原因	解决方法
如果将 Azure 数字孪生与专用终结点/专用链接配合使用，则尝试在 Azure Digital Twins Explorer 中查看实例时会受到此问题的影响。	Azure Digital Twins Explorer 不支持专用终结点。	但是，你可以在云中私下部署专属版本的 Azure Digital Twins Explorer 代码库。有关如何执行此操作的说明，请参阅 Azure Digital Twins Explorer：在云中运行。也可改为使用 API 和 SDK 来管理 Azure 数字孪生实例。

Cloud Shell 中的“400 客户端错误: 错误请求”

问题描述：在 https://shell.azure.com 运行的 Cloud Shell 中的命令可能会间歇性失败，并出现错误“400 客户端错误: 对 URL http://localhost:50342/oauth2/token 的请求错误”，后面接完整的堆栈跟踪。

这是否会影响我？	原因	解决方法
在 Azure 数字孪生中，此问题会影响以下命令组： `az dt route` `az dt model` `az dt twin`	这是 Cloud Shell 中的一个已知问题导致的：从 Cloud Shell 获取令牌时会间歇性失败，出现“400 客户端错误: 错误请求”。这会影响 Azure 数字孪生实例身份验证令牌和 Cloud Shell 默认的基于托管标识的身份验证。这不会影响来自 `az dt` 或 `az dt endpoint` 命令组的 Azure 数字孪生命令，原因是它们使用不同类型的身份验证令牌（基于 Azure 资源管理器），这不会对 Cloud Shell 的托管标识身份验证造成问题。	解决此问题的一种方法是在 Cloud Shell 中重新运行 `az login` 命令并完成后续登录步骤。该操作将使会话脱离托管标识身份验证，从而避免了根本问题。之后就能重新运行该命令。或者，你可在 Azure 门户中打开 Cloud Shell 窗格，在这里完成 Cloud Shell 工作。最后，还有一种解决方案是在计算机上安装 Azure CLI，以便可在本地运行 Azure CLI 命令。本地 CLI 不会遇到此问题。

Azure.Identity 1.2.0 上的交互式浏览器身份验证存在问题

问题描述：使用 Azure.Identity 库的 1.2.0 版本在 Azure 数字孪生应用程序中编写验证码时，可能会遇到与 InteractiveBrowserCredential 方法相关的问题。当尝试在浏览器窗口中进行身份验证时，此问题将显示为错误响应“Azure.Identity.AuthenticationFailedException”。浏览器窗口可能无法完全启动，或者貌似对用户的身份验证已成功，但客户端应用程序仍然失败并出现错误。

这是否会影响我？	原因	解决方法
以下文章中使用了受影响的方法：为客户端应用编写代码编写应用身份验证码 Azure 数字孪生 API 和 SDK	某些用户在 `Azure.Identity` 库的 1.2.0 版本中遇到了此问题。	若要解决它，请更新应用程序以使用 `Azure.Identity` 的更高版本。更新库版本后，浏览器应会按预期方式进行加载和身份验证。

Azure.Identity 1.3.0 上的默认 Azure 凭据身份验证出现问题

问题描述：当使用 Azure.Identity 库的 1.3.0 版本编写验证码时，某些用户在这些 Azure 数字孪生文档的许多示例中遇到了与 DefaultAzureCredential 方法相关的问题。当代码尝试进行身份验证时，此问题将显示为错误响应“Azure.Identity.AuthenticationFailedException: SharedTokenCacheCredential 身份验证失败”。

这是否会影响我？	原因	解决方法
此服务包含身份验证的大多数文档示例中都使用了 `DefaultAzureCredential`。如果使用 `DefaultAzureCredential` 和 1.3.0 版的 `Azure.Identity` 库编写验证码，并看到此错误消息，那么此问题会影响你。	这可能是由于 `Azure.Identity` 库及其身份验证类 `DefaultAzureCredential` 的某些配置问题造成的。此类是一个包装器，其中包含按顺序尝试的几种凭证类型。当身份验证流到达 `SharedTokenCacheCredential` 类型时，可能会发生此问题。	解决此问题的一种策略是从凭证中排除 `SharedTokenCacheCredential`，如 `Azure.Identity` 出现的当前待解决的 DefaultAzureCredential 问题中所述。可以通过使用以下可选参数实例化 `DefaultAzureCredential` 类从凭证中排除 `SharedTokenCacheCredential`：`new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });` 还有一种方法是更改应用程序以使用更低版本的 `Azure.Identity`，例如版本 1.2.3。使用早期版本对 Azure 数字孪生没有功能上的影响，因此也是公认的解决方案。

后续步骤

阅读有关 Azure 数字孪生的安全性和权限的详细信息：

Azure 数字孪生解决方案的安全性

通过