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 die 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 Processes 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 von Proxy-Konfigurationen

Sie können den automatischen Aktualisierungsprozess für Roboter konfigurieren, die hinter einem Proxy arbeiten, je nach Installationstyp des Roboters:

Bei unbeaufsichtigten Installationen fehlt der Aktualisierungs-Agent. Konfigurationen für Proxy werden manuell durch Änderung der Datei UiPath.configdefiniert. Sowohl der Roboterdienst als auch der Aktualisierungsdienst werden mit einem benutzerunabhängigen Windows-Dienst ausgeführt.

Bei beaufsichtigten Installationen werden Konfigurationen für Proxy ebenfalls manuell durch Änderung der Datei UiPath.configerledigt. Der Benutzer startet jedoch sowohl den Roboterdienst als auch den Update Agent.Der Update-Dienst wird mithilfe eines Windows-Dienstes ausgeführt.

Für schnelle Installationen werden Konfigurationen für den Proxy aus den vorhandenen Benutzereinstellungen geerbt. Der Benutzer initiiert alle Dienste: Roboterdienst, 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.

Roboter im Benutzermodus – Mit der Basisauthentifizierung erkennt 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:

Live-Streaming und Fernsteuerungsfunktionen funktionieren nicht in einer Proxy-Einrichtung für Roboter mit Versionen vor 2024.10.5.Aktualisieren Sie Ihren Roboter auf die Versionen 2024.10.5+, um in einer Proxy-Einrichtung auf diese Funktionen zuzugreifen.

Konfigurieren des Proxys über den Webbrowser

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 Proxy-Skript zu verwenden, wählen Sie Automatische Konfigurationsskript verwenden aus und geben Sie die Adresse für das Skript an.
   2. Um den Proxyserver manuell einzurichten, wählen Sie Einen Proxyserver für Ihr LAN verwenden aus und geben Sie dann die Adresse des Proxyservers und den Port ein.

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 des Proxys über die Windows-Einstellungen

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 http:// Präfixes zur Proxyserveradresse verhindert, dass der Roboter HTTPS-Aufrufe tätigt. Um sicherzustellen, dass der Proxy wie erwartet funktioniert, entfernen Sie das http:// Präfix vollständig oder fügen Sie die Proxyadresse mit beiden http:// Präfixen https:// hinzu.Zum Beispiel:

   • Falsch –http://proxyaddress
   • Korrekt – https://proxyaddresshttp://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 Roboterdienst oder das Gerät neu.

Konfigurieren der Proxyeinstellungen während der Roboterinstallation

Um die Proxyeinstellungen während der Installation von Unattended Robots (Servicemodus) hinzuzufügen, verwenden Sie die entsprechenden Befehlszeilenparameter in Ihrem Installationsbefehl.

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

UiPathStudio.msi ADDLOCAL=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=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.