Dépannage de l'authentification de l'environnement de développement

Cet article fournit des conseils pour traiter les problèmes rencontrés lors de l'authentification des applications Azure SDK for Java exécutées localement sur les machines des développeurs, par le biais de diverses implémentations TokenCredential. Pour plus d'informations, voir Authentification Azure dans les environnements de développement Java.

Dépannage de AzureCliCredential

Lorsque vous utilisez AzureCliCredential, vous pouvez éventuellement essayer/attraper pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique, ainsi que les méthodes d'atténuation :

Message d’erreur	Description	Limitation des risques
Azure CLI not installed	L'Azure CLI n'est pas installé ou n'a pas pu être trouvé.	- Vérifiez que vous avez correctement installé Azure CLI. – Validez que l'emplacement de l'installation a été ajouté à la variable d'environnement PATH
Please run 'az login' to set up account	Aucun compte n'est actuellement connecté à l'Azure CLI ou la connexion a expiré.	– Connectez-vous à la CLI d'Azure à l'aide de la commande az login. Pour plus d’informations, consultez Se connecter avec Azure CLI. - Vérifiez que l'Azure CLI peut obtenir des jetons. Pour plus d'informations, voir la section suivante.

Vérifiez que l'Azure CLI peut obtenir des jetons.

Vous pouvez vérifier manuellement que vous avez correctement authentifié l'Azure CLI et que vous pouvez obtenir des jetons. Tout d'abord, utilisez la commande suivante pour vérifier que le compte est actuellement connecté à l'Azure CLI :

az account show

Après avoir vérifié que l'Azure CLI utilise le bon compte, utilisez la commande suivante pour valider qu'elle est en mesure d'obtenir des jetons pour ce compte :

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

Avertissement

La sortie de cette commande contient un jeton d'accès valide. Pour éviter de compromettre la sécurité du compte, ne partagez pas ce jeton d'accès.

Dépannage de AzureDeveloperCliCredential

Lorsque vous utilisez AzureDeveloperCliCredential, vous pouvez optionnellement essayer/attraper pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique, ainsi que les méthodes d'atténuation :

Message d’erreur	Description	Limitation des risques
Azure Developer CLI not installed	L'Azure Developer CLI n'est pas installé ou n'a pas pu être trouvé.	- Vérifiez que vous avez correctement installé Azure Developer CLI. – Validez que l'emplacement de l'installation a été ajouté à la variable d'environnement PATH
Please run 'azd auth login' to set up account	Aucun compte n'est actuellement connecté à l'interface de programmation pour le développement Azure, ou la connexion a expiré.	- Connectez-vous à la CLI de Azure Developer à l'aide de la commande azd auth login. - Vérifiez que l'interface de programmation pour le développement Azure peut obtenir des jetons. Pour plus d'informations, voir la section suivante.

Vérifiez que l'interface de programmation pour le développement Azure peut obtenir des jetons.

Vous pouvez vérifier manuellement que vous avez correctement authentifié l'interface de programmation pour le développement Azure et que vous pouvez obtenir des jetons. Tout d'abord, utilisez la commande suivante pour vérifier que le compte est actuellement connecté à l'Azure Developer CLI :

azd config list

Après avoir vérifié que l'Azure Developer CLI utilise le bon compte, vous pouvez utiliser la commande suivante pour valider qu'il est capable d'obtenir des jetons pour ce compte :

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

Avertissement

La sortie de cette commande contient un jeton d'accès valide. Pour éviter de compromettre la sécurité du compte, ne partagez pas ce jeton d'accès.

Dépannage de AzurePowerShellCredential

Lorsque vous utilisez AzurePowerShellCredential, vous pouvez éventuellement essayer/attraper pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique, ainsi que les méthodes d'atténuation :

Message d’erreur	Description	Limitation des risques
PowerShell isn't installed.	Aucune installation locale de PowerShell n'a été trouvée.	Assurez-vous que vous avez correctement installé PowerShell sur la machine.
Az.Account module >= 2.2.0 isn't installed.	Le module Az.Account nécessaire à l'authentification dans Azure PowerShell n'est pas installé.	Installez le dernier module Az.Account. Pour plus d’informations, consultez Comment installer Azure PowerShell.
Please run 'Connect-AzAccount' to set up account.	Aucun compte n'est actuellement connecté à Azure PowerShell.	- Connectez-vous à Azure PowerShell à l'aide de la commande Connect-AzAccount. Pour plus d’informations, consultez Se connecter avec Azure PowerShell - Vérifiez qu'Azure PowerShell peut obtenir des jetons. Pour plus d'informations, voir la section suivante.

Vérifiez qu'Azure PowerShell peut obtenir des jetons.

Vous pouvez vérifier manuellement que vous avez correctement authentifié Azure PowerShell et que vous pouvez obtenir des jetons. Tout d'abord, utilisez la commande suivante pour vérifier que le compte est actuellement connecté à l'Azure CLI :

Get-AzContext

Cette commande produit une sortie semblable à celle de l’exemple suivant :

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

Après avoir vérifié qu'Azure PowerShell utilise le bon compte, vous pouvez utiliser la commande suivante pour valider qu'il est capable d'obtenir des jetons pour ce compte.

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

Avertissement

La sortie de cette commande contient un jeton d'accès valide. Pour éviter de compromettre la sécurité du compte, ne partagez pas ce jeton d'accès.

Dépannage de VisualStudioCodeCredential

Remarque

C'est un problème connu que VisualStudioCodeCredential ne fonctionne pas avec les versions d'extension de compte Azure plus récentes que 0.9.11 Une correction à long terme de ce problème est en cours. En attendant, envisagez de vous authentifier via l'Azure CLI.

Lorsque vous utilisez VisualStudioCodeCredential, vous pouvez optionnellement essayer/attraper pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique, ainsi que les méthodes d'atténuation :

Message d’erreur	Description	Limitation des risques
Failed To Read VS Code Credentials</p></p>OR</p>Authenticate via Azure Tools plugin in VS Code	Aucune information sur le compte Azure n'a été trouvée dans la configuration de VS Code.	- Assurez-vous que vous avez correctement installé le plug-in Compte Azure. - Utilisez Affichage > Palette de commandes pour exécuter la commande Azure: Sign In. Cette commande ouvre une fenêtre de navigateur et affiche une page de connexion à Azure. - Si l'extension Compte Azure est déjà installée et que vous vous êtes connecté à votre compte, essayez de vous déconnecter et de vous reconnecter. Cette action permet de repeupler le cache et d'atténuer potentiellement l'erreur que vous obtenez.
MSAL Interaction Required Exception	VisualStudioCodeCredential a pu lire les informations d'identification mises en cache, mais le jeton mis en cache a probablement expiré.	Connectez-vous à l'extension du compte Azure via Affichage > Palette de commandes pour exécuter la commande Azure : Sign In dans l'IDE VS Code.
ADFS tenant not supported	Visual Studio Azure Service Authentication ne prend pas actuellement en charge les locataires ADFS.	Utilisez les informations d'identification d'un cloud pris en charge lorsque vous vous authentifiez avec Visual Studio. Pour plus d'informations sur les clouds pris en charge, consultez Nuages nationaux.

Étapes suivantes

Si les conseils de dépannage de cet article ne permettent pas de résoudre les problèmes liés à l'utilisation des bibliothèques clientes Azure SDK for Java, nous vous recommandons de déposer un problème dans le référentiel GitHub Azure SDK for Java.