Solucionar problemas de autenticação do ambiente de desenvolvimento

Este artigo fornece orientações para resolver problemas de autenticação em ambientes de desenvolvimento com que se depara ao autenticar aplicações Java que utilizam o SDK do Azure, executadas localmente nas máquinas dos programadores, através de várias implementações de TokenCredential. Para obter mais informações, consulte Autenticação do Azure em ambientes de desenvolvimento Java.

Solucionar problemas do AzureCliCredential

Quando utiliza AzureCliCredential, 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 Atenuação
Azure CLI not installed A CLI do Azure não está instalada ou não pôde ser encontrada. - Certifique-se de instalar a CLI do Azure.
- Validar que a localização de instalação foi adicionada à 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. - Iniciar sessão 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

Pode verificar manualmente que se autentica na CLI do Azure e que consegue obter tokens. Primeiro, use o seguinte comando para verificar se a conta está atualmente conectada à CLI do Azure:

az account show

Depois de verificar que a CLI do Azure está a utilizar a conta correta, use o seguinte comando para validar que consegue obter tokens para esta conta:

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

Advertência

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 utiliza AzureDeveloperCliCredential, 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 Atenuaçã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 que instala a Azure Developer CLI.
- Validar que a localização de instalação foi adicionada à 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. - Iniciar sessão na CLI do Azure Developer 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

Pode verificar manualmente se autenticou corretamente a CLI do Azure Developer e 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 Azure Developer está a usar a conta correta, use o seguinte comando para validar que consegue obter tokens para esta conta:

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

Advertência

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 utiliza AzurePowerShellCredential, 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 Atenuação
PowerShell isn't installed. Nenhuma instalação local do PowerShell foi encontrada. Certifique-se de instalar 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. - Iniciar sessão 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 o Azure PowerShell pode obter tokens

Pode verificar manualmente se se autenticou corretamente no Azure PowerShell e se este consegue 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á a usar a conta correta, use o seguinte comando para validar que consegue obter tokens para essa conta.

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

Advertência

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

Observação

É um problema conhecido que a extensão da VisualStudioCodeCredential não funciona com versões mais recentes que a versã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 utiliza VisualStudioCodeCredential, 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 Atenuaçã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. - Garantir que instalou corretamente o plugin de Conta Azure.
- Utilize View > Command Palette para utilizar o comando Azure: Iniciar sessão. Este comando abre uma janela do navegador e mostra uma página que pode usar para iniciar sessão no Azure.
- Se já tem a extensão da conta Azure instalada e iniciou sessão na sua conta, tente sair 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, mas o token em cache provavelmente expirou. Entre na extensão da Conta do Azure via Paleta de Comandos > para executar o comando Azure: Iniciar Sessão 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 orientações de resolução de problemas neste artigo não ajudarem a resolver os problemas ao utilizar as bibliotecas de cliente do SDK do Azure para Java, submeta um problema no repositório do GitHub do SDK do Azure para Java.