Rediriger les Robots vers un serveur proxy

Si un Robot se trouve dans un réseau fermé, ou dans un réseau différent de celui d'Orchestrator, la communication entre les deux produits UiPath est impossible. Vous pouvez cependant utiliser un serveur proxy avec votre Robot pour établir la communication.

Pour rediriger le Robot vers un serveur proxy, il est nécessaire de configurer la machine Robot selon les étapes décrites ci-dessous.

1. Assurez-vous que votre navigateur web par défaut est configuré pour permettre à la machine Robot d'accéder à Orchestrator grâce au serveur proxy indiqué.
2. Modifiez le fichier UiPath.config pour vous assurer, d’une part, que la connexion entre le Robot et Orchestrator passe bien par le serveur proxy fourni et, d’autre part, que les packages d’activités et les processus d’automatisation peuvent être téléchargés par le biais du serveur proxy spécifié.

Remarque :

• The user mode robot inherits the Proxy Settings from the Internet Options, while the service mode robot requires specific configuration to be made in the uipath.config file from the Studio installation folder .

• Live Streaming and Interactive Sign-In features: For service-mode robots, you must configure the proxy settings in both the uipath.config file and Windows Settings for the user under which the robot runs.

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

Important :

Lorsque le robot est installé en mode utilisateur, pour utiliser des configurations de proxy qui nécessitent une authentification de base (non Windows) pour l'exécution du processus, les informations d'identification doivent être ajoutées au gestionnaire d'informations d'identification de la machine, car les paramètres du fichier uipath.config ne s'appliquent qu'au robot en mode service.

Avertissement :

Les fonctionnalités de diffusion en direct et de contrôle à distance ne fonctionnent pas dans une configuration proxy pour les versions du robot antérieures à la version 2024.10.5. Mettez à niveau votre robot vers les versions 2024.10.5+ pour accéder à ces fonctionnalités dans une configuration proxy.

Configuration des paramètres proxy

Les configurations du script proxy ou de l’adresse proxy peuvent être définies à partir de la section Connexions dans les options Internet ou à partir du menu Paramètres proxy dans les paramètres Windows.

Configuration du navigateur web

1. Dans Internet Explorer, cliquez sur Outils & gt; Options Internet pour ouvrir la fenêtre Options Internet.

   

2. Dans l’onglet Connexions, cliquez sur Paramètres LAN. La fenêtre Paramètres du Réseau local (LAN) s’affiche. Selon votre configuration, vous pouvez définir un script de configuration proxy ou un serveur proxy.

   

3. Configurez le serveur proxy ou la configuration automatique (pour script proxy).

4. Cliquez sur OK (OK). Vos paramètres sont enregistrés.

5. Saisissez l'URL d'Orchestrator dans votre navigateur web afin de tester la connexion.

Configuration des paramètres proxy de Windows

1. Ouvrez le menu de démarrage et recherchez les paramètres proxy.
2. Configurez la configuration proxy automatique (pour un script proxy) ou la configuration proxy manuelle (pour un serveur proxy).
3. Enregistrez les paramètres.

Saisissez l'URL d'Orchestrator dans votre navigateur web afin de tester la connexion.

Important :

When setting up or editing the proxy address in the manual proxy setup section from the Windows Proxy Settings menu, do not add the http:// prefix to the proxy address. This forces .NET-based applications such as the Robot to use the proxy only for HTTP calls, and since most calls are HTTPS, the proxy configuration cannot be used.

Pour résoudre ce problème, assurez-vous de supprimer complètement le préfixe http:// ou d'ajouter spécifiquement l'adresse proxy avec les deux préfixes http:// et https://.

Exemple :

• http://proxyaddress -> incorrect
• https://proxyaddress -> corriger
• http://proxyaddress;https://proxyaddress -> corriger

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.

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

   <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 et redémarrez le service de robot UiPath pour que les modifications prennent effet.

Remarque :

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.

Authentification du proxy des informations d'identification Windows

À partir de la version 2021.4.4, le Robot peut fonctionner avec des configurations de proxy recourant à l'authentification via les identifiants Windows.

Pour activer cette fonctionnalité, ajoutez la variable d'environnement système UIPATH_PROXY_USE_DEFAULT_CREDENTIALS à la machine true.

Remarque :

Une seule des ScriptAddress et ProxyAddress doit être définie. Si les deux sont définies, préférez ScriptAddress.

BypassList et BypassLocalAddresses ne doivent être définies que si ProxyAddress est définie.

Authentification de base

À partir de la version 2021.10, le Robot prend en charge les serveurs proxy utilisant les protocoles d'authentification de base.

Robot en mode de service

Pour activer cette fonctionnalité lorsque le robot est installé en mode service, vous devez modifier la section webProxySettings du fichier uipath.config et ajouter les informations suivantes :

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

Important :

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.

Robot en mode utilisateur

Lorsque le robot est installé en mode utilisateur, l'UiPath Assistant détecte automatiquement qu'une configuration proxy d'authentification de base est en place sur la machine et invite l'utilisateur à saisir un nom d'utilisateur et un mot de passe.

Vérification de la connexion au serveur proxy

1. Connecter le Robot à 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.

   Remarque :

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