Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo fornece diretrizes sobre como lidar com problemas encontrados ao autenticar o SDK do Azure para aplicativos Java em execução localmente em computadores de desenvolvedor, por meio de várias implementações TokenCredential. Para obter mais informações, consulte Autenticação do Azure em ambientes de desenvolvimento 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 que você instalou corretamente a CLI do Azure. - Valide se o local de instalação foi adicionado à variável de ambiente PATH. |
Please run 'az login' to set up account |
Nenhuma conta está conectada à CLI do Azure no momento ou a entrada expirou. | - Entre na CLI do Azure usando o comando az login. 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. |
Verificar se a CLI do Azure pode obter tokens
Você pode verificar manualmente se autenticou corretamente a 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 a CLI do Azure está usando a conta correta, use o seguinte comando para validar se ela é capaz de obter tokens para essa 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 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 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 você instalou corretamente a CLI do desenvolvedor do Azure. - Valide se o local de instalação foi adicionado à variável de ambiente PATH. |
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 de desenvolvedor do Azure usando o comando azd auth login. - 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 de 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 de desenvolvedor do Azure está usando a conta correta, você pode usar o seguinte comando para validar se ela é capaz de obter tokens para essa 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 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 |
|---|---|---|
PowerShell isn't installed. |
Nenhuma instalação local do PowerShell foi encontrada. | Verifique se você instalou corretamente 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, veja 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 comando Connect-AzAccount. Para saber mais, confira Entrar com o Azure PowerShell - Valide se o Azure PowerShell pode obter tokens. Para obter mais informações, consulte a próxima seção. |
Verificar se o Azure PowerShell pode obter tokens
Você pode verificar manualmente se autenticou corretamente o Azure PowerShell e se 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 o Azure PowerShell está usando a conta correta, você pode usar o seguinte comando para validar se ele é capaz de 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 as versões da extensão da Conta do Azure mais recentes que 0.9.11. Uma correção de longo prazo para esse problema está em andamento. Enquanto isso, considere a autenticação por meio da CLI do Azure.
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 |
|---|---|---|
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 do 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 permite que você entre no Azure. - Se você já tiver a extensão da Conta do Azure 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 suportadas, consulte Nuvens nacionais. |
Próximas etapas
Se as diretrizes de solução de problemas neste artigo não ajudarem a resolver problemas ao usar as bibliotecas de cliente do SDK do Azure para Java, recomendamos que você registre um problema no repositório GitHub do SDK do Azure para Java.