Connexion des Robots à Orchestrator

Vous pouvez connecter vos Robots à Orchestrator de différentes manières en fonction des paramètres d'authentification des Robot configurés dans Orchestrator, généralement par un Administrator. Si vous ne connaissez pas les paramètres d'authentification des Robots, veuillez demander à votre Administrator Orchestrator de fournir des détails afin de pouvoir utiliser la méthode appropriée pour connecter votre Robot.

Quels sont mes paramètres d'authentification.

The robot authentication settings can be seen and configured on Tenant > Settings, on the Robot security tab, usually by an administrator. Your Orchestrator administrator should provide you with details so as to be able to use the right method to connect your robot.

En savoir plus sur l'authentification du robot.

Instructions sur la façon de modifier les paramètres d'authentification des Robots.

Connexion des Attended Robots à Orchestrator

Utilisation de l’URL de service (connexion interactive)

Connectez-vous à l'aide de vos informations d’identification pour connecter votre Robot à Orchestrator. Cela permet au Robot d'accéder aux ressources d'Orchestrator et fournit à l'utilisateur des droits opérationnels sur des produits tels que Studio ou l'Assistant.

1. Ouvrez l'Assistant.
2. Dans le menu Préférences, sélectionnez Paramètres d’Orchestrator. La fenêtre Configuration d’Orchestrator s’affiche.
3. Dans le champ Type de connexion, sélectionnez URL de service. Le contenu de la fenêtre est ajusté en fonction de la sélection.
4. Dans le champ URL de service, saisissez l’URL de l’instance Orchestrator à laquelle vous souhaitez vous connecter.
5. Sélectionnez Se connecter (Sign In). Vous êtes redirigé vers la page de connexion (Login) de votre instance Orchestrator.
6. Connectez-vous comme d'habitude.

Une fois votre identité confirmée, l’Assistant est automatiquement rempli avec les automatisations dans les dossiers Orchestrator auxquels vous pouvez accéder.

Figure 1. Connexion à l'aide de l'URL du service

Remarque :

• Si vous utilisez la connexion interactive, il n’est pas nécessaire de créer des objets machine dans Orchestrator.
• Vous avez besoin de l’autorisation Consultation (View) sur les packages au niveau du locataire pour pouvoir télécharger des packages et des bibliothèques.

Utilisation des informations d'identification du client dans l'Assistant

Utilisez les informations d’identification du client pour connecter des Attended Robots à Orchestrator. La paire ID de client-clé secrète du client est générée via des objets de modèle de machine dans Orchestrator.

Il existe deux manières de connecter votre Robot avec des informations d’identification client : à l'aide de l'Assistant ou via la ligne de commande.

1. Ouvrez l'Assistant.
2. Dans le menu Préférences, sélectionnez Paramètres d’Orchestrator. La fenêtre Configuration d’Orchestrator s’affiche.
3. Dans le champ Type de connexion, sélectionnez ID client. Le contenu de la fenêtre est ajusté en fonction de la sélection.
4. Dans le champ URL d’Orchestrator, saisissez l’URL de l’instance d’Orchestrator à laquelle vous souhaitez vous connecter.

Assurez-vous d’ajouter l’URL d’Orchestrator et l’objet AccountLogicalName et ServiceName, par exemple https://cloud.uipath.com/uipathtokyo/uipathkyoto/.

5. Pour le champ ID client, saisissez la clé générée par l’objet machine dans Orchestrator.
6. Pour le champ Clé secrète du client, saisissez la clé secrète du client générée par l’objet machine dans Orchestrator.
7. Sélectionnez Se connecter (Connect). Le Robot est maintenant connecté à Orchestrator.

Figure 2. Se connecter à l'aide de l'ID du client

Utilisation des informations d'identification du client dans la ligne de commande

1. Lancez l'invite de commandes.
2. Accédez au répertoire où votre Robot est installé. Par exemple :

   cd C:\Program Files\UiPath\Studio
   

3. Utilisez les arguments de ligne de commande --connect, --url, --clientID et --clientSecret pour connecter votre Robot et transmettre l'URL d'Orchestrator, l'ID de client et la clé secrète du client. Par exemple :

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   Remarque :

   Lorsque vous utilisez PowerShell, vous devez échapper le caractère $ dans la clé secrète du client à l'aide de "". Par exemple, vous devez transmettre une clé secrète de client telle que Bepx8O3XqSHrt$ZU en tant que "Bepx8O3XqSHrt""$""ZU".

Connexion d'Unattended Robots à Orchestrator

Dans le cas des automatisations 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 interactive 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).

Utilisation des informations d'identification du client dans l'Assistant

Utilisez les informations d'identification du client pour connecter des Unattended Robots à Orchestrator. La paire ID de client-clé secrète du client est générée via des objets de modèle de machine dans Orchestrator.

Il existe deux manières de connecter votre Robot avec des informations d’identification client : à l'aide de l'Assistant ou via la ligne de commande.

1. Ouvrez l'Assistant.
2. Dans le menu Préférences, sélectionnez Paramètres d’Orchestrator. La fenêtre Configuration d’Orchestrator s’affiche.
3. Dans le champ Type de connexion, sélectionnez ID client. Le contenu de la fenêtre est ajusté en fonction de la sélection.
4. Dans le champ URL d’Orchestrator, saisissez l’URL de l’instance d’Orchestrator à laquelle vous souhaitez vous connecter.

Assurez-vous d’ajouter l’URL d’Orchestrator et l’objet AccountLogicalName et ServiceName, par exemple https://cloud.uipath.com/uipathtokyo/uipathkyoto/.

5. Pour le champ ID client, saisissez la clé générée par l’objet machine dans Orchestrator.
6. Pour le champ Clé secrète du client, saisissez la clé secrète du client générée par l’objet machine dans Orchestrator.
7. Sélectionnez Se connecter (Connect). Le Robot est maintenant connecté à Orchestrator.

Figure 3. Se connecter à l'aide de l'ID du client

On a successful connection, Assistant will display a warning dot, followed by the Connected as Unattended message.

The warning is displayed when connected to an active Windows session and you are missing attended capabilities. To enable Attended mode, sign in with your RPA Developer account.

Remarque :

When you are connected as Unattended, the following error will be logged in Windows Event Viewer > Application events:

UiPath.Service.Host 25.10.7.0

[Http Status 401][Orchestrator Error Code

InvalidLoginMethod]UiPath.Robot.Core.Orchestrator.OrchestratorHttpException

Could not obtain user token. You are connected as Unattended, sign in, or enable the troubleshooting session from Orchestrator.

Utilisation des informations d'identification du client dans la ligne de commande

1. Lancez l'invite de commandes.
2. Accédez au répertoire où votre Robot est installé. Par exemple :

   cd C:\Program Files\UiPath\Studio
   

3. Utilisez les arguments de ligne de commande --connect, --url, --clientID et --clientSecret pour connecter votre Robot et transmettre l'URL d'Orchestrator, l'ID de client et la clé secrète du client. Par exemple :

   UiRobot.exe --connect --url <OrchestratorURL> --clientID <clientID> --clientSecret <clientSecret>
   

   Remarque :

   Lorsque vous utilisez PowerShell, vous devez échapper le caractère $ dans la clé secrète du client à l'aide de "". Par exemple, vous devez transmettre une clé secrète de client telle que Bepx8O3XqSHrt$ZU en tant que "Bepx8O3XqSHrt""$""ZU".

Mettre à jour l'URL Orchestrator par défaut pour Mac

Pour mettre à jour le service d'URL par défaut d'Orchestrator lors de l'utilisation de l'Assistant sur un Mac, modifiez-le à partir de store.json (/Applications/UiPath Assistant.app/Contents/Robot/uipath.config~/Library/Application Support/UiPath/store.json) :

"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }