robot
2024.10
false
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l’administrateur du Robot

Dernière mise à jour 17 févr. 2025

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.
    docs image
    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.pacUiPathStudio.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"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.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White