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 von den Internetoptionen, während der Roboter im Dienstmodus eine bestimmte Konfiguration in der uipath.config-Datei aus dem Studio-Installationsordner erfordert.

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

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 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. Damit werden .NET-basierte Anwendungen wie Robot gezwungen, den Proxy nur für HTTP-Aufrufe zu verwenden. Da die meisten jedoch HTTPS-Aufrufe sind, kann die Proxykonfiguration nicht verwendet werden.

Um dieses Problem zu beheben, entfernen Sie entweder das Präfix http:// ganz oder fügen Sie die Proxyadresse explizit mit den beiden Präfixen http:// und https:// hinzu.

Beispiel:

• http=proxyaddress -> falsch
• http=proxyaddress;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: Ab Robot v2021.4 sollte die Umgehungsliste ein Array von Zeichenfolgen für reguläre Ausdrücke enthalten, die die URIs der zu umgehenden Server umfassen.

Proxyauthentifizierung über Windows-Anmeldeinformationen

Ab v2021.4.4 funktioniert der Roboter mit Proxykonfigurationen, die die Authentifizierung über Windows-Anmeldeinformationen verwenden. Um diese Funktion zu aktivieren, fügen Sie die Systemumgebungsvariable UIPATH_PROXY_USE_DEFAULT_CREDENTIALS auf der Maschine hinzu und setzen sie den Wert auf true.

Hinweis:

Es sollte entweder die ScriptAddress oder die ProxyAddress festgelegt werden. Wenn beide festgelegt sind, hat die ScriptAddress Vorrang.

Die BypassList und die BypassLocalAddresses sollten nur dann festgelegt werden, wenn die 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: Der Roboter-Executor unterstützt keine Proxykonfigurationen mit Standardauthentifizierungsmethoden. Das bedeutet, dass Sie die Standardauthentifizierung verwenden können, um eine Verbindung mit dem Orchestrator herzustellen und Pakete herunterzuladen, aber nicht für den eigentlichen 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.