Solucionar problemas de autenticação do ambiente de desenvolvimento

Este artigo fornece diretrizes sobre como solucionar problemas de autenticação de ambiente de desenvolvimento que você encontra ao autenticar SDK do Azure para aplicativos Java executados localmente em computadores desenvolvedores por meio de várias TokenCredential implementações. Para obter mais informações, consulte Autenticação do Azure em ambientes de desenvolvimento para Java.

Solucionar problemas de AzureCliCredential

Ao usar AzureCliCredential, você pode, opcionalmente, tentar/capturar para CredentialUnavailableException. A tabela a seguir mostra os erros que essa exceção indica e os métodos de mitigação:

Mensagem de erro Descrição Mitigação
Azure CLI not installed A CLI do Azure não está instalada ou não pôde ser encontrada. – Certifique-se de instalar o CLI do Azure.
– Valide se o local de instalação é adicionado à variável de PATH ambiente.
Please run 'az login' to set up account Nenhuma conta está conectada na CLI do Azure no momento, ou a sessão expirou. - Entre no CLI do Azure usando o az login comando. Para obter mais informações, consulte Entrar na CLI do Azure.
- Valide se a CLI do Azure pode obter tokens. Para obter mais informações, consulte a próxima seção.

Verificar se a CLI do Azure pode obter tokens

Você pode verificar manualmente se autenticou o CLI do Azure e pode obter tokens. Primeiro, use o seguinte comando para verificar se a conta está conectada à CLI do Azure:

az account show

Depois de verificar se o CLI do Azure está usando a conta correta, use o seguinte comando para validar se ele é capaz de obter tokens para esta conta:

az account get-access-token \
    --output json \
    --resource https://management.core.windows.net

Aviso

A saída desse comando contém um token de acesso válido. Para evitar comprometer a segurança da conta, não compartilhe esse token de acesso.

Solucionar problemas de AzureDeveloperCliCredential

Ao usar AzureDeveloperCliCredential, você pode, opcionalmente, usar try/catch para CredentialUnavailableException. A tabela a seguir mostra os erros que essa exceção indica e os métodos de mitigação:

Mensagem de erro Descrição Mitigação
Azure Developer CLI not installed A CLI do desenvolvedor do Azure não está instalada ou não pôde ser encontrada. - Certifique-se de instalar a Azure Developer CLI.
– Valide se o local de instalação é adicionado à variável de PATH ambiente.
Please run 'azd auth login' to set up account Nenhuma conta está atualmente conectada à CLI de desenvolvedor do Azure ou a conexão expirou. – Entre na CLI do Desenvolvedor do Azure usando o azd auth login comando.
- Valide se a CLI de desenvolvedor do Azure pode obter tokens. Para obter mais informações, consulte a próxima seção.

Verificar se a CLI de desenvolvedor do Azure pode obter tokens

Você pode verificar manualmente se autenticou corretamente a CLI do desenvolvedor do Azure e pode obter tokens. Primeiro, use o seguinte comando para verificar se a conta está conectada à CLI de desenvolvedor do Azure:

azd config list

Depois de verificar se a CLI do Desenvolvedor do Azure está usando a conta correta, use o seguinte comando para validar se ele é capaz de obter tokens para esta conta:

azd auth token --output json --scope https://management.core.windows.net/.default

Aviso

A saída desse comando contém um token de acesso válido. Para evitar comprometer a segurança da conta, não compartilhe esse token de acesso.

Solucionar problemas de AzurePowerShellCredential

Ao usar AzurePowerShellCredential, você pode opcionalmente, tentar/capturar para CredentialUnavailableException. A tabela a seguir mostra os erros que essa exceção indica e os métodos de mitigação:

Mensagem de erro Descrição Mitigação
PowerShell isn't installed. Nenhuma instalação local do PowerShell foi encontrada. Certifique-se de instalar o PowerShell no computador.
Az.Account module >= 2.2.0 isn't installed. O módulo Az.Account necessário para autenticação no Azure PowerShell não está instalado. Instale o módulo mais recente Az.Account. Para obter mais informações, consulte Como instalar o Azure PowerShell.
Please run 'Connect-AzAccount' to set up account. No momento, nenhuma conta está conectada ao Azure PowerShell. - Entre no Azure PowerShell usando o Connect-AzAccount comando. Para obter mais informações, consulte Entrar com o Azure PowerShell
- Valide se o Azure PowerShell pode obter tokens.

Verifique se Azure PowerShell pode obter tokens

Você pode verificar manualmente se você autenticou Azure PowerShell corretamente e se ele pode obter tokens. Primeiro, use o seguinte comando para verificar se a conta está conectada à CLI do Azure:

Get-AzContext

Esse comando produz uma saída semelhante ao seguinte exemplo:

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Depois de verificar se Azure PowerShell está usando a conta correta, use o comando a seguir para validar se ele pode obter tokens para essa conta.

Get-AzAccessToken -ResourceUrl "https://management.core.windows.net"

Aviso

A saída desse comando contém um token de acesso válido. Para evitar comprometer a segurança da conta, não compartilhe esse token de acesso.

Solucionar problemas de VisualStudioCodeCredential

Observação

É um problema conhecido que VisualStudioCodeCredential não funciona com versões da extensão Azure Account posteriores à 0.9.11. Uma correção de longo prazo para esse problema está em andamento. Enquanto isso, considere se autenticar via a CLI do Azure.

Ao usar VisualStudioCodeCredential, você pode opcionalmente, tentar/capturar para CredentialUnavailableException. A tabela a seguir mostra os erros que essa exceção indica e os métodos de mitigação:

Mensagem de erro Descrição Mitigação
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code Nenhuma informação de conta do Azure foi encontrada na configuração do VS Code. – Verifique se você instalou corretamente o plug-in da conta Azure.
- Use Exibir > na Paleta de Comando para executar o comando: Entrar do Azure. Esse comando abre uma janela do navegador e exibe uma página que você pode usar para entrar no Azure.
- Se você já tiver a extensão Azure Conta instalada e tiver entrado em sua conta, tente sair e entrar novamente. Essa ação preenche novamente o cache e potencialmente atenua o erro que você está recebendo.
MSAL Interaction Required Exception VisualStudioCodeCredential conseguiu ler as credenciais armazenadas em cache do cache, mas o token armazenado em cache provavelmente expirou. Entre na extensão da conta do Azure por meio de Exibir > na Paleta de Comando para executar o comando: Entrar do Azure no IDE do VS Code.
ADFS tenant not supported Atualmente, a Autenticação de Serviço do Azure do Visual Studio não dá suporte a locatários do ADFS. Use credenciais de uma nuvem com suporte ao autenticar com o Visual Studio. Para obter mais informações sobre as nuvens com suporte, consulte Nuvens nacionais.

Próximas etapas

Se as diretrizes de solução de problemas neste artigo não ajudarem a resolver problemas ao usar o SDK do Azure para bibliotecas de cliente Java, registre um problema no SDK do Azure para Java GitHub repositório.