Weiterleitung von Robotern über einen Proxy-Server

Damit ein Roboter eine direkte Kommunikation mit dem Orchestrator herstellen kann, muss er sich im selben Netzwerk befinden oder ein offenes verwenden. Andernfalls müssen Sie einen Proxyserver einrichten, um die Kommunikation zu erleichtern.

Richten Sie einen Proxy ein, indem Sie entweder ein Proxy-Skript verwenden oder die Proxyserveradresse mit einer Liste von zu umgehenden Adressen angeben. Es kann nur eine Methode verwendet werden. Wenn beides konfiguriert ist, hat das Proxy-Skript Vorrang.

Die folgenden Konfigurationsoptionen sind verfügbar:

• Konfigurieren des Webbrowsers

• Konfigurieren der Windows-Proxyeinstellungen

• Konfigurieren der Proxyeinstellung über Befehlszeilenparameter

• Bearbeiten der uipath.config-Datei

Wichtig: Beim Aktualisieren von Versionen vor v2021.4 werden Proxy-Konfigurationen von der proxy.config-Datei in uipath.config migriert, um dem neuen Format zu entsprechen.

Proxy für den Benutzermodus von Robotern

Roboter im Benutzermodus übernehmen die Proxy-Einstellungen, die für Ihren Webbrowser konfiguriert sind.

Bei Proxy-Einstellungen, die eine grundlegende Nicht-Windows-Authentifizierung erfordern, speichern Sie die erforderlichen Zugriffsrechte im Anmeldeinformationsspeicher der Maschine.

Wichtig:

Um Proxyeinstellungen auf Benutzermodusroboter anzuwenden, müssen Sie den Benutzerhostdienst neu starten. Dazu müssen Sie sich von der Windows-Benutzersitzung abmelden und dann wieder anmelden.

Proxy für Dienstmodusroboter

Um die Proxy-Einstellungen für Roboter im Dienstmodus mit den Funktionen „Interaktive Anmeldung“ und „Livestream“ korrekt zu verwenden, müssen Sie sowohl die Datei uipath.config als auch die entsprechenden Windows-Einstellungen des Benutzerkontos ändern, unter dem der Roboter ausgeführt wird.

Proxyeinstellungen basierend auf Benutzertypen (Executor)

Im Kontext von UiPath können Windows-Prozesse unter zwei unterschiedlichen Identitäten ausgeführt werden:

• Lokaler Benutzer – Diese Prozesse werden unter der Identität des Benutzers ausgeführt, der derzeit in der Windows-Sitzung angemeldet ist.

• LocalSystem-Benutzer–Diese Prozesse sind in der Regel Dienste oder Hintergrundaufgaben, die mit Berechtigungen auf Systemebene ausgeführt werden.

Beim Konfigurieren eines Proxys in Windows sind die Proxyeinstellungen an den Benutzer gebunden, der den Prozess ausführt. Abhängig von der Identität des Prozesses, der die HTTP-Anforderung stellt, gibt es daher zwei mögliche Szenarien für die Proxykonfiguration:

• Es wird der für den Benutzer in Windows definierte Proxy verwendet.

• Die Proxyeinstellungen werden aus der Datei uipath.config geladen.

In der folgenden Tabelle finden Sie eine Übersicht über die roboterbezogenen Windows-Prozesse, die Benutzeridentitäten, unter denen sie laufen, und die HTTP-Anforderungen, die sie ausführen:

Windows-Prozess	Benutzeridentität	HTTP-Anforderungen
UiPath.ServiceHost.exe	LocalSystem	Zuständig für die Dienstkommunikation mit dem Orchestrator, einschließlich: Abrufen von Heartbeats Abrufen von Aufträgen und Übermitteln von Auftragsstatus Umgang mit Protokollen für Unattended-Prozesse Verwalten der Authentifizierung für den Dienst Herunterladen von Paketen
UiPath.UserHost.exe	Benutzer	Verantwortlich für die Kommunikation des Dienstes mit dem Orchestrator, wenn er im Benutzermodus installiert ist, einschließlich: Abrufen von Heartbeats Verwalten von Protokollen für Prozesse Verwalten der Authentifizierung für den UiPath Assistant Herunterladen von Paketen
UiPath.Executor.exe	LocalSystem (beim Ausführen eines Hintergrundauftrags) Benutzer (beim Ausführen regulärer Aufträge)	Zuständig für die Bearbeitung von automatisierungsspezifischen HTTP-Anforderungen, einschließlich: Verwalten von Assets und Warteschlangenelementen Senden von aktivitätsspezifischen Anforderungen (HTTP-Anforderungen an externe Dienste)
UiPath.Assistant.exe	Benutzer	Zuständig für den Umgang mit Assistant-bezogenem Datenverkehr, einschließlich: Verwaltung von Prozesslisten Handhabung von Triggern Interaktionen auf dem Marketplace
UiPath.RemoteDebugging.Agent.exe	Benutzer	Zuständig für die Abwicklung des Remote Debugging-Datenverkehrs über SignalR.
UiPath.UpdateService.Worker.exe	LocalSystem	Zuständig für das Herunterladen der MSIs vom Orchestrator.

Der Prozess der automatischen Aktualisierung für Proxykonfigurationen

Sie können den Prozess der automatischen Aktualisierung für Roboter konfigurieren, die hinter einem Proxy arbeiten, abhängig vom Typ der Roboter-Installation:

Bei Unattended-Installationen fehlt der Update Agent. Konfigurationen für Proxys werden manuell durch Ändern der UiPath.config -Datei verarbeitet. Sowohl der Roboterdienst als auch der Updatedienst werden mit einem Windows-Dienst unabhängig von einem Benutzer ausgeführt.

Bei Attended-Installationen werden Konfigurationen für den Proxy auch manuell durch Ändern der UiPath.config -Datei verarbeitet. Der Benutzer startet jedoch sowohl den Roboterdienst als auch den Update-Agent. Der Update Service wird mithilfe eines Windows-Dienstes ausgeführt.

Bei Schnellinstallationen werden Konfigurationen für den Proxy von den vorhandenen Benutzereinstellungen geerbt. Der Benutzer initiiert alle Dienste: Robot Service, Update Agent und Update Service.

Proxyauthentifizierung über Windows-Anmeldeinformationen

Der Proxyserver benötigt möglicherweise Anmeldeinformationen, um den Datenverkehr zuzulassen. Sie können den Proxy so konfigurieren, dass er sich mit den Anmeldeinformationen des angemeldeten Windows-Benutzers authentifiziert.

Um diese Funktion zu aktivieren, fügen Sie die Systemumgebungsvariable UIPATH_PROXY_USE_DEFAULT_CREDENTIALS auf der Maschine hinzu, auf der der Roboter ausgeführt wird, und legen Sie ihren Wert auf true fest. Dadurch wird dem Roboter mitgeteilt, die Windows-Anmeldeinformationen des aktuellen Benutzers für die Proxy-Authentifizierung zu verwenden.

Einfache Authentifizierung

Ab Version 2021.10 unterstützt der UiPath-Roboterdienst Proxyserver mit Standardauthentifizierungsprotokollen.

Benutzermodusroboter – Mit der einfachen Authentifizierung identifiziert der Assistant, ob eine Proxykonfiguration auf der Maschine implementiert ist, und fordert den Benutzer zur Eingabe seiner Anmeldeinformationen auf.

Dienstmodusroboter – Der Roboter-Executor unterstützt keine einfachen Authentifizierungsmethoden für Proxykonfigurationen. Sie können zwar die Standardauthentifizierung verwenden, um sich mit dem Orchestrator zu verbinden und Pakete herunterzuladen, aber nicht innerhalb der eigentlichen Ausführung des Workflows. Um die Standardauthentifizierung für Roboter im Dienstmodus zu aktivieren, aktualisieren Sie die Datei UiPath.config mit den folgenden Parametern für den Proxy:

<webProxySettings>
<add key="ProxyAddress" value="http://my.proxy.net:8008" />
<add key="UserName" value="myUser" />
<add key="Password" value="myPassword" />
<add key="Domain" value="myDomain" />
</webProxySettings>

Livestreaming und Remotesteuerung in einem Proxy-Setup

Warnung:

Livestreaming- und Remotesteuerungsfunktionen funktionieren nicht in einem Proxy-Setup für Roboterversionen, die älter als 2024.10.5 sind. Aktualisieren Sie Ihren Roboter auf Versionen 2024.10.5+, um auf diese Funktionen in einem Proxy-Setup zuzugreifen.

Konfigurieren des Webbrowsers

1. Öffnen Sie das Fenster Internet-Eigenschaften.
2. Wählen Sie auf der Registerkarte Verbindungen die Option LAN-Einstellungen aus. Das Fenster Einstellungen für lokales Netzwerk (LAN) wird geöffnet. Je nach Einrichtung können Sie ein Proxykonfigurationsskript oder einen Proxyserver festlegen.
   
   1. Um ein Proxyskript zu verwenden, wählen Sie Automatisches Konfigurationsskript verwenden aus und geben Sie die Adresse für das Skript an.
   2. Um den Proxyserver manuell einzurichten, wählen Sie Proxyserver verwenden für Ihr LAN aus und geben Sie dann die Adresse des Proxyservers und den Port an.
3. Um Ihre Einstellungen zu speichern, wählen Sie OK aus.
4. Testen Sie die Verbindung in Ihrem Webbrowser, indem Sie auf die Orchestrator-URL zugreifen.

Konfigurieren der Windows-Proxyeinstellungen

1. Öffnen Sie das Fenster Proxyeinstellungen.
2. Um ein Proxyskript zu verwenden, schalten Sie unter Automatisches Proxy-Setup die Option Setup-Skript verwenden ein. Geben Sie die Adresse für das Skript an.
3. Um den Proxyserver manuell einzurichten, aktivieren Sie unter Manuelle Proxyeinrichtung die Option Proxyserver verwenden. Geben Sie die Adresse des Proxyservers und den Port an.
   Wichtig:

   Das Hinzufügen des Präfixes http:// zur Proxyserveradresse verhindert, dass Robot HTTPS-Aufrufe tätigt. Um sicherzustellen, dass der Proxy wie erwartet funktioniert, entfernen Sie das Präfix http:// vollständig oder fügen Sie die Proxyadresse mit den beiden Präfixen http:// und https:// hinzu.

   Zum Beispiel:

   • Falsch – http=proxyaddress
   • Richtig – http=proxyaddress;https=proxyaddress
   • Richtig – http://proxyaddress;https://proxyaddress
4. Um Ihre Einstellungen zu speichern, wählen Sie Speichern aus.

Bearbeiten der Datei uipath.config

1. Navigieren Sie zum Installationsordner %ProgramFiles%\UiPath\Studio.
2. Suchen Sie nach der Datei uipath.config und öffnen Sie diese mtihilfe eines Texteditors, beispielsweise Notepad++.
3. Fügen Sie das <webProxySettings>‑Tag hinzu und legen Sie die Werte basierend auf Ihrer Proxy-Umgebung fest.
   1. Um ein Proxyskript zu verwenden, geben Sie das folgende Schlüssel-Wert-Paar an:

      <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>

   2. Um eine Proxyadresse anzugeben, geben Sie die folgenden Schlüssel-Wert-Paare an:

      <webProxySettings>
          <add key="ProxyAddress" value="http://1.1.1.1:1234/" />
          <add key="BypassLocalAddresses" value="True" />
          <add key="BypassList" value="server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}" />
      </webProxySettings>

4. Speichern Sie die Datei uipath.config.
5. Starten Sie den UiPath-Roboterdienst erneut.

Konfigurieren der Proxyeinstellungen während der Roboterinstallation

Um die Proxy-Einstellungen während der Installation von Robotern im Dienstmodus hinzuzufügen, verwenden Sie die dedizierten Befehlszeilenparameter in Ihrem Installationsbefehl.

Beispielsweise installiert der folgende Befehl den Roboter im Dienstmodus und verwendet ein Skript zum Konfigurieren des Proxys:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

Der folgende Befehl installiert den Roboter im Dienstmodus und richtet die Standardauthentifizierung für Proxyeinstellungen ein:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_ADDRESS=http://my.proxy.net:8008 PROXY_USERNAME="myUser" PROXY_PASSWORD="myUser" PROXY_DOMAIN="myUser"

Prüfen der Proxy-Server-Verbindung

1. Verbinden des Roboters mit dem Orchestrator
2. Stellen Sie einige Pakete in einer Umgebung bereit, die den zuvor konfigurierten Roboter enthält.
3. Navigieren Sie zum Ordner %userprofile%\.nuget\ und prüfen Sie, ob der entsprechende Prozess und die Aktivitätspakete heruntergeladen wurden.
4. Führen Sie den entsprechenden Job aus, um zu prüfen, ob er erfolgreich ausgeführt wird.