Solución de problemas de autenticación del entorno de desarrollo

En este artículo se proporcionan instrucciones sobre cómo solucionar los problemas detectados al autenticar el SDK de Azure para aplicaciones de Java que se ejecutan localmente en máquinas para desarrolladores, a través de varias implementaciones TokenCredential. Para obtener más información, consulte Autenticación de Azure en entornos de desarrollo de Java.

Solución de problemas de AzureCliCredential

Si usa AzureCliCredential, puede probar o detectar opcionalmente para CredentialUnavailableException. En la tabla siguiente se muestran los errores que indica esta excepción y los métodos de mitigación:

Mensaje de error	Descripción	Mitigación
Azure CLI not installed	La CLI de Azure no está instalada o no se pudo encontrar.	- Asegúrese de que ha instalado correctamente la CLI de Azure. - Valide que la ubicación de instalación se ha agregado a la variable de entorno PATH.
Please run 'az login' to set up account	No hay ninguna cuenta iniciada actualmente en la CLI de Azure o el inicio de sesión ha expirado.	- Inicie sesión en la CLI de Azure con el comando az login. Para obtener más información, consulte Inicio de sesión con la CLI de Azure. - Valide que la CLI de Azure puede obtener tokens. Para obtener más información, consulte la siguiente sección.

Verifique que la CLI de Azure puede obtener tokens

Puede comprobar manualmente que ha autenticado correctamente la CLI de Azure y puede obtener tokens. En primer lugar, use el siguiente comando para comprobar que la cuenta ha iniciado sesión actualmente en la CLI de Azure:

az account show

Después de comprobar que la CLI de Azure usa una cuenta correcta, use el siguiente comando para validar que puede obtener tokens para esta cuenta:

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

Advertencia

La salida de este comando contiene un token de acceso válido. Para evitar poner en peligro la seguridad de la cuenta, no comparta este token de acceso.

Solución de problemas de AzureDeveloperCliCredential

Si usa AzureDeveloperCliCredential, puede probar o detectar opcionalmente para CredentialUnavailableException. En la tabla siguiente se muestran los errores que indica esta excepción y los métodos de mitigación:

Mensaje de error	Descripción	Mitigación
Azure Developer CLI not installed	Azure Developer CLI no está instalado o no se pudo encontrar.	- Asegúrese de que ha instalado correctamente Azure Developer CLI. - Valide que la ubicación de instalación se ha agregado a la variable de entorno PATH.
Please run 'azd auth login' to set up account	No hay ninguna cuenta iniciada actualmente en Azure Developer CLI o el inicio de sesión ha expirado.	- Inicie sesión en Azure Developer CLI con el comando azd auth login. - Valide que Azure Developer CLI puede obtener tokens. Para obtener más información, consulte la siguiente sección.

Verifique que Azure Developer CLI puede obtener tokens

Puede comprobar manualmente que ha autenticado correctamente Azure Developer CLI y puede obtener tokens. En primer lugar, use el siguiente comando para comprobar que la cuenta ha iniciado sesión actualmente en Azure Developer CLI:

azd config list

Después de comprobar que Azure Developer CLI usa una cuenta correcta, puede usar el siguiente comando para validar que puede obtener tokens para esta cuenta:

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

Advertencia

La salida de este comando contiene un token de acceso válido. Para evitar poner en peligro la seguridad de la cuenta, no comparta este token de acceso.

Solución de problemas de AzurePowerShellCredential

Si usa AzurePowerShellCredential, puede probar o detectar opcionalmente para CredentialUnavailableException. En la tabla siguiente se muestran los errores que indica esta excepción y los métodos de mitigación:

Mensaje de error	Descripción	Mitigación
PowerShell isn't installed.	No se encontró ninguna instalación local de PowerShell.	Asegúrese de que ha instalado correctamente PowerShell en la máquina.
Az.Account module >= 2.2.0 isn't installed.	El módulo Az.Account necesario para la autenticación en Azure PowerShell no está instalado.	Instale el módulo Az.Account más reciente. Para más información, vea Procedimiento para instalar Azure PowerShell.
Please run 'Connect-AzAccount' to set up account.	Actualmente no hay ninguna cuenta iniciada en Azure PowerShell.	- Inicie sesión en Azure PowerShell con el comando Connect-AzAccount. Para más información, consulte Inicio de sesión con Azure PowerShell - Valide que Azure PowerShell puede obtener tokens. Para obtener más información, consulte la siguiente sección.

Verifique que Azure PowerShell puede obtener tokens

Puede comprobar manualmente que ha autenticado correctamente Azure PowerShell y puede obtener tokens. En primer lugar, use el siguiente comando para comprobar que la cuenta ha iniciado sesión actualmente en la CLI de Azure:

Get-AzContext

Esto genera una salida similar a la del siguiente ejemplo:

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

Después de comprobar que Azure PowerShell usa una cuenta correcta, puede usar el siguiente comando para validar que puede obtener tokens para esta cuenta.

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

Advertencia

La salida de este comando contiene un token de acceso válido. Para evitar poner en peligro la seguridad de la cuenta, no comparta este token de acceso.

Solución de problemas de VisualStudioCodeCredential

Nota:

Se trata de un problema conocido que VisualStudioCodeCredential no funciona con versiones de extensión de cuenta de Azure más recientes que 0.9.11. Hay una corrección a largo plazo para este problema. Mientras tanto, considere la posibilidad de autenticarse a través de la CLI de Azure.

Si usa VisualStudioCodeCredential, puede probar o detectar opcionalmente para CredentialUnavailableException. En la tabla siguiente se muestran los errores que indica esta excepción y los métodos de mitigación:

Mensaje de error	Descripción	Mitigación
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code	No se encontró información de la cuenta de Azure en la configuración de VS Code.	- Asegúrese de que ha instalado correctamente el complemento de cuenta de Azure. - Use Ver > Paleta de comandos para ejecutar el comando Azure: Iniciar sesión. Este comando abre una ventana del explorador y muestra una página para iniciar sesión en Azure. - Si ya tiene instalada la extensión de cuenta de Azure y ha iniciado sesión en su cuenta, intente cerrar sesión e iniciar sesión de nuevo. Esta acción vuelve a rellenar la memoria caché y mitiga potencialmente el error que recibe.
MSAL Interaction Required Exception	VisualStudioCodeCredential pudo leer las credenciales almacenadas en caché de la memoria caché, pero es probable que el token almacenado en caché haya expirado.	Inicie sesión en la extensión cuenta de Azure a través de Ver > Paleta de comandos para ejecutar el comando Azure: Iniciar sesión en el IDE de VS Code.
ADFS tenant not supported	La autenticación de servicio de Azure de Visual Studio no admite actualmente inquilinos de ADFS.	Use credenciales de una nube admitida al autenticarse con Visual Studio. Para obtener más información sobre las nubes compatibles, consulte Nubes nacionales.

Pasos siguientes

Si la guía de resolución de problemas de este artículo no le ayuda a resolver los problemas al usar bibliotecas cliente de Azure SDK para Java, le recomendamos que deje la incidencia en el repositorio GitHub de Azure SDK para Java.