Résoudre les problèmes d’authentification de l’environnement de développement

Cet article fournit des conseils sur la gestion des problèmes rencontrés lors de l’authentification du Kit de développement logiciel (SDK) Azure pour les applications Java exécutées localement sur des machines de développement, via différentes TokenCredential implémentations. Pour plus d’informations, consultez l’authentification Azure dans les environnements de développement Java.

Résoudre les problèmes liés à AzureCliCredential

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

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

Vérifiez que l’interface de ligne de commande Azure peut obtenir des jetons

Vous pouvez vérifier manuellement que vous avez correctement authentifié 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é à Azure CLI :

az account show

Une fois que vous avez vérifié qu’Azure CLI utilise un compte correct, utilisez la commande suivante pour vérifier 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é des comptes, ne partagez pas ce jeton d’accès.

Résoudre les problèmes liés à AzureDeveloperCliCredential

Lorsque vous utilisez AzureDeveloperCliCredential, vous pouvez éventuellement essayer/intercepter pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique et les méthodes d’atténuation :

Message d’erreur	Description	Limitation des risques
Azure Developer CLI not installed	Azure Developer CLI n’est pas installé ou introuvable.	- Vérifiez que vous avez correctement installé Azure Developer CLI. - Vérifiez que l’emplacement d’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 CLI du développeur Azure, ou la connexion a expiré.	- Connectez-vous à Azure Developer CLI à l’aide de la azd auth login commande. - Vérifiez que l’interface CLI du développeur Azure peut obtenir des jetons. Pour plus d’informations, consultez la section suivante.

Vérifiez que l’interface CLI du développeur Azure peut obtenir des jetons

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

azd config list

Une fois que vous avez vérifié qu’Azure Developer CLI utilise un compte correct, vous pouvez utiliser la commande suivante pour vérifier qu’elle est en mesure 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é des comptes, ne partagez pas ce jeton d’accès.

Résoudre les problèmes liés à AzurePowerShellCredential

Lorsque vous utilisez AzurePowerShellCredential, vous pouvez éventuellement essayer/intercepter pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique et 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.	Vérifiez que vous avez correctement installé PowerShell sur l’ordinateur.
Az.Account module >= 2.2.0 isn't installed.	Le Az.Account module nécessaire pour l’authentification dans Azure PowerShell n’est pas installé.	Installez le dernier Az.Account module. 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 Connect-AzAccount commande. Pour plus d’informations, consultez Se connecter avec Azure PowerShell - Vérifiez qu’Azure PowerShell peut obtenir des jetons. Pour plus d’informations, consultez la section suivante.

Vérifier qu’Azure PowerShell peut obtenir des jetons

Vous pouvez vérifier manuellement que vous avez correctement authentifié Azure PowerShell et obtenir des jetons. Tout d’abord, utilisez la commande suivante pour vérifier que le compte est actuellement connecté à 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...

Une fois que vous avez vérifié qu’Azure PowerShell utilise un compte correct, vous pouvez utiliser la commande suivante pour vérifier qu’il est en mesure 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é des comptes, ne partagez pas ce jeton d’accès.

Résoudre les problèmes de VisualStudioCodeCredential

Remarque

Il s’agit d’un problème connu qui VisualStudioCodeCredential ne fonctionne pas avec les versions d’extension de compte Azure plus récentes que 0.9.11. Une solution à long terme à ce problème est en cours. En attendant, envisagez d’authentifier via Azure CLI.

Lorsque vous utilisez VisualStudioCodeCredential, vous pouvez éventuellement essayer/intercepter pour CredentialUnavailableException. Le tableau suivant présente les erreurs que cette exception indique et 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 de compte Azure n’a été trouvée dans la configuration de VS Code.	- Vérifiez que vous avez correctement installé le plug-in compte Azure. - Utilisez la palette de commandes View > pour exécuter la commande Azure : Connexion. Cette commande ouvre une fenêtre de navigateur et affiche une page de connexion à Azure. - Si vous avez déjà installé l’extension de compte Azure et que vous êtes connecté à votre compte, essayez de vous déconnecter et de vous reconnecter. Cette action remplit le cache et atténue potentiellement l’erreur que vous obtenez.
MSAL Interaction Required Exception	VisualStudioCodeCredential a pu lire les informations d’identification mises en cache à partir du cache, mais le jeton mis en cache a probablement expiré.	Connectez-vous à l’extension de compte Azure par le biais de la palette de commandes View > pour exécuter la commande Azure : Connexion dans l’IDE VS Code.
ADFS tenant not supported	Visual Studio Azure Service Authentication ne prend actuellement pas en charge les locataires ADFS.	Utilisez les informations d’identification d’un cloud pris en charge lors de l’authentification auprès de Visual Studio. Pour plus d’informations sur les clouds pris en charge, consultez Clouds nationaux.

Étapes suivantes

Si les conseils de dépannage de cet article n’aident pas à résoudre les problèmes lorsque vous utilisez le Kit de développement logiciel (SDK) Azure pour les bibliothèques clientes Java, nous vous recommandons de déposer un problème dans le référentiel Azure SDK pour Java GitHub.