Résoudre les problèmes de connexion à un projet

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Si vous rencontrez des problèmes de connexion à un projet dans Azure DevOps, cet article fournit des conseils de dépannage pas à pas pour résoudre les problèmes courants de connectivité et d’authentification.

Conditions préalables

Étapes de résolution rapide

Si vous rencontrez des problèmes de connexion, essayez d’abord ces étapes rapides :

1. Effacez complètement votre navigateur : déconnectez-vous à l’aide de l’option https://aka.ms/VsSignout, puis désactivez tous les cookies (Ctrl+Maj+Suppr).
2. Utilisez une session de navigateur privée : ouvrez une fenêtre incognito ou InPrivate et testez l’accès.
3. Vérifier l’URL de l’organisation : vérifiez que vous utilisez le format d’URL correct : https://dev.azure.com/{organizationName}.
4. Vérifiez le type de votre compte : vérifiez que vous vous connectez avec le type de compte approprié (ID Microsoft Entra et compte Microsoft personnel).

Si ces étapes ne résolvent pas le problème, poursuivez avec les sections de résolution détaillées suivantes.

Résoudre les erreurs d’authentification

Azure DevOps prend en charge les comptes Microsoft Entra et les comptes personnels Microsoft pour l’authentification. Les organisations connectées à l’ID Microsoft Entra nécessitent l’authentification Microsoft Entra (compte invité membre ou B2B).

401 - Erreurs non autorisées

L’erreur 401 Non autorisée est le problème de connexion le plus courant. Cette erreur se produit lorsque votre identité ne dispose pas des autorisations nécessaires pour accéder à l’organisation ou à des ressources spécifiques. Les causes courantes sont les suivantes :

• Identité non ajoutée à l’organisation : votre compte n’est pas répertorié dans l’annuaire utilisateur de l’organisation.
• Confusion d’alias et d’UPN : tentative de connexion avec un alias au lieu de votre nom d’utilisateur principal (UPN).
• Autorisations de projet insuffisantes : absence d’autorisations de lecture sur le projet ou la ressource cible.
• Invitation d’invité B2B en attente : L'invitation d'invité Microsoft Entra B2B n'a pas été acceptée.
• Incompatibilité de type de compte : tentative de connexion avec le type de compte incorrect lorsque plusieurs comptes partagent la même adresse e-mail.

Identité non présente dans l'organisation

Étapes de résolution :

1. Contactez votre administrateur Azure DevOps pour vérifier que votre identité apparaît dans la liste Utilisateurs de l’organisation.
2. Pour les comptes Microsoft Entra : vérifiez que l’identité dans la liste des utilisateurs correspond exactement à votre UPN dans le client Microsoft Entra.
3. Pour les comptes Microsoft personnels : confirmez que l’identité correspond à votre adresse e-mail de compte principal.
4. Pour les utilisateurs B2B : vérifiez que votre UPN dans le client invité correspond à l’UPN de votre client principal, y compris la casse exacte.

Problèmes de connexion d’UPN et d’alias

Azure DevOps ne prend pas en charge les alias de connexion. Vous devez utiliser votre nom d’utilisateur principal exact (UPN) pour les comptes Microsoft Entra ou le compte principal pour les comptes Microsoft personnels.

Exemple: Si votre UPN est john.doe@contoso.com mais que vous avez un alias jdoe@contoso.com, vous devez vous connecter à l’aide john.doe@contoso.comde .

Résolution: Demandez à votre administrateur d’ajouter votre UPN réel (john.doe@contoso.com) à l’organisation et d’utiliser toujours cet UPN pour la connexion.

Autorisations insuffisantes

Vous disposez peut-être d’un accès à l’organisation, mais vous ne disposez pas d’autorisations pour des projets ou des ressources spécifiques.

Symptômes :

• Peut accéder à https://dev.azure.com/{orgName}, mais pas à https://dev.azure.com/{orgName}/{projectName}.
• Recevez des erreurs 401 lors de l’accès à des éléments de travail, référentiels ou pipelines spécifiques.

Résolution: Contactez votre administrateur Azure DevOps pour vérifier que vous disposez au moins d’autorisations de lecture pour la ressource cible.

Problèmes liés aux invitations pour les invités B2B

Les invités B2B doivent accepter leur invitation de locataire Microsoft Entra avant d’accéder à Azure DevOps.

Étapes de résolution pour les invités :

1. Vérifiez votre e-mail pour l’invitation Microsoft Entra.
2. Sélectionnez le lien d’invitation et terminez le processus d’acceptation.
3. Essayez de vous reconnecter à Azure DevOps.

Étapes de résolution pour les administrateurs de locataires :

1. Accédez à https://portal.azure.com.
2. Sélectionnez Microsoft Entra ID>Utilisateurs.
3. Recherchez l’utilisateur invité et vérifiez sa page Vue d’ensemble .
4. Si l’état de l’invitation B2B affiche « Acceptation en attente », utilisez Renvoyer l'invitation.

Conflits de type de compte

Les organisations non connectées à Microsoft Entra ID prennent en charge les comptes Microsoft personnels et les comptes Microsoft Entra. Le premier type de compte que vous utilisez établit définitivement votre identité.

Résolution: Si vous devez modifier les types de comptes :

1. Demandez à votre administrateur de vous supprimer puis de vous réintégrer dans l'organisation.
2. Connectez-vous avec votre type de compte préféré lorsque vous y êtes invité.

Résoudre les problèmes de connectivité

Problèmes liés au navigateur

Déconnexion et nettoyage complets :

1. Déconnectez-vous complètement : Accédez à https://aka.ms/VsSignout.
2. Effacer toutes les données du navigateur : sélectionnez Ctrl+Maj+Supprimer et supprimer :
   • Cookies et données de site.
   • Images et fichiers mis en cache.
   • Remplissage automatique des données de formulaire.
3. Effacer les données Microsoft Edge : l’IDE Visual Studio utilise les cookies Microsoft Edge. Effacez donc les données Microsoft Edge même si vous utilisez un autre navigateur.
4. Fermez toutes les applications : quittez tous les navigateurs et les instances d’IDE Visual Studio.
5. Test avec navigation privée : utilisez une fenêtre incognito ou InPrivate pour tester l’accès.

Problèmes de connexion à l’IDE Visual Studio

Si vous rencontrez des problèmes de connexion dans Visual Studio :

1. Supprimer les connexions existantes : dans Team Explorer, supprimez toutes les connexions Azure DevOps.
2. Effacer le cache des informations d’identification : supprimez les informations d’identification mises en cache du Gestionnaire d’informations d’identification Windows.
3. Redémarrez Visual Studio : fermez et rouvrez complètement Visual Studio.
4. Connexions lues : ajoutez à nouveau votre connexion Azure DevOps à l’aide des informations d’identification actuelles.

Problèmes réseau et proxy

Résolution des problèmes de réseau d’entreprise :

1. Test à partir d’un autre réseau : essayez d’accéder à Azure DevOps à partir d’un appareil/réseau personnel.
2. Vérifier les paramètres du proxy : vérifiez que le proxy d’entreprise autorise *.visualstudio.com et *.azure.com les domaines.
3. Configuration du pare-feu : assurez-vous que le pare-feu autorise le trafic HTTPS vers les points de terminaison Azure DevOps.
4. Interférence VPN : testez avec VPN désactivé le cas échéant.

Dépannage avancé

Migration de l’authentification moderne

Si vous utilisez des méthodes d’authentification héritées, envisagez de migrer vers des alternatives modernes :

• Jetons d’accès personnels (PAT) : Migrez vers des applications Microsoft Entra OAuth.
• Nom d’utilisateur/mot de passe : Basculez vers des identités de service ou des identités gérées.
• Jetons hérités : implémentez l’authentification Microsoft Entra pour une meilleure sécurité.

Authentification de connexion de service

Pour les connexions de service Azure DevOps qui rencontrent des problèmes d’authentification :

1. Actualiser les secrets du principal de service : Mettez à jour les secrets client ou certificats expirés.
2. Vérifier les autorisations : vérifiez que les principaux de service disposent des autorisations Azure DevOps appropriées.
3. Vérifier l’expiration du jeton : vérifiez que les jetons d’authentification n’ont pas expiré.
4. Passez en revue les journaux d’audit : vérifiez les journaux d’audit Microsoft Entra pour les échecs d’authentification.

Utiliser l’IA pour résoudre les problèmes de connexion

L’exemple d’invite suivant pour Copilot Chat aide Copilot à résoudre vos erreurs de connexion et d’authentification. Copiez et collez cette invite dans Copilot Chat, en remplaçant l’espace réservé par votre message d’erreur ou description du problème spécifique.

I'm getting this Azure DevOps connection/authentication error: [PASTE YOUR ERROR MESSAGE HERE]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the connection problem
2. Fix the authentication or access issue
3. Verify I can successfully connect to my Azure DevOps project

Context: This is for connecting to an Azure DevOps organization and project. I've already tried basic troubleshooting like clearing browser cache and using a private browser session.

Copilot est alimenté par l’IA, donc les surprises et les erreurs sont possibles. Pour plus d’informations, consultez les FAQ sur l’utilisation générale de Copilot.

Obtenir d’autres aides

Lorsque vous effectuez toutes les étapes de résolution des problèmes et que vous ne pouvez toujours pas vous connecter :

1. Collecter les informations de diagnostic : créez une trace de navigateur de votre tentative de connexion ayant échoué.
2. Contactez le support Microsoft : créez une demande de support et incluez :
   • Description détaillée du problème.
   • Étapes que vous avez déjà tentées.
   • Fichiers de trace du navigateur.
   • Captures d’écran des messages d’erreur.
3. Support de la communauté : recherchez ou publiez des questions sur la communauté des développeurs Azure DevOps.

Contenu connexe

• Aide sur l’authentification Azure DevOps
• Authentification Microsoft Entra pour Azure DevOps
• Résoudre les problèmes d’accès et d’autorisation
• Capturer les traces du navigateur pour la résolution des problèmes