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

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

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

Avertissement :

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

Ouvrez l'Assistant.
Dans le menu Préférences (Preferences), sélectionnez Connexion (Sign in). Vous êtes dirigé vers la page de connexion de votre instance Orchestrator.
Connectez-vous comme d'habitude.
Une fois votre identité confirmée, l'Assistant est automatiquement rempli par les processus dans les dossiers auxquels votre compte a accès. En savoir plus sur l'authentification interactive.

Remarque : lorsque vous utilisez la connexion interactive, il n'est pas nécessaire de créer
les 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 développeurs Attended l'URL et la clé de machine d'Orchestrator correctes. Les objets machine n'ont pas besoin d'être affectés aux dossiers Orchestrator, mais uniquement aux comptes.
- Plusieurs comptes travaillant sur la même machine nécessitent chacun un robot créé dans Orchestrator.

Ouvrez l'Assistant.
Dans le menu Préférences, sélectionnez Préférences. La fenêtre Préférences s’affiche.
Accédez aux paramètres d'Orchestrator.
Dans le champ URL Orchestrator, saisissez l’adresse web d’Orchestrator, par exemple, https://myOrchestrator.uipath.com/.
Dans le champ Clé Machine (Machine Key), saisissez la clé générée pour l'entité de machine dans Orchestrator.
Cliquez sur Connecter (Connect). Le Robot est maintenant connecté à Orchestrator.

Utilisation de la touche Machine dans la ligne de commande

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

Remarque : remplacez « https://demo.uipath.com/ » avec votre URL Orchestrator réelle.

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

Ouvrez l'Assistant.
Dans le menu Préférences, sélectionnez Préférences. La fenêtre Préférences s’affiche.
Accédez aux paramètres d'Orchestrator.
Dans le champ URL Orchestrator, saisissez l’adresse web d’Orchestrator, par exemple, https://myOrchestrator.domain.local/.
Dans le champ Clé Machine (Machine Key), saisissez la clé générée pour l'entité de machine dans Orchestrator.
Cliquez sur Connecter (Connect). Le Robot est maintenant connecté à Orchestrator.
Remarque :
- Les objets de machine doivent être affectés à des dossiers dans Orchestrator.

Utilisation de la touche Machine dans la ligne de commande

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

Remarque : remplacez « https://demo.uipath.com/ » avec votre URL Orchestrator réelle.