Compartilhar via


Problemas conhecidos dos Gêmeos Digitais do Azure

Este artigo apresenta informações sobre os problemas conhecidos dos Gêmeos Digitais do Azure.

O Azure Digital Twins Explorer não dá suporte a pontos de extremidade privados

Descrição do problema: o Azure Digital Twins Explorer mostra erros ao tentar usá-lo com uma instância dos Gêmeos Digitais do Azure que usa o Link Privado para desabilitar o acesso público. Você pode ver um pop-up que diz Erro ao buscar modelos.

Isso me afeta? Causa Solução
Se você estiver usando os Gêmeos Digitais do Azure com um ponto de extremidade privado/Link Privado, esse problema afetará você ao tentar exibir sua instância no Azure Digital Twins Explorer. O Azure Digital Twins Explorer não oferece suporte para pontos de extremidade privados. Você pode implantar sua própria versão da base de código do Azure Digital Twins Explorer de forma privada na nuvem. Para obter instruções sobre como fazer isso, confira o Azure Digital Twins Explorer: em execução na nuvem. Como alternativa, você pode gerenciar sua instância dos Gêmeos Digitais do Azure usando as APIs e os SDKs.

"Erro de cliente 400: solicitação inadequada" no Cloud Shell

Descrição do problema: comandos do Cloud Shell em execução em https://shell.azure.com podem falhar intermitentemente com o erro "Erro de cliente 400: solicitação inadequada para URL: http://localhost:50342/oauth2/token", seguido por rastreamento de pilha completo.

Isso me afeta? Causa Solução
Nos Gêmeos Digitais do Azure, este problema afeta os seguintes grupos de comandos:

az dt route

az dt model

az dt twin
Isso é resultado de um problema conhecido no Cloud Shell: Falha ao obter token do Cloud Shell de maneira intermitente com erro de cliente 400: solicitação incorreta.

Isso é um problema com os tokens de autenticação de instâncias dos Gêmeos Digitais do Azure e a autenticação padrão baseada em identidade gerenciada do Cloud Shell.

Isso não afeta os comandos dos Gêmeos Digitais do Azure dos grupos az dt ou az dt endpoint, pois eles usam outro tipo de token de autenticação (com base no Azure Resource Manager), que não tem conflito com a autenticação de identidade gerenciada do Cloud Shell.
Uma forma de resolver esse problema é executar novamente o comando az login no Cloud Shell e seguir as etapas de logon subsequentes. Com esta ação, sua sessão deixará de usar a autenticação de identidade gerenciada, o que evita o problema raiz. Posteriormente, você poderá executar novamente o comando.

Caso contrário, você pode abrir o painel do Cloud Shell no portal do Azure e realizar seu trabalho nele.
Captura de tela do ícone do Cloud Shell na barra de ícones do portal do Azure.

Por fim, outra solução é instalar a CLI do Azure no computador para executar os comandos dela localmente. A CLI local não enfrenta esse problema.

Problema com a autenticação interativa do navegador no Azure.Identity 1.2.0

Descrição do problema: quando você cria código de autenticação em aplicativos dos Gêmeos Digitais do Azure usando a versão 1.2.0 da biblioteca Azure.Identity, podem surgir problemas relacionados ao método InteractiveBrowserCredential. Este problema apresenta, como um erro, a mensagem "Azure.Identity.AuthenticationFailedException" quando você tenta se autenticar em uma janela de navegador. Talvez a janela do navegador não seja iniciada ou pareça ter autenticado o usuário, enquanto o aplicativo cliente ainda apresenta o erro.

Isso me afeta? Causa Solução
O método afetado é usado nos seguintes artigos:

Codificar um aplicativo cliente

Escrever código de autenticação do aplicativo

APIs e SDKs dos Gêmeos Digitais do Azure
Alguns usuários tiveram esse problema com a versão 1.2.0 da biblioteca Azure.Identity. Para resolver, atualize seus aplicativos para usar uma versão posterior do Azure.Identity. Depois da atualização da versão da biblioteca, o navegador deve carregar e autenticar conforme o esperado.

Problema com a autenticação de credencial do Azure padrão no Azure.Identity 1.3.0

Descrição do problema: ao escrever o código de autenticação usando a versão 1.3.0 da biblioteca Azure.Identity, alguns usuários enfrentaram problemas com o método DefaultAzureCredential usado em muitos exemplos em todos esses documentos dos Gêmeos Digitais do Azure. Esse problema apresenta uma resposta de erro de "Azure.Identity.AuthenticationFailedException: falha na autenticação de SharedTokenCacheCredential" quando o código tenta se autenticar.

Isso me afeta? Causa Solução
DefaultAzureCredential é usado na maioria dos exemplos da documentação do serviço que incluem autenticação. Se você está criando código de autenticação usando o DefaultAzureCredential com a versão 1.3.0 da biblioteca Azure.Identity e viu essa mensagem de erro, esse problema afeta você. É provável que seja resultado de algum problema de configuração com a biblioteca Azure.Identity e DefaultAzureCredential, a classe de autenticação correspondente. Essa classe é um wrapper que contém vários tipos de credenciais que são tentadas na ordem. O problema pode ocorrer quando o fluxo de autenticação atinge o tipo SharedTokenCacheCredential. Uma estratégia para resolver isso é excluir o SharedTokenCacheCredential da credencial, conforme descrito neste problema do DefaultAzureCredential que está aberto no momento em relação ao Azure.Identity. Você pode excluir SharedTokenCacheCredential de sua credencial instanciando a classe DefaultAzureCredential usando o seguinte parâmetro opcional: new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });
Outra opção é alterar o aplicativo para usar uma versão anterior do Azure.Identity, como a versão 1.2.3. O uso de uma versão anterior não tem impacto funcional nos Gêmeos Digitais do Azure, o que a torna uma solução aceita.

Próximas etapas

Leia mais sobre segurança e permissões nos Gêmeos Digitais do Azure: