Rediriger les Robots vers un serveur proxy

Pour qu’un Robot puisse établir une communication directe avec Orchestrator, il doit se trouver sur le même réseau ou utiliser un réseau ouvert. Sinon, vous devez configurer un serveur proxy pour faciliter la communication.

Configurez un proxy en utilisant un script proxy ou en fournissant l’adresse du serveur proxy avec une liste d’adresses à contourner. Une seule méthode peut être utilisée. Si les deux sont configurées, le script proxy est prioritaire.

Les options de configuration suivantes sont disponibles :

• Configuration du navigateur web

• Configuration des paramètres proxy de Windows

• Configuration du paramètre proxy via les paramètres de ligne de commande

• Modification du fichier uipath.config

Attention : lors de la mise à jour des versions antérieures à v2021.4, les configurations proxy sont migrées du fichier proxy.config vers le fichier uipath.config afin de correspondre au nouveau format.

Proxy pour les robots en mode utilisateur

Les robots en mode utilisateur héritent des paramètres de proxy configurés pour votre navigateur Web.

Pour les paramètres de proxy qui nécessitent une authentification de base non Windows, stockez les informations d’identification nécessaires dans le gestionnaire des informations d’identification de la machine.

Important :

Pour appliquer les paramètres du proxy aux robots en mode utilisateur, vous devez redémarrer le service hôte utilisateur. Vous pouvez le faire en vous déconnectant de la session utilisateur Windows, puis en vous reconnectant.

Proxy pour les robots en mode de service

Pour utiliser correctement les paramètres de proxy des robots en mode de service avec les fonctionnalités de connexion interactive et de flux en direct, vous devez modifier à la fois le fichier uipath.config et les paramètres Windows correspondants du compte utilisateur exécutant le Robot.

Paramètres de proxy basés sur les types d’utilisateurs (exécuteur)

Dans un contexte UiPath, les processus Windows peuvent s’exécuter sous deux identités distinctes :

• Utilisateur local : ces processus s’exécutent sous l’identité de l’utilisateur actuellement connecté à la session Windows.

• Utilisateurs du SystèmeLocal : ces processus sont généralement des services ou des tâches d’arrière-plan s’exécutant avec des privilèges au niveau du système.

Lors de la configuration d’un proxy dans Windows, les paramètres du proxy sont liés à l’utilisateur exécutant le processus. Par conséquent, en fonction de l’identité du processus effectuant la requête HTTP, deux scénarios sont possibles pour la configuration du proxy :

• Le proxy utilisé est celui défini pour l’utilisateur dans Windows.

• Les paramètres de proxy sont chargés à partir du fichier uipath.config.

Le tableau ci-dessous résume les processus Windows liés aux Robots, les identités d’utilisateurs sous lesquelles ils s’exécutent, ainsi que les requêtes HTTP qu’ils effectuent :

Processus Windows	Identité de l'utilisateur	Requêtes HTTP
UiPath.ServiceHost.exe	SystèmeLocal	Responsable de la communication de service avec Orchestrator, notamment les tâches suivantes : Récupérer les pulsations Récupérer les tâches et soumettre les états de tâches Gestion des journaux pour les processus Unattended Gestion de l’authentification pour le service Téléchargement de packages
UiPath.UserHost.exe	Utilisateur (User)	Responsable de la communication de service avec Orchestrator lorsqu’il est installé en mode utilisateur, notamment les tâches suivantes : Récupérer les pulsations Gérer les journaux pour les processus Gérer l’authentification pour l’Assistant Téléchargement de packages
UiPath.Executor.exe	SystèmeLocal (lors de l’exécution d’une tâche en arrière-plan) Utilisateur (lors de l’exécution de tâches normales)	Responsable du traitement des requêtes HTTP spécifiques à l’automatisation, notamment les tâches suivantes : Gérer les ressources et les éléments de file d’attente Envoyer des requêtes spécifiques aux activités (requêtes HTTP vers services externes)
UiPath.Assistant.exe	Utilisateur (User)	Responsable de la gestion du trafic lié à Assistant, notamment : Gestion de la liste des processus Gestion des déclencheurs Interactions avec Marketplace
UiPath.RemoteDebugging.Agent.exe	Utilisateur (User)	Responsable de la gestion du trafic de débogage à distance via SignalR.
UiPath.UpdateService.Worker.exe	SystèmeLocal	Responsable du téléchargement des MSI depuis Orchestrator.

Le processus de mise à jour automatique pour les configurations de proxy

Vous pouvez configurer le processus de mise à jour automatique pour les Robots fonctionnant derrière un proxy, en fonction du type d'installation du Robot :

Pour les installations Unattended, l'agent de mise à jour est absent. Les configurations du proxy sont gérées manuellement en modifiant le fichier UiPath.config . Le service de Robot et le service de mise à jour s'exécutent à l'aide d'un service Windows, indépendamment d'un utilisateur.

Pour les installations Attended, les configurations du proxy sont également gérées manuellement en modifiant le fichier UiPath.config . Cependant, l'utilisateur démarre à la fois le service de robot UiPath et l'agent de mise à jour. Le service de mise à jour s'exécute à l'aide d'un service Windows.

Pour les installations rapides, les configurations du proxy sont héritées des paramètres utilisateur existants. L'utilisateur lance tous les services : Service de robot (Robot Service), Agent de mise à jour (Update Agent) et Service de mise à jour (Update Service).

Authentification du proxy des informations d'identification Windows

Le serveur proxy peut nécessiter des informations d’identification pour autoriser le trafic. Vous pouvez configurer le proxy pour qu’il s’authentifie à l’aide des informations d’identification de l’utilisateur Windows connecté.

Pour activer cette fonctionnalité, ajoutez la variable d’environnement système UIPATH_PROXY_USE_DEFAULT_CREDENTIALS à la machine exécutant le Robot et définissez sa valeur sur true. Cela indique au Robot d’utiliser les informations d’identification Windows de l’utilisateur actuel pour l’authentification du proxy.

Authentification de base

À partir de la version 2021.10, le service de robot UiPath prend en charge les serveurs proxy utilisant les protocoles d’authentification de base.

Robots en mode utilisateur : avec l’authentification de base, l’Assistant identifie si une configuration de proxy est implémentée sur la machine et invite l’utilisateur à saisir ses informations d’identification.

Robots en mode de service : l’exécuteur Robot ne prend pas en charge les méthodes d’authentification de base pour les configurations de proxy. Bien que vous puissiez utiliser l’authentification de base pour vous connecter à Orchestrator et télécharger des packages, vous ne pouvez pas l’utiliser dans l’exécution réelle du workflow. Pour activer l’authentification de base pour les robots en mode de service, mettez à jour le fichier UiPath.config avec les paramètres de proxy suivants :

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

Flux en direct et contrôle à distance dans une configuration proxy

Avertissement :

Les fonctionnalités de flux en direct et de contrôle à distance ne fonctionnent pas dans une configuration proxy pour les versions de Robot antérieures à 2024.10.5. Mettez à niveau votre Robot vers les versions 2024.10.5 et ultérieures pour accéder à ces fonctionnalités dans une configuration proxy.

Configuration du navigateur web

1. Ouvrez la fenêtre Propriétés Internet.
2. Dans l’onglet Connexions, sélectionnez Paramètres LAN. La fenêtre Paramètres du réseau local (LAN) s’ouvre. Selon votre configuration, vous pouvez définir un script de configuration proxy ou un serveur proxy.
   
   1. Pour utiliser un script proxy, sélectionnez Utiliser le script de configuration automatique et fournissez l’adresse au script.
   2. Pour configurer manuellement le serveur proxy, sélectionnez Utiliser un serveur proxy pour votre réseau local, puis indiquez l’adresse du serveur proxy et le port.
3. Pour enregistrer vos paramètres, sélectionnez OK.
4. Dans votre navigateur Web, testez la connexion en accédant à l’URL Orchestrator.

Configuration des paramètres proxy de Windows

1. Ouvrez la fenêtre de paramètres du proxy.
2. Pour utiliser un script proxy, sous Configuration proxy automatique, activez Utiliser le script de configuration. Indiquez l’adresse du script.
3. Pour configurer manuellement le serveur proxy, sous Configuration manuelle du proxy, activez l’option Utiliser un serveur proxy. Indiquez l’adresse du serveur proxy et le port.
   Important :

   L’ajout du préfixe http:// à l’adresse du serveur proxy empêche le Robot de passer des appels HTTPS. Pour vous assurer que le proxy fonctionne comme prévu, supprimez entièrement le préfixe http:// ou ajoutez l’adresse proxy avec les deux préfixes http:// et https://.

   Par exemple :

   • Incorrect - http=proxyaddress
   • Correct - http=proxyaddress;https=proxyaddress
   • Correct - http://proxyaddress;https://proxyaddress
4. Pour enregistrer vos paramètres, sélectionnez Enregistrer.

Modification du fichier uipath.config

1. Accédez au dossier d'installation : %ProgramFiles%\UiPath\Studio.
2. Cherchez le fichier uipath.config et ouvrez-le à l'aide d'un éditeur de texte, comme par exemple Notepad++.
3. Ajoutez la balise <webProxySettings> et définissez les valeurs en fonction de votre environnement proxy.
   1. Pour utiliser un script proxy, fournissez la paire clé-valeur suivante :

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

   2. Pour fournir une adresse proxy, fournissez les paires clé-valeur suivantes :

      <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. Enregistrez le fichier uipath.config.
5. Redémarrez le service de robot UiPath.

Configuration des paramètres du proxy lors de l’installation du Robot

Pour ajouter les paramètres du proxy lors de l’installation des robots en mode de service, utilisez les paramètres de ligne de commande dédiés dans votre commande d’installation.

Par exemple, la commande suivante installe le Robot en mode service et utilise un script pour configurer le proxy :

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

La commande suivante installe le Robot en mode service et configure l’authentification de base pour les paramètres de proxy :

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

Vérification de la connexion au serveur proxy

1. Établissez une connexion entre le Robot et Orchestrator.
2. Déployez des paquets sur un environnement contenant le Robot précédemment configuré.
3. Accéder au dossier %userprofile%\.nuget\ pour vérifier que les processus et paquets d'activités correspondants ont bien été téléchargés.
4. Exécutez la tâche correspondante pour vérifier son bon fonctionnement.