Partilhar via


Problemas conhecidos dos Gêmeos Digitais do Azure

Este artigo fornece informações sobre problemas conhecidos associados aos Gêmeos Digitais do Azure.

O Azure Digital Twins Explorer não suporta pontos de extremidade privados

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

Isso me afeta? Motivo Resolução
Se estiver a usar o Azure Digital Twins com um ponto de extremidade privado/Ligação Privada, este problema irá afetá-lo ao tentar visualizar a sua instância no Explorador do Azure Digital Twins. O Azure Digital Twins Explorer não oferece suporte a endpoints 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, consulte Azure Digital Twins Explorer: Running in the cloud. Como alternativa, você pode gerenciar sua instância do Azure Digital Twins usando as APIs e SDKs .

Erro do Cliente 400: Pedido Inválido no Cloud Shell

Descrição do problema: Comandos no Cloud Shell em execução em https://shell.azure.com podem falhar intermitentemente com o erro "400 Client Error: Bad Request for url: http://localhost:50342/oauth2/token", seguido de um rastreio completo da pilha.

Isso me afeta? Motivo Resolução
Nos Gêmeos Digitais do Azure, esse problema afeta os seguintes grupos de comandos:

az dt route

az dt model

az dt twin
É o resultado de um problema conhecido no Cloud Shell: a obtenção de token do Cloud Shell falha intermitentemente com 400 Client Error: Bad Request.

Ele apresenta um problema com os tokens de autenticação de instância do Azure Digital Twins e a autenticação baseada em identidade gerenciada padrão do Cloud Shell.

Isso não afeta os comandos do Azure Digital Twins dos grupos de comando az dt ou az dt endpoint, porque eles usam um tipo diferente de token de autenticação (baseado no Gerenciador de Recursos do Azure), que não tem problema com a autenticação de identidade gerida do Cloud Shell.
Uma maneira de resolver esse problema é executar novamente o az login comando no Cloud Shell e concluir as etapas de login a seguir. Essa ação mudará sua sessão para fora da autenticação de identidade gerenciada, o que evita o problema raiz. Depois, você pode executar novamente o comando.

Caso contrário, você pode abrir o painel Cloud Shell no portal do Azure e concluir seu trabalho do Cloud Shell a partir daí.
Captura de ecrã do ícone do Cloud Shell na barra de ícones do portal do Azure.

Finalmente, outra solução é instalar a CLI do Azure em sua máquina para que você possa executar comandos da CLI do Azure 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: Ao escrever código de autenticação em seus aplicativos do Azure Digital Twins usando a versão 1.2.0 da biblioteca Azure.Identity , você pode enfrentar problemas com o método InteractiveBrowserCredential . Esse problema se apresenta como uma resposta de erro de "Azure.Identity.AuthenticationFailedException" ao tentar autenticar em uma janela do navegador. A janela do navegador pode não iniciar completamente ou pode parecer autenticar o utilizador com sucesso, enquanto a aplicação cliente ainda falha com o erro.

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

Codifique um aplicativo cliente

Escrever código de autenticação de aplicativo

APIs e SDKs do Azure Digital Twins
Alguns usuários tiveram esse problema com a versão 1.2.0 da Azure.Identity biblioteca. Para resolver, atualize seus aplicativos para usar uma versão posterior do Azure.Identity. Depois de atualizar a versão da biblioteca, o navegador deve carregar e autenticar conforme o esperado.

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

Descrição do problema: Ao escrever código de autenticação usando a versão 1.3.0 da biblioteca Azure.Identity , alguns usuários tiveram problemas com o método DefaultAzureCredential usado em muitos exemplos nesses documentos do Azure Digital Twins. Esse problema se apresenta como uma resposta de erro de "Azure.Identity.AuthenticationFailedException: SharedTokenCacheCredential authentication failed" quando o código tenta autenticar.

Isso me afeta? Motivo Resolução
DefaultAzureCredential é usado na maioria dos exemplos de documentação para este serviço que incluem autenticação. Se estiver a escrever código de autenticação utilizando DefaultAzureCredential com a versão 1.3.0 da biblioteca e vir esta mensagem de erro, este problema afeta-o. É provavelmente um resultado de algum problema de configuração com a biblioteca Azure.Identity e DefaultAzureCredential, a sua classe de autenticação. Esta classe é um invólucro que contém vários tipos de credenciais que são testados em ordem. O problema pode ocorrer quando o fluxo de autenticação atinge o SharedTokenCacheCredential tipo. Uma estratégia para resolver isso é excluir SharedTokenCacheCredential de sua credencial, conforme descrito neste problema DefaultAzureCredential que está atualmente aberto contra Azure.Identity. Você pode excluir SharedTokenCacheCredential de sua credencial instanciando a DefaultAzureCredential classe usando o seguinte parâmetro opcional: new DefaultAzureCredential(new DefaultAzureCredentialOptions { ExcludeSharedTokenCacheCredential = true });
Outra opção é alterar seu aplicativo para usar uma versão anterior do Azure.Identity, como a versão 1.2.3. Usar uma versão anterior não tem impacto funcional nos Gêmeos Digitais do Azure, o que o torna uma solução aceita.

Os comandos az dt falham com a antiga extensão Azure-IoT

Descrição do problema: Os comandos da CLI do az dt conjunto de comandos falham se você estiver usando uma versão anterior da extensão que 0.26.0 azure-iot (0.26.0 é aceitável) juntamente com a versão 2.70.0 ou posterior da CLI do Azure. A mensagem de erro termina em AttributeError: O objeto 'CredentialAdaptor' não tem nenhum atributo 'signed_session'.

Isso me afeta? Motivo Resolução
Esse problema afeta sua capacidade de executar az dt comandos se você estiver usando uma CLI do Azure que esteja na versão 2.70.0 ou posterior e uma versão da azure-iot extensão que esteja em uma versão anterior à 0.26.0. Você pode verificar sua versão da CLI com o az version comando e sua azure-iot versão de extensão com o az extension show comando. A versão 0.26.0 ou posterior da azure-iot extensão CLI é necessária para executar az dt comandos na versão 2.70.0 ou posterior da CLI do Azure. Use o az extension update comando para atualizar a azure-iot extensão para a versão mais recente.

Próximos passos

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