Solucionar problemas de autenticação do ambiente de desenvolvimento

Este artigo fornece orientação sobre como lidar com problemas encontrados ao autenticar o SDK do Azure para aplicativos Java executados localmente em máquinas de desenvolvedores, por meio de várias TokenCredential implementações. Para obter mais informações, consulte Autenticação do Azure em ambientes de desenvolvimento Java.

Solucionar problemas do AzureCliCredential

Quando você usa AzureCliCredentialo , 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:

Error message	Description	Mitigação
Azure CLI not installed	A CLI do Azure não está instalada ou não pôde ser encontrada.	- Certifique-se de que instalou corretamente a CLI do Azure. - Valide se o local de instalação foi adicionado à PATH variável de ambiente.
Please run 'az login' to set up account	Nenhuma conta está atualmente conectada à CLI do Azure ou a entrada expirou.	- Entre na CLI do Azure usando o az login comando. Para obter mais informações, consulte Entrar com a CLI do Azure. - Valide se a CLI do Azure pode obter tokens. Para obter mais informações, consulte a próxima seção.

Verifique se a CLI do Azure pode obter tokens

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

az account show

Depois de verificar se a CLI do Azure está usando a conta correta, use o seguinte comando para validar se ela pode obter tokens para essa conta:

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

Aviso

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

Solucionar problemas do AzureDeveloperCliCredential

Quando você usa AzureDeveloperCliCredentialo , 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:

Error message	Description	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 ter instalado corretamente a CLI do Azure Developer. - Valide se o local de instalação foi adicionado à PATH variável de ambiente.
Please run 'azd auth login' to set up account	Nenhuma conta está atualmente conectada à CLI do Desenvolvedor do Azure ou a entrada expirou.	- Entre na CLI do Desenvolvedor do Azure usando o azd auth login comando. - Valide se a CLI do Desenvolvedor do Azure pode obter tokens. Para obter mais informações, consulte a próxima seção.

Verifique se a CLI do 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á atualmente conectada à CLI do Desenvolvedor do Azure:

azd config list

Depois de verificar se a CLI do Desenvolvedor do Azure está usando a conta correta, você pode usar o seguinte comando para validar se ela pode obter tokens para essa conta:

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

Aviso

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

Solucionar problemas do AzurePowerShellCredential

Quando você usa AzurePowerShellCredentialo , 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:

Error message	Description	Mitigação
PowerShell isn't installed.	Nenhuma instalação local do PowerShell foi encontrada.	Verifique se você instalou corretamente o PowerShell na máquina.
Az.Account module >= 2.2.0 isn't installed.	O Az.Account módulo 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.	Nenhuma conta está atualmente 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. Para obter mais informações, consulte a próxima seção.

Verifique se o Azure PowerShell pode obter tokens

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

Get-AzContext

Este comando produz uma saída semelhante ao exemplo a seguir:

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

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

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

Aviso

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

Solucionar problemas do VisualStudioCodeCredential

Nota

É um problema conhecido que não funciona com versões de extensão de Conta do Azure mais recentes que 0.9.11VisualStudioCodeCredential o . Uma solução de longo prazo para este problema está em andamento. Enquanto isso, considere a autenticação por meio da CLI do Azure.

Quando você usa VisualStudioCodeCredentialo , 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:

Error message	Description	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.	- Certifique-se de que instalou corretamente o plug-in da Conta do Azure. - Use View > Command Palette para executar o comando Azure: Entrar . Este comando abre uma janela do navegador e exibe uma página que permite entrar no Azure. - Se já tiver a extensão da Conta do Azure instalada e tiver iniciado sessão na sua conta, tente terminar sessão e iniciar sessão novamente. Essa ação preenche novamente o cache e potencialmente atenua o erro que você está recebendo.
MSAL Interaction Required Exception	VisualStudioCodeCredential foi capaz de 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 da Paleta de Comandos de Exibição > para executar o comando Azure: Entrar no IDE do VS Code.
ADFS tenant not supported	Atualmente, a Autenticação de Serviço do Azure do Visual Studio não oferece 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 suportadas, consulte Nuvens nacionais.

Próximos passos

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