Connexion des Robots à Orchestrator

Cet article explique comment choisir la méthode de connexion du Robot à Orchestrator en fonction du mécanisme d'authentification du Robot défini dans Orchestrator. UiPath fournit plusieurs méthodes d'authentification de Robot, allant de l'authentification par jeton à expiration à l'authentification avec des jetons sans limite d'expiration.

Les trois mécanismes d'authentification disponibles sont obtenus grâce aux deux paramètres de locataire Orchestrator situés sur la page Paramètres (Settings) > onglet Sécurité (Security).

Quels sont les types d'authentification de Robot

Authentification standard

Autorisez uniquement les connexions avec des jetons d'authentification qui n'ont pas de limite d'expiration en désactivant les deux options d'authentification de la page Paramètres (Settings) > onglet Sécurité (Security).

• Allow both user authentication and robot key authentication - not selected
• Enforce user authentication, disable robot key authentication - not selected

Saisie de texte	Implications
Assisté (Attended)	Limitez l'authentification de l'Attended Robot dans l'Assistant à la clé de machine. L'option Connexion (Sign in) n'est pas affichée dans l'Assistant, les utilisateurs ne peuvent donc pas se connecter à Studio et à l'Assistant à Orchestrator en utilisant leurs informations d'identification.
Non assisté (Unattended)	Les Unattended Robots requièrent constamment des connexions de clé de machine.

Authentification hybride

Autorisez à la fois les connexions standard avec des jetons qui n'expirent pas et les connexions avec des jetons qui expirent en activant Autoriser à la fois l'authentification de l'utilisateur et l'authentification par clé robot (Allow both user authentication and robot key authentication) et en désactivant Appliquer l'authentification utilisateur, désactiver l'authentification de clé robot (Enforce user authentication, disable robot key authentication).

• Allow both user authentication and robot key authentication not selected
• Enforce user authentication, disable robot key authentication selected

Saisie de texte	Implications
Assisté (Attended)	Vous pouvez utiliser la connexion interactive pour authentifier les Attended Robots. L'option Connexion (Sign in) est affichée dans l'Assistant qui permet aux utilisateurs de connecter Studio et Assistant à Orchestrator en utilisant leurs informations d'identification.
Non assisté (Unattended)	Les Unattended Robots requièrent constamment des connexions de clé de machine.

Authentification sécurisée

Autorisez uniquement les connexions avec des jetons qui expirent en activant les deux options d'authentification de la page Paramètres (Settings) > onglet Sécurité (Security). L'utilisateur doit être connecté pour effectuer des requêtes HTTP Orchestrator, exécuter des Attended Robots ou afficher des processus dans l'Assistant.

• Allow both user authentication and robot key authentication selected
• Enforce user authentication, disable robot key authentication selected

Saisie de texte	Implications
Assisté (Attended)	Limitez l'authentification de l'Attended Robot dans l'Assistant à la connexion interactive des utilisateurs. L'authentification de l'Attended Robot nécessite une connexion ; sinon, l'utilisateur ne verra pas ses processus associés dans l'Assistant et le Robot apparaîtra comme « Connecté, sans licence ».
Non assisté (Unattended)	Les Unattended Robots requièrent constamment des connexions de clé de machine.
Unattended en mode Attended	Pour le mode Unattended, la machine hôte est connectée et sous licence en mode Unattended, de sorte que l'outil d'exécution des processus indiqué est Orchestrator. Si vous souhaitez utiliser la machine en mode Attended (ouverture de l'Assistant) lorsque l'authentification de l'utilisateur est appliquée, vous devez vous connecter, sinon vous ne pourrez pas voir les processus dans l'Assistant et le Robot apparaîtra comme « Connecté, sans licence (Connected, Unlicensed) ».

Important :

Cette méthode d'authentification sécurisée nécessite la recompilation des workflows qui utilisent les activités Orchestrator ou qui effectuent des appels HTTP directs à l'API Orchestrator à l'aide des packages d'activités v2020.10 ou plus récents.

Il est possible que l'exécution de la tâche échoue si au moins l'une des dépendances listées ci-dessous est utilisée dans un projet d'automatisation :

• UiPath.System.Activities < 20.10.0
• UiPath.Persistence.Activities < 1.1.7
• UiPath.DataService.Activities < 20.10.0
• UiPath.Testing.Activities < 1.2.0

Utilisez l'Outil de mise à jour groupée des dépendances de projets (Project Dependencies Mass Update Tool) de Studio pour mettre à jour les dépendances de processus vers des versions plus récentes ou vers celles indiquées ci-dessus. Procédez à un test avant le déploiement en production.

Connexion des Attended Robots à Orchestrator

Connexion interactive

Utilisez la connexion interactive pour authentifier les Attended Robots. L'option Connexion (Sign in) est affichée dans l'Assistant qui permet aux utilisateurs de connecter Studio et Assistant à Orchestrator en utilisant leurs informations d'identification. Compatible avec :

• Authentification hybride
• Authentification sécurisée

1. Ouvrez l'Assistant.

2. Dans le menu Préférences (Preferences), sélectionnez Connexion (Sign in). Vous êtes dirigé vers la page de connexion de votre instance Orchestrator.

3. Connectez-vous comme d'habitude.

4. Once your identity is confirmed, the Assistant is populated with the processes in the folders your user has access to. Learn more about interactive authentication.

   Remarque :

   When using interactive sing-in, there is no need to create Machine objects in Orchestrator.

   Important :

   La connexion interactive n'est pas prise en charge dans un contexte de dossier classique.

Utilisation de la clé machine dans l'assistant

Utilisez la clé machine générée dans Orchestrator pour authentifier les Attended Robots. Compatible avec :

• Authentification standard

• Authentification hybride

  Remarque :

  • La personne qui gère la configuration d'Orchestrator dans l'entreprise doit fournir aux utilisateurs et aux développeurs Attended l'URL et la clé machine correctes d'Orchestrator. Les objets de machine n'ont pas besoin d'être affectés aux dossiers Orchestrator, seulement les utilisateurs.
  • Plusieurs utilisateurs travaillant sur la même machine nécessitent chacun un Robot créé dans Orchestrator.

1. Ouvrez l'Assistant.

2. Dans le menu Préférences, sélectionnez Préférences. La fenêtre Préférences s’affiche.

   

3. Accédez aux paramètres d'Orchestrator.

4. Dans le champ URL Orchestrator, saisissez l’adresse web d’Orchestrator, par exemple, https://myOrchestrator.uipath.com/.

5. Dans le champ Clé de machine (Machine Key), saisissez la clé générée pour l'entité de machine dans Orchestrator.

   Learn about the various machine entities in Orchestrator and when to use each.

6. Cliquez sur Connecter (Connect). Le Robot est maintenant connecté à Orchestrator.

   

   Remarque :

   La fonctionnalité Robots haute densité ne fonctionne que si le même nom de machine et la même clé sont utilisés lors de l'enregistrement de chaque Robot par utilisateur.

Utilisation de la touche Machine dans la ligne de commande

1. Enregistrez la clé de machine générée dans Orchestrator dans le Presse-papiers ou un fichier.
2. Lancez l'invite de commandes.
3. Accédez au répertoire où votre Robot UiPath est installé (par défaut C:\Program Files\UiPath\Studio). Par exemple : cd C:\Program Files\UiPath\Studio.
4. Utilisez les arguments de ligne de commande --connect, -url, et -key en conjonction avec l’URL Orchestrator et la clé de machine. Par exemple : UiRobot.exe --connect -url https://demo.uipath.com/ -key ba1e4809-2f64-4965-bae2-efda62d20164. Le robot UiPath est maintenant connecté à Orchestrator. Dans un environnement à haute densité, le robot correspondant à chaque utilisateur est connecté à Orchestrator.

Connexion d'Unattended Robots à Orchestrator

Utilisation de la clé machine dans l'assistant

Utilisez la clé machine générée dans Orchestrator pour authentifier les Unattended Robots. Des connexions de clé machine sont requises à tout moment pour une exécution Unattended. Compatible avec :

• Authentification standard

• Authentification hybride

• Authentification sécurisée

  Remarque :

  Les droits d'administrateur sont requis pour effectuer cette procédure pour le Robot en mode de service.

Important :

La machine hôte est connectée et sous licence en mode Unattended afin que vous puissiez exécuter des processus Unattended à l'aide d'Orchestrator.

Si vous souhaitez utiliser la machine en mode Attended (ouverture de l'Assistant) lorsque l'authentification de l'utilisateur est appliquée, vous devez vous connecter, sinon vous ne pourrez pas voir les processus dans l'Assistant et le Robot apparaîtra comme « Connecté, sans licence (Connected, Unlicensed) ».

1. Ouvrez l'Assistant.

2. Dans le menu Préférences, sélectionnez Préférences. La fenêtre Préférences s’affiche.

   

3. Accédez aux paramètres d'Orchestrator.

4. Dans le champ URL Orchestrator, saisissez l’adresse web d’Orchestrator, par exemple, https://myOrchestrator.domain.local/.

5. In the Machine Key field, enter the key generated by the machine entity in Orchestrator. Learn about the various machine entities in Orchestrator and when to use each.

6. Cliquez sur Connecter (Connect). Le robot UiPath est à présent connecté à Orchestrator.

   

   Remarque :

   • Les objets de machine doivent être affectés à des dossiers dans Orchestrator.
   • La fonctionnalité Robots haute densité ne fonctionne que si le même nom de machine et la même clé sont utilisés lors de l'enregistrement de chaque Robot par utilisateur.

Utilisation de la touche Machine dans la ligne de commande

1. Enregistrez la clé de machine générée dans Orchestrator dans le Presse-papiers ou un fichier.
2. Lancez l'invite de commandes.
3. Accédez au répertoire où votre Robot UiPath est installé (par défaut C:\Program Files\UiPath\Studio). Par exemple : cd C:\Program Files\UiPath\Studio.
4. Utilisez les arguments de ligne de commande --connect, -url, et -key en conjonction avec l’URL Orchestrator et la clé de machine. Par exemple : UiRobot.exe --connect -url https://demo.uipath.com/ -key ba1e4809-2f64-4965-bae2-efda62d20164. Le robot UiPath est maintenant connecté à Orchestrator. Dans un environnement à haute densité, le robot correspondant à chaque utilisateur est connecté à Orchestrator.

Inscription automatique

Utilisez une chaîne de connexion pour inscrire automatiquement des Robots en mode Service à Orchestrator.

La chaîne de connexion est une URL qui contient les informations suivantes :

• URL d'Orchestrator : identifie l'instance d'Orchestrator à laquelle le robot UiPath se connecte ;

• ID de locataire : identifie le locataire auquel le robot UiPath se connecte ;

• domain name - identifies the domain of the machine; this is only necessary if the machine is in a different domain than that specified for the WindowsAuth.Domain parameter (this is valid for subdomain machines as well). The domain needs to be in a two-way trust relationship with the one set for the WindowsAuth.Domain parameter.

  Click here for details about authorization parameters in UiPath.Orchestrator.dll.config.

Voici deux exemples de chaînes de connexion en fonction du domaine de la machine :

• Même domaine que celui spécifié dans UiPath.Orchestrator.dll.config - https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1

• Domaine différent de celui spécifié dans UiPath.Orchestrator.dll.config - https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1&domainName=domain_name

  Remarque :

  Pour déployer les Robots dans Orchestrator à l'aide de la chaîne de connexion, les suivants sont requis :

  • the WindowsAuth.Enabled parameter has to be set to true
  • the WindowsAuth.Domain parameter has to be set to a valid domain
  • the Service Mode Robot has to be installed.

1. In Orchestrator, navigate to Settings,General tab. (Tenant > Settings > General). Look for the Connection String field on the Application Settings section, and click Copy. The connection string is copied to the clipboard.

   

2. Envoyez la chaîne de connexion à la machine Robot à connecter à Orchestrator (via e-mail, clé USB, etc.)

3. Use an automatic deployment tool to install the Robots and provide the connection string copied above in the CONNECTIONSTRING parameter used with the UiPathStudio.msi installer. UiPath Robot is connected to Orchestrator and is displayed as Available in the Robots page.

   Remarque :

   Connecting Robots to Orchestrator using the --connectionstring parameter is only possible when Standard Machines are used. Environments with Machine Templates do not support this.