Partager via


Authentification CLI multiplateforme pour Azure DevOps

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

Cet article explique les approches d’authentification pour l’interface CLI multiplateforme (tfx-cli) et Azure DevOps.

Important

Nous vous recommandons d’utiliser l’authentification Microsoft Entra ID comme méthode principale pour l’authentification. Les jetons d’accès personnels (PAT) doivent être utilisés uniquement lorsque l’authentification d’ID Microsoft Entra n’est pas disponible. L’authentification de base est déconseillée et non recommandée.

Conditions préalables

Avant de commencer, vérifiez que vous disposez des points suivants :

  • Node.js (dernière version LTS recommandée)

  • tfx-cli installé globalement :

    npm install -g tfx-cli
    

Pour plus d’informations sur tfx-cli, consultez l’interface CLI Node pour Azure DevOps sur GitHub.

Méthodes d’authentification

Choisissez la méthode d’authentification appropriée en fonction de votre environnement :

Méthode Recommandé pour
Microsoft Entra ID (système d'identification de Microsoft) Azure DevOps Services
Jeton d’accès personnel Azure DevOps Server, scripts d’automatisation
Authentification de base Serveur Azure DevOps uniquement

Pour Azure DevOps Services, utilisez l’authentification Microsoft Entra ID pour la meilleure sécurité :

tfx login

Lorsque vous y êtes invité :

  1. Entrez votre URL de service, par exemple https://dev.azure.com/Your_Organization.
  2. Suivez le flux d’authentification basé sur le navigateur.
  3. Terminez le processus de connexion dans votre navigateur.

Pour obtenir des instructions détaillées sur l’authentification Microsoft Entra ID, consultez l’authentification Basée sur Microsoft Entra.

Authentification PAT

Utilisez des paT lorsque l’authentification d’ID Microsoft Entra n’est pas disponible, par exemple avec Azure DevOps Server.

Créer et utiliser un Token d'Accès Personnel

  1. Créez un PAT avec les étendues requises.

  2. Connectez-vous à l’aide du protocole PAT :

    tfx login
    
  3. Lorsque vous y êtes invité, indiquez :

    • URL du service : URL de votre instance Azure DevOps.
    • Jeton d’accès personnel : le PAT que vous avez créé.

Exemples d’URL :

  • Azure DevOps Services : https://dev.azure.com/Your_Organization
  • Serveur Azure DevOps : https://yourserver/tfs/DefaultCollection
  • Visual Studio Marketplace : https://marketplace.visualstudio.com

Exemple de session :

~$ tfx login
Copyright Microsoft Corporation

> Service URL: https://dev.azure.com/Your_Organization
> Personal access token: **********************
Logged in successfully

Authentification de base (déconseillée)

Avertissement

L’authentification de base est déconseillée et non recommandée. Utilisez plutôt l’ID Microsoft Entra. Authentification de base :

  • Envoie des informations d’identification en texte clair
  • Peut provoquer des problèmes liés aux opérations de ligne de commande Git
  • Pose des risques de sécurité

Configurer l’authentification de base (Azure DevOps Server uniquement)

Si vous devez utiliser l’authentification de base avec les installations d’Azure DevOps Server :

  1. Activer l’authentification de base IIS :

    • Ouvrez le Gestionnaire de serveurs.
    • Installez la fonctionnalité d’authentification de base pour IIS.
    • Dans le Gestionnaire IIS, accédez à votre site web Azure DevOps Server.
    • Double-sélectionnez Authentification dans la vue Fonctionnalités.
    • Activer l’authentification de base.
    • Laissez les paramètres de domaine et de réseau vides.
  2. Connectez-vous avec l’authentification de base :

    tfx login --auth-type basic
    
  3. Lorsque vous y êtes invité, indiquez :

    • URL du service : URL de votre serveur local (par exemple, http://yourserver:8080/tfs/DefaultCollection).
    • Nom d’utilisateur : Utiliser domain\username le format (par exemple, fabrikam\john)
    • Mot de passe : votre mot de passe de domaine.

Conseil / Astuce

Envisagez de configurer SSL pour la communication sécurisée lors de l’utilisation de l’authentification de base.

Étape suivante