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).

• Autoriser l’authentification utilisateur et l’authentification de clé robot

• Appliquer l’authentification utilisateur, désactiver l’authentification de clé robot

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).

• Autoriser l’authentification utilisateur et l’authentification de clé robot

• Appliquer l’authentification utilisateur, désactiver l’authentification de clé robot

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.

• Autoriser l’authentification utilisateur et l’authentification de clé robot

• Appliquer l’authentification utilisateur, désactiver l’authentification de clé robot

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. Une fois votre identité confirmée, l'Assistant est automatiquement rempli par les processus dans les dossiers auxquels votre utilisateur a accès. En savoir plus sur l'authentification interactive.
   Remarque : Si vous utilisez la connexion interactive, il n'est pas nécessaire de créer des objets machine dans Orchestrator.

   Attention : 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é Machine (Machine Key), saisissez la clé générée pour l'entité de machine dans Orchestrator.

   Cliquez ici pour plus de détails sur les différentes entités de machine dans Orchestrator et savoir quand les utiliser.

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. Dans le champ Clé Machine (Machine Key), saisissez la clé générée pour l'entité de machine dans Orchestrator. Cliquez ici pour plus de détails sur les différentes entités de machine dans Orchestrator et savoir quand les utiliser.
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 ;
• Nom de domaine : identifie le domaine de la machine. Il est uniquement nécessaire si la machine se trouve dans un domaine différent de celui spécifié pour le paramètre WindowsAuth.Domain (il est également valide pour les machines du sous-domaine). Le domaine doit être dans une relation de confiance à double sens avec celui défini pour le paramètre WindowsAuth.Domain.

  Cliquez ici pour plus de détails sur les paramètres d’autorisation dans 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 :

  • le paramètre WindowsAuth.Enabled doit être défini sur true
  • le paramètre WindowsAuth.Domain doit être configuré sur un domaine valide
  • le Robot en Mode Service (Service Mode Robot) doit être installé.

1. Dans Orchestrator, accédez à Paramètres (Settings), onglet Général (General). (Tenant (Locataire) > Paramètres (Settings) > Général (General)). Recherchez le champ Chaîne de connexion (Connection String) dans la section Paramètres d’application (Application Settings), et cliquez sur Copier (Copy). La chaîne de connexion est copiée dans le Presse-papiers.
   
   

   

   
   
2. Envoyez la chaîne de connexion à la machine Robot à connecter à Orchestrator (via e-mail, clé USB, etc.)
3. Utilisez un outil de déploiement automatique pour installer les Robots et indiquez la chaîne de connexion copiée ci-dessus dans le paramètre ChaîneConnexion utilisé avec le programme d’installation UiPathStudio.msi. Le Robot est connecté à Orchestrator et s’affiche comme Disponible (Available) sur la page Robots.
   Remarque : La connexion de Robots à Orchestrator à l'aide du paramètre --connectionstring n'est possible que lorsque des machines standard sont utilisées. Les environnements avec des modèles de machine ne prennent pas en charge cette opération.