Configuration de la connexion au service Azure DevOps

Vous pouvez utiliser la connexion au service dans les pipelines Azure pour vous connecter aux services UiPath Orchestrator afin de pouvoir exécuter des tâches d'automatisation.

Pour plus d'informations, consultez Gérer les connexions au service.

Considérations

Avant de commencer à configurer la connexion au service UiPath Orchestrator, tenez compte des points suivants :

• Si vous exécutez Orchestrator dans vos locaux, vous pouvez utiliser la méthode d'authentification de base.
• Pour les versions Cloud d'Orchestrator (SaaS), vous pouvez utiliser la méthode d'authentification externe pour enregistrer le plug-in dans Automation Cloud™ ou Automation Suite.
• Si votre instance Orchestrator est déployée dans Microsoft Azure Marketplace (PaaS), vous devez accéder aux informations Orchestrator et Identity Server. Pour plus d'informations, consultez Déploiement d'Azure Marketplace.

Configuration de la connexion au service UiPath Orchestrator

Pour ajouter Orchestrator à Azure DevOps, vous devez ajouter et configurer une connexion au service, comme suit :

1. Ouvrez votre projet Azure DevOps (par exemple, https://yourCompany.visualstudio.com/yourProject).

2. Accédez à Paramètres du projet (Project Settings) > Connexions au service (Service connections).

3. Cliquez sur Nouvelle connexion au service (New service connection) et utilisez la fonction de recherche pour trouver Connexion UiPath Orchestrator Connection (UiPath Orchestrator Connection).

4. Cliquez sur Suivant (Next) et choisissez une méthode d'authentification.

5. Passez à l'une des méthodes d'authentification, puis revenez pour poursuivre la configuration.

6. Configurez les paramètres de connexion au service suivants :

   • Nom et description de la connexion au service : saisissez un nom pour votre connexion au service et ajoutez une description facultative.
   • Accorder l'autorisation d'accès à tous les pipelines (Grant access permission to all pipelines) : sélectionnez cette option pour accorder des autorisations pour les pipelines au niveau des projets.

Configuration de l'authentification

Cette section décrit les méthodes d'authentification que vous pouvez utiliser, selon le scénario de déploiement d'Orchestrator.

Déploiement d'Orchestrator	Méthodes d'authentification SQL
MSI	Authentification de base Authentification de l’application externe
Automation Suite	Authentification de base Authentification de l’application externe Authentification basée sur jeton
Automation Cloud	Authentification de base Authentification de l’application externe Authentification basée sur jeton

Remarque :

La méthode recommandée utilise l' authentification d'application externe.

Authentification de base

Vous pouvez utiliser cette méthode si votre instance Orchestrator s'exécute dans vos locaux. Configurez les paramètres suivants pour cette méthode d'authentification :

• URL Orchestrator (Orchestrator URL) : ajoutez l'URL publique d'Orchestrator à laquelle Identity Server se connecte (par exemple, https://orchestrator.yourDomain.local).
• Nom d'utilisateur (Username) et Mot de passe (Password) : saisissez votre nom d'utilisateur et votre mot de passe Orchestrator. Si vous utilisez l'authentification fédérée dans votre organisation, vous devez ajouter le nom d'utilisateur comme suit : yourDomain\yourUsername.
• Locataire (Tenant) : ajoutez votre locataire enregistré.

Après avoir défini les paramètres d'authentification de base, revenez à Configuration de la connexion au service UiPath Orchestrator pour terminer la configuration de la connexion au service.

Authentification basée sur jeton

Pour l'authentification basée sur jeton, configurez les paramètres suivants :

• URL Orchestrator (Orchestrator URL) : ajoutez l'URL publique d'Orchestrator à laquelle Identity Server se connecte (par exemple, https://orchestrator.yourDomain.local).
• Nom du compte (Account Name) : ajoutez l'URL unique de votre organisation.
• Clé API: vous pouvez trouver la clé API dans Automation Cloud™ ou Automation Suite, sous Locataires > Accès à l’API. Pour plus d'informations, consultez Affichage des informations d'accès à l'API.
• Locataire (Tenant) : ajoutez votre locataire enregistré.

Après avoir défini les paramètres d'authentification basée sur jeton, revenez à Configuration de la connexion au service UiPath Orchestrator pour terminer la configuration de la connexion au service.

Authentification externe

Vous pouvez utiliser cette méthode si votre instance Orchestrator s'exécute dans le Cloud ou via Automation Suite. Pour cette méthode d'authentification, vous devez configurer une application externe et fournir des étendues dans Automation Cloud™ ou Automation Suite.

1. Connectez-vous à Automation Cloud™ ou Automation Suite en tant qu’administrateur et accédez à Admin > Applications externes.

2. Cliquez sur Add Application (Ajouter une application) et configurez les paramètres suivants :

   • Nom de l'application (Application Name) : saisissez un nom pour votre application.
   • Type d'application (Application Type) : définissez cette valeur sur Confidentielle (Confidential).
   • Ressources (Resources) : configurez les étendues d'application suivants :

3. Cliquez sur Ajouter des étendues (Add Scopes).

4. Sélectionnez Accès à l'API Orchestrator en tant que ressource.

5. Sélectionnez les étendues suivantes :

   • OR.Folders
   • OR.BackgroundTasks
   • OR.TestSets
   • OR.TestSetExecutions
   • OR.TestSetSchedules
   • OR.Settings.Read
   • OR.Robots.Read
   • OR.Machines.Read
   • OR.Execution OR.Assets
   • OR.Users.Read
   • OR.Jobs
   • OR.Monitoring

Vous pouvez utiliser ce bloc de code pour copier la liste des étendues d'application :

OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring

6. Cliquez sur Enregistrer (Save).

   • URL de redirection (Redirect URL) : vous pouvez laisser ce champ vide.

7. Cliquez sur Ajouter (Add) pour enregistrer l'application.

   Important :

   • Un ID d'application et une clé secrète sont générés à la fin. Conservez ces informations dans un endroit sûr et à portée de main pour une utilisation ultérieure.
   • Si vous générez et utilisez une nouvelle clé secrète, l'ancienne sera invalidée.

   Pour plus d’informations, consultez Ajouter une application externe dans Automation Cloud™ ou Gestion d’applications externes dans Automation Suite.

Après avoir terminé l'enregistrement de l'application externe dans Automation Cloud™ ou Automation Suite, vous pouvez configurer les paramètres suivants :

• URL Orchestrator (Orchestrator URL) : ajoutez l'URL publique d'Orchestrator à laquelle Identity Server se connecte (par exemple, https://orchestrator.yourDomain.local).
• URL d'identité (Identity URL) (uniquement pour Orchestrator déployé sur Azure Marketplace) : ajoutez l'URL Identity Server. Vous pouvez la trouver dans la section Vue d'ensemble (Overview) de votre service d'application.

Remarque :

Pour les Cloud Orchestrator, le champ URL d’identité doit être laissé vide.

• Nom du compte (Account Name) : ajoutez l'URL unique de votre organisation. Ceci est facultatif si Orchestrator est déployé sur Azure Marketplace.
• ID et Clé secrète de l'application (Application Secret) : ajoutez l'ID et la clé secrète de l'application générés via l'enregistrement de l'application externe.
• Étendues d'application (Application Scopes) : ajoutez les étendues que vous avez enregistrées en tant que ressources pour l'application externe.
• Locataire (Tenant) : ceci est facultatif si Orchestrator est déployé sur Azure Marketplace.

Après avoir défini les paramètres d'application externe, revenez à Configuration de la connexion au service UiPath Orchestrator pour terminer la configuration de la connexion au service.