Verbinden von Apps mit einer On-Premises Orchestrator-Instanz

UiPath^® Apps cloud does provide means to connect to an on-premise deployed version of UiPath^® Orchestrator (19.10 and later) to help leverage the power of RPA to help drive rich app experiences.

Weitere Informationen zum Datenfluss zwischen Apps und dem Orchestrator finden Sie unter Hybrides Datenflussdiagramm.

Integrations-Workflow

1. Alle Verbindungen zum Orchestrator werden von einem einzigen Ort hergestellt, der Anwendung Apps-Dienst.
2. Alle Aufrufe im Orchestrator sind authentifizierte Aufrufe, die dem Sicherheitsmodell des Orchestrators entsprechen. Siehe Abschnitt Authentifizierung.

3. Anmeldeinformationen, die der Benutzer zum Interagieren mit dem Orchestrator erhält, werden für die gesamte Kommunikation mit dem Orchestrator verwendet, d. h. sowohl zum Zeitpunkt des Entwerfens, also beim Erstellen der App, als auch während der Laufzeit, also wenn die App ausgeführt wird. Die Identität des Benutzers, der die App entwirft oder selbst ausführt, hat hier keinerlei Bedeutung.

   • Nachdem Sie zunächst die Anmeldeinformationen vom App-Designer erhalten haben, werden die Anmeldeinformationen im Back-End von Apps mit Verschlüsselung im Ruhezustand gespeichert, um ein nahtloses und störungsfreies Design- und Laufzeiterlebnis für alle Benutzer der App zu ermöglichen.
4. Der Apps-Dienst richtet über https eine sichere Webhook-Rückruffunktion für Prozesslebenszyklus-Ereignisse ein, um zu erkennen, wann Prozesse starten, anhalten, Fehler auftreten usw. Dies entspricht den Best Practices, die auf der Seite Über Webhooks erwähnt werden.
5. Es werden keine prozessbezogenen Daten im Back-End von Apps gespeichert. Die einzigen Informationen, die beibehalten werden, sind Metadaten, die die die neutralen Elemente der Prozesse betreffen, die von einer bestimmten App verwendet werden.
6. Apps can invoke both attended and unattended Orchestrator processes. An app designer can choose to run a process through the connected Orchestrator or directly on the local computer on which the app is running using UiPath^® RobotJS.

• Für lokal ausgeführte Roboter wird die Prozessausführung vom Browser initiiert und die Kommunikation findet nicht über Computergrenzen hinweg statt.
• In the process execution via Orchestrator option, the complete lifecycle of the process is managed by Orchestrator, and UiPath^® Apps plays no role in the same other than listening to process lifecycle events using the webhook callback.

Allowing UiPath^® Apps to Access an On-Premise Orchestrator

Der Apps-Dienst verwendet die ausgehenden IP-Adressen für die gesamte externe Kommunikation:

• 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

Der Datenverkehr, der von diesen IP-Adressen abgeht, muss durch die DMZ der Firewall der Organisation und alle anderen zwischengeschalteten Firewalls genehmigt sein, einschließlich der Firewall auf dem/den Computer/n, wo die Orchestrator-Anwendung gehostet wird.

• Der zugehörige Port, auf dem die Orchestrator-Anwendung gehostet wird, muss durch die DMZ auf allen relevanten Firewalls offengelegt werden (siehe vorheriger Punkt)
• An Orchestrator user who has read and execute access to relevant processes whose credential will be used from UiPath^® Apps to talk to Orchestrator

• Wenn Sie die lokale Roboterprozessausführung über RobotJS verwenden, stellen Sie sicher, dass RobotJS mithilfe von RobotJS bereitgestellten Anweisungen ordnungsgemäß konfiguriert ist.

Best Practices

• Stellen Sie sicher, dass der lokal gehostete Orchestrator nur über einen sicheren HTTPS-Kanal zugänglich ist.
• Erstellen Sie im Orchestrator einen Benutzer, der über wenige Berechtigungen verfügt. Der Benutzer soll nur auf die gewünschten Prozesse/Ordner Zugriff haben und über Berechtigungen zum Lesen und Ausführen verfügen. Verwenden Sie das für die Integration.

Validieren der Konfiguration

Apps-Designer meldet, dass keine Verbindung zum Orchestrator möglich ist

• Are the UiPath^® Apps outgoing IPs allowlisted?
• Steht der Port des Orchestrators auf der Zulassungsliste?
• Wird die korrekte URL mit dem Port im URL-Feld des Orchestrators verwendet?
• Wurde bestätigt, dass die beim Herstellen der Verbindung mit dem Orchestrator angegebenen Anmeldeinformationen korrekt sind?
• Verfügen die angegebenen Anmeldeinformationen über die Berechtigungen zum Auflisten/Ausführen von Ordnern und Prozessen?

Apps-Designer zeigt keine Prozesse oder falsche Prozesse an

• Verfügt der Benutzer, dessen Anmeldeinformationen während des App-Designs konfiguriert wurden, über einen Lesezugriff auf den Ordner, in dem sich die gewünschten Prozesse befinden?

Wenn die Vorschau einer App angezeigt wird und/oder eine App ausgeführt und ein Prozesse abgerufen wird, tritt ein Fehler auf

• Are the UiPath^® Apps outgoing IPs still allowlisted?
• Steht der Port des Orchestrators noch auf der Zulassungsliste?
• Gibt es den Benutzer noch, dessen Anmeldeinformationen während des App-Designs konfiguriert wurden?
• Verfügt der Benutzer, dessen Anmeldeinformationen während des App-Designs konfiguriert wurden, noch über die gleichen Anmeldeinformationen?
• Gibt es den Prozess und die genaue Version, die ausgeführt wird, noch im selben Ordner im Orchestrator, oder hat sich etwas geändert?
• Ist RobotJS richtig konfiguriert und kann den Handshake mit dem Roboter ordnungsgemäß durchführen, wenn Prozesse lokal ausgeführt werden?
• Wurde der Prozess, der auf dem lokalen Roboter ausgeführt wird, auf den Roboter heruntergeladen, bevor derselbe über die App ausgeführt wird?
• Muss der Benutzer, dessen Anmeldeinformationen während des App-Designs konfiguriert wurden, auf den Prozess zugreifen?

Nicht unterstützte Szenarien

Connecting UiPath^® Apps with an on-premise Orchestrator with custom self-signed certificates is not supported.

A secure connection (HTTPS) between UiPath^® Apps and Orchestrator is needed for mutual authentication to work properly. To achieve this secure connection, both parties must trust each other's certificates. For this to happen, either of the following conditions must be satisfied:

1. Both parties should have certificates obtained from standard Certificate Authorities (CA), such as Google, VeriSign, or others. UiPath^® cloud products already have this, so nothing needs to be done on this part. This needs to be done for on-premise product deployments.
2. If the on-premise deployment uses an internal or self-signed certificate, the connection will not work. For that, the certificate has to be added to the trusted root of the other party. Note that this cannot be done for UiPath^® cloud products, as no custom certificates can be added to the UiPath^® cloud systems.