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 das des Orchestrators, ist die Kommunikation zwischen den beiden UiPath-Produkten nicht möglich. Um diese Kommunikation zu ermöglichen, können Sie einen Proxy-Server mit Ihrem Roboter verwenden.

Um den Roboter über einen Proxy-Server weiterzuleiten, müssen Sie einige Konfigurationsschritte auf der Roboter-Maschine vornehmen. Im Einzelnen:

• Konfigurieren Sie Ihren bevorzugten Webbrowser, um sicherzustellen, dass der Roboter-Computer über den angegebenen Proxy-Server auf den Orchestrator zugreifen kann.
• Bearbeiten Sie die Datei uipath.config, um sicherzustellen, dass die Verbindung zwischen dem Roboter und dem Orchestrator über den angegebenen Proxy-Server geführt wird, und dass die Aktivitäten und die 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.

  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: Die Einstellungen in der Datei uipath.config gelten für den Roboterdienst-Prozess nur dann, wenn dieser im Dienstmodus installiert ist. Proxyeinstellungen für Windows-Prozesse auf Benutzerebene, einschließlich des Executors (sowohl für Installationen im Benutzermodus als auch im Dienstmodus), sind nicht über uipath.config konfigurierbar.

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 für lokales Netzwerk (LAN) wird angezeigt. Je nach Einrichtung können Sie ein Proxykonfigurationsskript oder einen Proxyserver 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.
4. Geben Sie im Webbrowser die Orchestrator-URL ein, um die Verbindung zu testen.
   
   

   

   
   
   Wichtig:

   Fügen Sie beim Einrichten oder Bearbeiten der Proxyadresse nicht das Präfix http:// zur Proxyadresse hinzu. Dadurch wird der Proxy nur für HTTP-Aufrufe aktiviert. Da die meisten Aufrufe über HTTPS erfolgen, schlägt die Proxykonfiguration fehl.

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

   Beispiel:

   • http=proxyaddress -> incorrect

   • http=proxyaddress;https=proxyaddress -> correct

   • http://proxyaddress;https://proxyaddress -> correct

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>

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

Beispiele für Umgehungsliste

Nachfolgend finden Sie einige Beispiele für das Format der Umgehungsliste.

www.myget.org -> ((www|WWW).){1}?(myget+(.org))
.vo.msecnd.net -> (([a-zA-Z0-9]).)+((vo+)+(.msecnd+)+(.net))
www.nuget.org -> ((www|WWW).){1}?(nuget+(.org))
gallery.uipath.com -> (([a-zA-Z0-9]).)*((gallery+)+(.uipath+)+(.com))

Um die Formatierung für komplexe Konfigurationen zu testen, können Sie einen Regex-Validator/Generator verwenden.

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.

Wichtig:

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.

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.

Beispiel: UIPATH_PROXY_USE_DEFAULT_CREDENTIALS mit Wert true

Konfigurieren der Windows Credentials Proxy-Authentifizierung mit PowerShell

1. Öffnen Sie PowerShell als Administrator.
2. Führen Sie den folgenden Befehl aus:

   [Environment]::SetEnvironmentVariable("UIPATH_PROXY_USE_DEFAULT_CREDENTIALS", "true", "Machine")

3. Starten Sie die Robotermaschine neu.

Validieren des Skripts

Um zu bestätigen, dass die Systemumgebungsvariable erfolgreich festgelegt wurde, führen Sie das folgende Skript in PowerShell aus.

$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Dies gibt den Wert der Systemumgebungsvariablen zurück. Wenn der Wert true ist, ist die Konfiguration jetzt vorhanden.

Einfache Authentifizierung

Ab Version 2021.10 unterstützt der Roboter 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.

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.