Weiterleitung von Robotern über einen Proxy-Server

Wenn Sie einen Roboter haben, der sich in einem geschlossenen Netzwerk befindet oder in einem anderen Netzwerk als dasjenige, das der Orchestrator verwendet, ist eine Kommunikation zwischen den beiden UiPath-Produkten nicht möglich. Um diese Kommunikation zu ermöglichen, können Sie daher einen Proxy-Server mit Ihrem Roboter verwenden.

Um den Roboter über einen Proxy-Server weiterzuleiten, müssen Sie mehrere Konfigurationsschritte auf dem Roboter-Computer vornehmen:

1. Konfigurieren Sie Ihren bevorzugten Webbrowser, um sicherzustellen, dass der Roboter-Computer über den angegebenen Proxy-Server auf den Orchestrator zugreifen kann.
2. Bearbeiten Sie die Datei UiPath.config, um sicherzustellen, dass die Verbindung zwischen dem Roboter und dem Orchestrator über den angegebenen Proxy-Server geleitet wird und dass die Aktivitätspakete und Automatisierungsprozesse über den angegebenen Proxy-Server heruntergeladen werden können.
   Hinweis:

   • Der Roboter im Benutzermodus erbt die Proxy-Einstellungen aus den Internetoptionen, während der Roboter im Dienstmodus eine bestimmte Konfiguration in der Datei uipath.configaus dem Studio-Installationsordner vornehmen muss.
   • Wenn der Roboter im Dienstmodus installiert ist und Sie die interaktive Anmeldung von UiPath Assistant verwenden, müssen Sie die Proxyeinstellungen sowohl in der Datei uipath.config als auch in den Windows-Einstellungen für den Benutzer konfigurieren, unter dem der Roboter ausgeführt wird.
   • 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.

Wichtig:

Wenn der Roboter im Benutzermodus installiert ist und Proxy-Konfigurationen verwendet werden sollen, die eine einfache (nicht Windows-) Authentifizierung für die Prozessausführung erfordern, müssen die Anmeldeinformationen zur Anmeldeinformationsverwaltung der Maschine hinzugefügt werden, da die Einstellungen in der uipath.config-Datei nur für den Roboter im Dienstmodus gelten.

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 der Proxyeinstellungen

Konfigurationen für das Proxy-Skript oder die Proxy-Adresse können entweder über den Abschnitt „Verbindungen“ in den Internetoptionen oder über das Menü „Proxy-Einstellungen“ in den Windows-Einstellungen festgelegt werden.

Konfigurieren des Webbrowsers

1. Im Internet Explorer klicken Sie Tools > Internetoptionen an. Das Fenster Internetoptionen wird angezeigt.

   

2. Klicken Sie auf der Registerkarte Verbindungen auf LAN-Einstellungen. Das Fenster Einstellungen des lokalen Netzwerks (LAN) wird angezeigt. Je nach Setup können Sie ein Proxy-Konfigurationsskript oder einen Proxy-Server festlegen.

   

3. Konfigurieren Sie den Proxy-Server oder die automatische Konfiguration (für das Proxy-Skript).

4. Klicken Sie OK (OK) an. Ihre Einstellungen werden gespeichert.

5. Geben Sie im Webbrowser die Orchestrator-URL ein, um die Verbindung zu testen.

Konfigurieren der Windows-Proxyeinstellungen

1. Öffnen Sie das Startmenü und suchen Sie nach Proxy-Einstellungen.
2. Konfigurieren Sie das automatische Proxy-Setup (für das Proxy-Skript) oder das manuelle Proxy-Setup (für den Proxy-Server).
3. Speichern Sie die Einstellungen.

Geben Sie im Webbrowser die Orchestrator-URL ein, um die Verbindung zu testen.

Wichtig:

Fügen Sie beim Einrichten oder Bearbeiten der Proxyadresse im Abschnitt manuelle Proxyeinrichtung im Menü „Windows-Proxyeinstellungen“ nicht das Präfix http:// zur Proxyadresse hinzu. Dadurch werden .NET-basierte Anwendungen wie der Roboter gezwungen, den Proxy nur für HTTP Aufrufe zu verwenden, und da die meisten Aufrufe HTTPS sind, kann die Proxykonfiguration nicht verwendet werden. Um dieses Problem zu beheben, entfernen Sie entweder das http://Präfix insgesamt oder fügen Sie die Proxyadresse explizit mit beiden http:// Präfixen https:// hinzu.Beispiel:

• http://proxyaddress -> falsch
• https://proxyaddress -> richtig
• http://proxyaddress;https://proxyaddress -> richtig

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 uipath.config‑Datei und starten Sie den UiPath-Roboterdienst neu, damit die Änderungen wirksam werden.
   Hinweis:

   Starting with v2021.4 Robot, the bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass.

Proxyauthentifizierung über Windows-Anmeldeinformationen

Ab v2021.4.4 funktioniert der Roboter mit Proxykonfigurationen, die die Authentifizierung über Windows-Anmeldeinformationen verwenden.

Hinweis:

Es sollte nur eines von ScriptAddress und ProxyAddressfestgelegt werden. Wenn beide festgelegt sind, ScriptAddresshat das Präfix Vorrang.BypassList und BypassLocalAddresses sollten nur festgelegt werden, wenn ProxyAddress festgelegt ist.

Einfache Authentifizierung

Ab Release v2021.10 unterstützt der Roboterdienst Proxy-Server mit Standard-Authentifizierungsprotokollen.

Dienstmodusroboter

Um diese Funktion zu aktivieren, wenn der Roboter im Dienstmodus installiert ist, müssen Sie den Abschnitt webProxySettings aus der Datei uipath.config bearbeiten und die folgenden Informationen hinzufügen:

<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>

Wichtig:

The Robot Executor does not support proxy configurations using Basic Authentication methods. This means you can use Basic Authentication to connect to Orchestrator and download packages, but not for the actual workflow.

Benutzermodusroboter

Wenn der Roboter im Benutzermodus installiert wird, erkennt UiPath Assistant automatisch, dass eine Proxykonfiguration mit Standardauthentifizierung auf der Maschine vorhanden ist, und fordert den Benutzer zur Eingabe eines Benutzernamens und eines Kennworts auf.

Prüfen der Proxy-Server-Verbindung

1. Verbinden Sie den Roboter 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.
   Hinweis:

   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.