Connexions

À propos des connexions

Les connexions aident à établir des tâches entre des utilisateurs uniques et des applications externes. Les connexions sont créées une fois que les utilisateurs s'authentifient auprès d'un fournisseur d'API.

Prérequis

Avant de pouvoir utiliser des connexions, assurez-vous que les conditions suivantes sont remplies :

• Integration Service est activé et enregistré pour votre locataire.
• Les utilisateurs qui travaillent avec des connexions disposent des autorisations nécessaires dans Orchestrator. Pour créer une connexion, un utilisateur doit disposer de l'autorisation Connexions - Création dans le dossier cible. Pour plus d'informations sur les autorisations, consultez Configurer l'accès pour les comptes dans le guide de l'utilisateur Orchestrator.

Connexions dans Orchestrator

Important :

À partir de mars 2026, vous pouvez créer de nouvelles connexions Integration Service dans Orchestrator. Les connexions Integration Service existantes continueront d'être visibles dans l'onglet Connexions d'Integration Service jusqu'en juillet 2026 (cette date est soumise à des extensions possibles). Après cette date, les connexions Integration Service existantes seront migrées vers Orchestrator et l'onglet Connexions de Integration Service sera supprimé. Il est prévu que cette modification soit d'abord disponible pour les utilisateurs Community, puis progressivement pour les utilisateurs Enterprise, en fonction des régions des organisations et des locataires. Lisez les notes de version d’Integration Service pour savoir quand le changement est annoncé pour la première fois.

Avantages clés de la gestion des connexions dans Orchestrator

Cette migration apporte plusieurs avantages majeurs :

• Moins de changement de contexte

  Vous pouvez désormais créer des ressources, des files d’attente, des déclencheurs et des connexions en un seul endroit, sans avoir à utiliser un autre menu de gauche. Moins de clics, moins de chargements de pages et une charge cognitive plus faible conduit à un workflow plus fluide.

• Facilité de résolution des problèmes

  Lorsque les exécutions échouent, vous êtes déjà dans Orchestrator et examinez les tâches, les files d'attente ou les journaux. Vous pouvez désormais afficher et gérer la connexion associée dans la même interface, ce qui réduit le temps de résolution.

• Un modèle physique cohérent

  Orchestrator centralise déjà vos ressources. La gestion des connexions avec les ressources et les déclencheurs garantit une expérience plus intuitive et cohérente.

Connexions partagées

Lorsqu'une connexion est créée dans un dossier partagé, tous les utilisateurs ayant accès à ce dossier peuvent utiliser la connexion dans leurs workflows d'automatisation. La connexion peut être modifiée par tous les utilisateurs qui y ont accès.

Nous vous recommandons de créer des connexions pour lesquelles l'authentification se fait via des comptes personnels dans des Espaces de travail personnels et de n'utiliser que des dossiers partagés pour les connexions où l'authentification est effectuée via des comptes de service. Les administrateurs peuvent empêcher les utilisateurs réguliers de créer des connexions partagées Integration Service dans les dossiers d'équipe. Pour de plus amples informations, consultez la section Appliquer la gouvernance de la connexion Integration Service au niveau utilisateur dans le Guide de l'utilisateur d'Orchestrator.

Remarque :

Tous les connecteurs Integration Service prennent en charge le partage de connexion et la configuration au moment de l'exécution. Pour plus d'informations sur la configuration des connexions au moment de l'exécution, consultez le Guide de l'utilisateur d'Orchestrator.

Création d'une connexion

L'onglet Connexions d'Orchestrator fournit un emplacement central pour la création et la gestion des connexions. Vous pouvez également créer des connexions directement à partir des automatisations dans UiPath Studio, UiPath Studio Web ou UiPath Assistant.

Pour créer une connexion dans Orchestrator, procédez comme suit :

1. Sélectionnez Orchestrator dans le lanceur du produit.
2. Sélectionnez un dossier, puis accédez à l'onglet Connexions .
3. Sélectionnez Ajouter une connexion (Add connecion).
4. Pour ouvrir la page de création de connexion, sélectionnez le connecteur dans la liste. Vous pouvez utiliser la barre de recherche pour trouver le connecteur.
5. Sélectionnez le type d'authentification (le cas échéant), saisissez les informations d'identification requises, puis sélectionnez Connect.

Pour de plus amples informations, consultez la section Gérer les connexions dans le guide de l'utilisateur d'Orchestrator.

Remarque :

Pour créer avec succès une connexion, vous devez configurer une liste d’autorisations d’adresses IP pour Integration Service. Pour de plus amples informations, consultez la section Configuration du pare-feu dans le Guide d'administration d'Automation Cloud.

Sélection du type d'authentification

Certains connecteurs Integration Service prennent en charge plusieurs types d'authentification. Vous allez sélectionner le type lors de la création de la connexion. Les options disponibles peuvent inclure :

• Code d'autorisation OAuth 2.0
• Mot de passe OAuth 2.0
• Apportez votre propre application OAuth 2.0
• Jeton d’accès personnel (PAT)

Remarque :

Les options disponibles varient en fonction du connecteur.

Gérer les connexions

Vous pouvez gérer toutes les connexions en un seul endroit à partir de l'onglet Connexions dans Orchestrator. Vous pouvez y vérifier l'état des connexions, vous reconnecter, gérer les déclencheurs, modifier les détails de la connexion tels que le nom et l'intervalle d'interrogation, et supprimer des connexions.

Pour de plus amples informations, consultez la section Gérer les connexions dans le guide de l'utilisateur d'Orchestrator.

Gestion des connexions à partir de l’Assistant UiPath

Vous pouvez gérer les connexions Integration Service directement depuis UiPath Assistant. Pour en savoir plus, consultez Connexions dans UiPath Assistant.

Sélectionnez Configurer dans le navigateur pour ouvrir la page Connexions dans Studio Web. Pour en savoir plus, consultez la section Gérer les connexions dans le guide de l’utilisateur de Studio Web.

Remarque :

Les utilisateurs d’Automation Cloud pour le secteur public peuvent afficher les connexions dans UiPath Assistant, mais pas les gérer. Au lieu de cela, ils peuvent configurer et gérer les connexions Integration Service à l'aide de l'onglet Exigences du package dans Orchestrator.

Apportez votre propre application OAuth 2.0

UiPath Integration Service propose un modèle d'application Apporter votre propre Oauth2.0 (BYOA) qui permet aux entreprises de se connecter à l'aide de leurs propres applications OAuth 2.0 au lieu de l' application OAuth publique enregistrée par UiPath par défaut.

UiPath enregistre et gère les applications OAuth 2.0 sur les portails de développement des fournisseurs pour la majorité des connecteurs (par exemple, Microsoft, Google, Salesforce, Atlassian Jira, etc.). Dans la plupart des cas, ces applications sont livrées avec des étendues prédéfinies et sont entièrement gérées par UiPath.

Cependant, il est possible que certaines organisations aient des politiques informatiques, de sécurité ou de conformité strictes qui les empêchent d’utiliser des enregistrements d’applications externes. Dans de tels cas, l’authentification BYOA permet aux clients d’utiliser leur propre ID client et leur propre clé secrète client pour s’authentifier et autoriser les connexions Integration Service.

Scénarios courants d’utilisation de l’option BYOA

Utilisez BYOA lorsque :

• L'application prend en charge le type d'authentification d'octroi de code d'autorisation OAuth2.0. Les autres types OAuth2.0 ne peuvent pas être utilisés sous BYOA.
• Votre entreprise exige que toutes les intégrations tierces utilisent des applications OAuth gérées en interne.
• Vous devez ajouter ou modifier des étendues qui ne font pas partie de l'application enregistrée par défaut d'UiPath.
• Les politiques de sécurité ou de conformité de votre organisation interdit l'utilisation partagée d'applications.
• Vous souhaitez contrôler le cycle de vie de l'application OAuth, y compris la rotation des clés secrètes.

Remarque :

Les applications OAuth  publiques de UiPath utilisent des étendues fixes et ne peuvent pas être modifiées par demande d'un client. Si vous avez besoin d’étendues supplémentaires, l’option BYOA est la bonne option.

Fonctionnement de l’option BYOA

Lors de la création d'une connexion dans Integration Service, vous pouvez sélectionner Apporter votre propre application Oauth2 comme type d'authentification.

Cela vous permet de saisir :

• ID client et Secret client : les informations d'identification obtenues lors de l'enregistrement de votre application dans le portail de développement du fournisseur.
• Étendues : autorisations requises par le connecteur.
• URI de redirection : URL de rappel non modifiable (https://cloud.uipath.com/provisioning_/callback pour Automation Cloud). Il s’agit de l’URL de rappel qu’Integration Service utilise pour terminer le flux OAuth.

Integration Service utilise vos informations d'identification pour exécuter le flux OAuth et stocke en toute sécurité les jetons d'accès et de réactualisation obtenus.

Configuration d'une connexion BYOA

Étape 1 : enregistrer une application OAuth sur le portail du fournisseur

Créez une application OAuth 2.0 dans le portail de développement du fournisseur (par exemple, Salesforce, Microsoft, Jira ou Google). Pendant l’enregistrement :

• Définissez l' URI de redirection/rappel sur https://cloud.uipath.com/provisioning_/callback.
• Ajoutez les étendues requises (consultez la documentation spécifique au connecteur pour les étendues obligatoires).
• Assurez-vous que le fournisseur prend en charge le type d'octroi requis par le connecteur (accord du code d'autorisation).

Étape 2 : créer une connexion dans Integration Service

1. Accédez à Integration Service > Connecteurs, sélectionnez le connecteur souhaité, puis cliquez sur Connecter.

2. Sélectionnez le type d'authentification Apporter votre propre application OAuth2 2.0.

3. Saisissez les détails suivants à partir de votre application enregistrée :

   • ID de client
   • Clé secrète du client
   • Étendues (sélectionnez depuis des étendues existantes ou saisissez-les manuellement)
   Remarque :

   De nombreux fournisseurs (Atlassian Jira, Coupa, etc.) s'attendent à ce que les mêmes étendues soient également présentes dans votre application.

4. Suivez les invites à l'écran pour compléter le flux de consentement OAuth en indiquant votre nom d'utilisateur et votre mot de passe sur la page de connexion du fournisseur.

5. Une fois autorisée, la connexion est stockée en toute sécurité et disponible à être utilisée.

6. Integration Service gère l'actualisation périodique du jeton d'accès.

Étape 3 : vérifier les étendues obligatoires

Chaque connecteur possède des étendues obligatoires requises pour ses activités et ses déclencheurs.

Si votre application BYOA n’inclut pas ces étendues, la création de la connexion échouera, ou bien certaines actions pourront ne pas fonctionner comme prévu.

Reportez-vous à la documentation du connecteur pour confirmer la liste des étendues obligatoires.

Meilleures pratiques

• utiliser un enregistrement d'application d'entreprise dédié pour UiPath Integration Service ; éviter de réutiliser des ID d'application provenant d'intégrations non liées.
• Incluez uniquement les étendues nécessaires pour l'accès avec le moins de privilèges.
• Conservez une rotation périodique des clés secrètes du client et mettez-les à jour dans Integration Service en modifiant les connexions.
• Documentez la propriété de l'application et assurez-vous de la continuité si les administrateurs changent.
• Vérifiez que les URI de redirection correspondent exactement à la valeur affichée dans Integration Service ; les URI non correspondants provoquent des erreurs OAuth.

Sécurité et maintenance

• Les informations d’identification BYOA sont chiffrées et stockées en toute sécurité dans UiPath Integration Service et ne sont jamais exposées en texte brut.
• UiPath ne gère ni ne surveille les informations d’identification ou les étendues de vos applications personnalisées.
• La rotation des clés secrètes, le désenregistrement de l'application ou la maintenance de l'étendue relève du client.

Problèmes couramment rencontrés

Le tableau suivant répertorie les problèmes courants rencontrés lors de l’utilisation de connexions BYOA, ainsi que leurs causes et solutions possibles.

Problème	Cause possible	Résolution
Client ou secret non valide	ID ou clé secrète client incorrecte.	Vérifiez les informations d’identification de l’inscription de l’application du fournisseur.
Ne correspond pas à l’URI de redirection	L'URI de redirection dans l'application du fournisseur ne correspond pas à la valeur d'UiPath.	Mettez à jour l'URI de redirection dans l’inscription de l’application du fournisseur.
Étendues insuffisantes ou accès refusé	Étendues obligatoires manquantes dans l’application de fournisseur.	Ajoutez les étendues requises et relancez l’autorisation.
Jeton expirant fréquemment	Application fournisseur configurée avec des jetons de durée courte.	Activez les jetons d'actualisation dans l'application ou étendez la validité des jetons.

Connexions dans les solutions

Vous pouvez gérer les connexions et les déclencheurs d’événement dans le cadre de votre package de solution. Reportez-vous à la section Présentation de la gestion des solutions pour savoir ce que sont les packages de solutions, leur fonctionnement et comment les créer, les gérer et les déployer.

Lorsque vous créez un package de solution, les connexions et leurs déclencheurs d'événement associés sont disponibles dans le panneau Composants . Vous pouvez modifier les propriétés suivantes : Nom de connexion, Description de la connexion ) et Type d'authentification. Pour les déclencheurs d'événement, vous pouvez effectuer les mêmes étapes de configuration que dans Orchestrator.

Remarque :

Vous pouvez également modifier ces champs au moment du déploiement, sauf s’ils sont verrouillés pour la modification.

Une fois la solution créée et publiée, les connexions sont disponibles dans le panneau Composants de la solution. Toutes les connexions sélectionnées lors de la création du package de solution peuvent désormais être déployées.

Solutions Management n’affiche pas les connexions pour les processus, sauf si un déclencheur d’événement est également connecté. Le problème peut avoir un impact sur le déploiement de la solution, nécessitant une configuration manuelle de la connexion pour un fonctionnement correct.

Vous pouvez choisir de déployer le package de solution dans un dossier spécifique qui n'existe pas encore dans Integration Service. Dans ce cas, le dossier se crée automatiquement.

Type d’authentification de connexion

En tant qu'administrateur, vous décidez lors du déploiement d'utiliser une connexion existante, d'en créer une nouvelle ou d'autoriser l'utilisateur final à sélectionner la connexion.

Remarque :

Les solutions déplacent les connexions et leurs relations d'entités associées (telles que les workflows et les processus auxquels appartient la connexion), mais ne transfèrent pas les informations d'authentification.

Pendant le déploiement, l’administrateur peut définir le type d’ authentification sur :

• Configurable par les utilisateurs: aucune connexion n'est créée ou utilisée à partir de connexions existantes. Les utilisateurs doivent configurer la connexion après le déploiement de la solution au moment de l'exécution. Reportez-vous à la section Configurer les connexions dans la documentation d’Orchestrator.

• S'authentifier après le déploiement: une nouvelle connexion est créée et nécessite une authentification après le déploiement. La connexion reste inactive jusqu'à ce que l'étape d'authentification soit terminée.

  • Avant la fin de l'authentification, le nom d'utilisateur s'affiche sous la forme System. Une fois l'authentification réussie, le nom d'utilisateur est mis à jour pour afficher les informations d'identification de l'authentificateur.

Vous avez également la possibilité de lier les composants. Lorsque vous sélectionnez Lier à l'existant, une fenêtre contextuelle affiche toutes les connexions accessibles à l'utilisateur qui déploie le package de solution. Vous pouvez choisir n’importe quelle connexion existante afin de faire partie du package de solution.

Remarque :

Si vous sélectionnez des connexions existantes pour les connecteurs inclus dans le package de solution et que vous sélectionnez également un nouveau dossier lors du déploiement, le dossier sera créé dans Integration Service, sans connexion. Utilisez ce dossier si les préférences sont modifiées ou si de nouvelles connexions sont ajoutées.

L'option Lier à l'existant n'est pas disponible lorsque vous modifiez une configuration à l'aide des méthodes suivantes : Configuration du déploiement ou Modifier la configuration du déploiement. Pour lier les composants ou modifier le type d’authentification après le déploiement, vous devez mettre à niveau le package de solution. Cela nécessite de modifier la solution et de déployer à nouveau la nouvelle version.

Les connexions créées dans les dossiers via Solutions ne sont pas supprimées, même lors de la mise à niveau du workflow pour utiliser différentes connexions. Cela garantit que les processus et les automatisations reposant sur ces connexions ne sont pas impactés par la mise à niveau.

Résolution des problèmes de connexion

Pour plus d'informations sur la résolution des problèmes courants que vous pouvez rencontrer lors de l'utilisation de la connexion, consultez Résolution des problèmes liés aux connexions.