Connexion des applications à une instance locale d'Orchestrator

Les applications UiPath^® , bien qu'uniquement disponible sur cloud pour le moment, fournissent des moyens de se connecter à une version déployée sur site d'UiPath^® Orchestrator (v19.10 et versions ultérieures) pour aider à tirer parti de la puissance de la RPA pour générer des expériences d'applications riches.

Pour en savoir plus sur le flux de données entre Apps et Orchestrator, consultez le diagramme de flux de données hybride.

Workflow d'intégration

1. Toutes les connexions à Orchestrator sont établies à partir d'un seul endroit, l'application Apps Service.
2. Tous les appels à Orchestrator sont des appels authentifiés conformément au modèle de sécurité exposé par Orchestrator. Veuillez consulter la section sur l'authentification.

3. Les informations d'identification obtenues de l'utilisateur pour communiquer avec Orchestrator sont utilisées pour toutes les communications avec Orchestrator à la fois au moment de la conception lors de la création de l'application et au moment de l'exécution de l'application. L'identité de l'utilisateur qui conçoit ou exécute l'application elle-même n'a aucune incidence ici.

   • Après avoir obtenu initialement les informations d'identification auprès du concepteur de l'application, les informations d'identification sont stockées dans le backend des applications avec un chiffrement au repos pour garantir la transparence et la continuité de la conception et d'expérience d'exécution pour tous les utilisateurs de l'application.
4. Le service Apps configure un rappel webhook sécurisé via https sur les événements du cycle de vie des processus pour aider à détecter le démarrage, l'arrêt, l'erreur, etc. des processus. Cela suit les meilleures pratiques mentionnées dans la page À propos des Webhooks (About Webhooks).
5. Aucune donnée liée au processus n'est stockée sur le backend des applications. Les seules informations persistantes sont les métadonnées autour de l'identité du ou des processus utilisés par une application spécifique.
6. Les applications peuvent appeler à la fois des processus Orchestrator Attended et Unattended. Un concepteur d'application peut choisir d'exécuter un processus via l'instance connectée d'Orchestrator ou directement sur l'ordinateur local sur lequel l'application s'exécute à l'aide de UiPath^® RobotJS.

• Dans le scénario du robot local, l'exécution du processus est invoquée depuis le navigateur vers le robot exécuté localement et la communication ne quitte pas les frontières de l'ordinateur.
• Dans l'exécution du processus via l'option Orchestrator, le cycle de vie complet du processus est géré par Orchestrator, et les applications UiPath^® ne jouent aucun rôle autre que celui qui consiste à écouter des événements du cycle de vie du processus à l'aide du rappel du Webhook.

Autoriser les applications UiPath^® à accéder à une instance d'Orchestrator locale

Le service Apps utilise les adresses IP sortantes pour toutes les communications externes :

• 20.103.103.104/30

• 20.82.230.132/30

• 52.226.216.100/30

• 52.149.31.132/30

• 20.103.172.28/30

• 20.82.205.104/30

• 20.92.155.132/30

• 20.70.73.28/30

• 20.116.168.240/30

• 52.229.69.80/30

• 20.63.171.100/30

• 104.215.23.28/30

• 52.175.22.152/30

• 20.198.201.136/30

Le trafic provenant de ces adresses IP doit être autorisé via le pare-feu DMZ de l'organisation et tout autre pare-feu intermédiaire, y compris le pare-feu sur le ou les ordinateurs sur lesquels l'application Orchestrator est hébergée.

• Le port associé sur lequel l'application Orchestrator est hébergée doit être exposé via le pare-feu DMZ sur tous les pare-feux concernés (voir le point précédent).
• Un utilisateur d’Orchestrator qui dispose d’un accès en lecture et en exécution aux processus pertinents dont les informations d’identification seront utilisées à partir des applications UiPath^® pour communiquer avec Orchestrator.

• Si vous utilisez l'exécution de processus de robot local via RobotJS, assurez-vous que RobotJS est correctement configuré à l'aide des instructions fournies sur RobotJS.

Meilleures pratiques

• Assurez-vous que l'instance d'Orchestrator hébergée sur site n'est accessible que via un canal https sécurisé.
• Créez un utilisateur à faible privilège dans Orchestrator qui ne dispose d'un accès en lecture et en exécution qu'aux processus/dossiers souhaités et utilisez-le dans le cadre de l'intégration.

Validation de la configuration

Apps Designer dit qu'il est impossible de se connecter à Orchestrator

• Les adresses IP sortantes des applications UiPath^® sont-elles sur la liste d'autorisation ?
• Le port Orchestrator est-il toujours sur la liste d'autorisation ?
• L'URL et le port utilisés dans le champ URL d'Orchestrator sont-ils appropriés ?
• A-t-il été confirmé que les informations d'identification fournies lors de la connexion à Orchestrator sont correctes ?
• Les informations d'identification fournies disposent-elles des autorisations pour répertorier/exécuter les dossiers et les processus ?

Apps Designer n'affiche aucun processus et aucun processus incorrect

• L'utilisateur dont les informations d'identification ont été configurées lors de la conception de l'application dispose-t-il d'un accès en lecture au dossier dans lequel résident les processus souhaités ?

Lors de la prévisualisation d'une application et/ou de l'exécution d'une application et de l'appel d'un processus, une erreur se produit

• Les adresses IP sortantes des applications UiPath^® sont-elles toujours sur la liste d'autorisation ?
• Le port Orchestrator est-il toujours sur la liste d'autorisation ?
• L'utilisateur dont les informations d'identification ont été configurées lors de la conception de l'application existe-t-il toujours ?
• L'utilisateur dont les informations d'identification ont été configurées lors de la conception de l'application a-t-il toujours les mêmes informations d'identification ?
• Le processus et la version exécutée existent-ils toujours dans Orchestrator dans le même dossier ou y a-t-il eu des changements ?
• Si vous exécutez des processus localement, Robotjs est-il correctement configuré et est-il capable d'établir correctement la liaison avec le robot ?
• Le processus en cours d'exécution sur le robot local a-t-il été téléchargé sur le robot avant de l'exécuter via l'application ?
• L'utilisateur dont les informations d'identification ont été configurées lors de la conception de l'application doit-il exécuter l'accès au processus ?

Scénarios non pris en charge

La connexion des applications UiPath^® avec un Orchestrator sur site avec des certificats auto-signés personnalisés n'est pas prise en charge.

Une connexion sécurisée (HTTPS) entre les applications UiPath^® et Orchestrator est nécessaire pour que l'authentification mutuelle fonctionne correctement. Pour établir cette connexion sécurisée, les deux parties doivent faire confiance aux certificats de l'autre. Pour que cela se produise, l'une des conditions suivantes doit être satisfaite :

1. Les deux parties doivent avoir des certificats obtenus auprès d'autorités de certification (CA) standard, telles que Google, VeriSign ou autres. Les produits cloud UiPath^® l'ont déjà, donc rien n'a besoin d'être fait sur cette partie. Cela doit être fait pour les déploiements de produits sur site.
2. Si le déploiement sur site utilise un certificat interne ou auto-signé, la connexion ne fonctionnera pas. Pour cela, le certificat doit être ajouté à la racine approuvée de l'autre partie. Notez que cela ne peut pas être fait pour les produits cloud UiPath^® , car aucun certificat personnalisé ne peut être ajouté aux systèmes cloud UiPath^® .