Rediriger les Robots vers un serveur proxy

Remarque 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 via un serveur proxy, vous devez effectuer certaines configurations sur la machine Robot. Elles sont divisées selon les étapes suivantes :

• 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é.
• Modifiez les fichiers uipath.config de configuration du Robot et de NuGet, afin de 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 paquets d'activités et les processus d'automatisation peuvent être téléchargés par le biais du serveur proxy spécifié.
  Remarque :

  Le robot mode utilisateur hérite des paramètres proxy des options Internet, tandis que le robot de mode de service requiert une configuration spécifique à faire dans le fichier uipath.config à partir du dossier d'installation de Studio.

  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 : les paramètres du fichier uipath.config s'appliquent au processus de service robot uniquement lorsque celui-ci est installé en mode service. Les paramètres de proxy des processus Windows au niveau utilisateur, y compris l'exécuteur (pour les installations en mode utilisateur et en mode service), ne sont pas configurables via uipath.config.

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 > Options Internet. La fenêtre Options Internet (Internet Options) s'affiche.
   
   

   

   
   
2. Dans l’onglet Connexions (Connections), cliquez sur Paramètres LAN (LAN settings). La fenêtre Paramètres du réseau local (Local Area Network, 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.
4. Saisissez l'URL d'Orchestrator dans votre navigateur web afin de tester la connexion.
   
   

   

   
   
   Important :

   Lors de la configuration ou de la modification de l'adresse proxy, n'ajoutez pas le préfixe http:// à l'adresse proxy. Cela active le proxy uniquement pour les appels HTTP, et comme la plupart des appels sont HTTPS, la configuration du proxy échoue.

   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

   • http=proxyaddress;https=proxyaddress -> correct

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

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

      Remarque : À partir de la version v2021.4 Robot, la liste de contournement doit contenir un tableau de chaînes d'expressions régulières contenant les URI des serveurs à contourner.
4. Enregistrez le fichier uipath.config et redémarrez le service de robot UiPath pour que les modifications prennent effet.

Exemples de liste de contournement

Vous trouverez ci-dessous des exemples de format pour la liste de contournement.

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

Pour tester le formatage des configurations complexes, vous pouvez utiliser un validateur/générateur de regex.

Remarque : À partir de la version v2021.4 Robot, la liste de contournement doit contenir un tableau de chaînes d'expressions régulières contenant les URI des serveurs à contourner.

Important :

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

exemple : UIPATH_PROXY_USE_DEFAULT_CREDENTIALS avec la valeur true

Configurer l'authentification de Windows Credentials Proxy à l'aide de PowerShell

1. Ouvrez PowerShell en tant qu'administrateur.
2. Exécutez la commande ci-dessous :

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

3. Redémarrez la machine Insights.

Valider le script

Afin de confirmer que la variable d'environnement système a été correctement définie, exécutez le script ci-dessous dans PowerShell.

$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Renvoie la valeur de la variable d'environnement système. Si la valeur est true, cela signifie qu'il s'agit de la configuration actuellement appliquée.

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 : L'exécuteur Robot ne prend pas en charge les configurations de proxy à l'aide des méthodes d'authentification de base. Cela signifie que vous pouvez utiliser l'authentification de base pour vous connecter à Orchestrator et télécharger des packages, mais non pour le workflow lui-même.

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 fichier uipath.config afin de correspondre au nouveau format.