Azure Digital Twins 已知問題
本文提供與 Azure Digital Twins 相關聯之已知問題的相關信息。
Azure Digital Twins Explorer 不支援私人端點
問題描述： Azure Digital Twins Explorer 在嘗試搭配使用 Private Link 停用公用存取的 Azure Digital Twins 實例時顯示錯誤。 您可能會看到顯示「擷取模型時發生錯誤」的彈出視窗 。
| 這會影響我嗎？ | 原因 | 解決方案 |
|---|---|---|
| 如果您使用 Azure Digital Twins 搭配私人端點/Private Link，當您嘗試在 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 用戶端錯誤：URL 不正確的要求： http://localhost:50342/oauth2/token」，後面接著完整堆棧追蹤。
| 這會影響我嗎？ | 原因 | 解決方案 |
|---|---|---|
在 Azure Digital Twins 中，此問題會影響下列命令群組：az dt routeaz dt modelaz dt twin |
這是 Cloud Shell 中已知問題的結果： 從 Cloud Shell 取得令牌間歇性失敗，並出現 400 用戶端錯誤：不正確的要求。 它會產生 Azure Digital Twins 實例驗證令牌和 Cloud Shell 預設 受控識別 型驗證的問題。 這不會影響 或 az dt endpoint 命令群組中的 az dt Azure Digital Twins 命令，因為它們會使用不同類型的驗證令牌（根據 Azure Resource Manager），而 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 Digital Twins 應用程式中撰寫驗證程式代碼時，您可能會遇到 InteractiveBrowserCredential 方法的問題。 當嘗試在瀏覽器視窗中進行驗證時，此問題會顯示為 “Azure.Identity.AuthenticationFailedException” 的錯誤回應。 瀏覽器視窗可能無法完全啟動，或顯示成功驗證使用者，而用戶端應用程式仍然失敗並出現錯誤。
| 這會影響我嗎？ | 原因 | 解決方案 |
|---|---|---|
| 受影響的方法會用於下列文章： 撰寫用戶端應用程式的程序代碼 撰寫應用程式驗證程序代碼 Azure Digital Twins API 和 SDK |
有些使用者有此問題，且版本為1.2.0 Azure.Identity 的連結庫。 |
若要解決，請將您的應用程式更新為使用 更新版本的 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 的連結庫撰寫驗證程式代碼，並看到此錯誤訊息，此問題會影響您。 |
這可能是連結庫和DefaultAzureCredential的驗證類別發生某些組態問題Azure.Identity的結果。 這個類別是包裝函式，其中包含數種依序嘗試的認證類型。 當驗證流程到達 SharedTokenCacheCredential 類型時，可能會發生此問題。 |
若要解決此問題，其中一個策略是從您的認證中排除SharedTokenCacheCredential，如目前針對 Azure.Identity開啟的這個 DefaultAzureCredential 問題中所述。 您可以使用下列選擇性參數具現化 類別，DefaultAzureCredential以排除SharedTokenCacheCredential您的認證：new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });另一個選項是將您的應用程式變更為使用舊版 Azure.Identity，例如 1.2.3版。 使用舊版對 Azure Digital Twins 沒有任何功能影響，這使其成為公認的解決方案。 |
下一步
深入瞭解 Azure Digital Twins 的安全性和許可權：