Configuration des connexions au service

Vous pouvez utiliser la connexion de service dans Azure Pipelines pour vous connecter aux services UiPath Orchestrator afin de pouvoir exécuter des tâches d'automatisation. Pour plus d'informations, consultez [Manage service connections](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/service-endpoints?view=azure-devops&tabs=yaml).

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.

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 à l'étape 6 dans Configuration de la connexion au service UiPath Orchestrator (Configuring UiPath Orchestrator service connection) 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 ( API Key) : vous pouvez trouver la clé API dans Automation Cloud™ ou Automation Suite, sous Locataires (Tenants) > Accès à l'API (API Access). 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 à l'étape 6 dans Configuration de la connexion au service UiPath Orchestrator pour terminer la configuration de la connexion au service.

Application 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 (External Applications).
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 :

1. Cliquez sur Ajouter des étendues (Add Scopes).
2. Sélectionnez Accès à l'API Orchestrator (Orchestrator API Access) en tant que ressource.

3. Sélectionnez les étendues suivantes :

   • OU.Dossiers
   • OU.TâchesArrière-plan
   • OR.TestSets
   • OR.TestSetExecutions
   • OU.TestSetSchedules
   • OR.Settings.Read
   • OU.Robots.Read
   • OU.Machines.Lecture
   • OU.Exécution
   • OU.Assets
   • OU.Users.Read
   • OU.Job

   • 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

4. Cliquez sur Enregistrer (Save).

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

5. 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.
• 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 à l'étape 6 dans Configuration de la connexion au service UiPath Orchestrator pour terminer la configuration de la connexion au service.