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.

Création d'une connexion

1. Accéder à Automation Suite.
2. Dans le menu de gauche, sélectionnez Integration Service. La fenêtre Integration Service comprend trois onglets distincts : Connecteurs, Connexions et Déclencheurs. Par défaut, l'onglet Connecteurs est sélectionné. Seuls les connecteurs installés dans votre environnement local s'affichent.

1. Dans la section Mes dossiers, vous pouvez choisir si vous souhaitez travailler dans votre espace de travail personnel ou dans un dossier partagé, où les connexions créées peuvent être utilisées par tous les utilisateurs qui ont accès à ce dossier.

2. Sélectionnez le connecteur souhaité pour créer une nouvelle connexion ou mettre à jour une connexion existante.
3. Sélectionnez Connect to <connector name>. Selon le connecteur que vous avez choisi, les informations d'identification spécifiques requises pour vos connexions sont demandées.

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.

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.

Modification des connexions

1. Dans la barre de gauche, sélectionnez Integration Service. La fenêtre Integration Service comprend trois onglets distincts : Connecteurs, Connexions et Déclencheurs.
2. Sélectionnez le Dossier dans lequel vous souhaitez modifier la connexion.
   Remarque :

   Le dossier dans lequel vous souhaitez créer la connexion peut également être sélectionné après l'étape 4.

3. Go to the Connections tab, where the list of created connections is displayed.
4. Sélectionnez le bouton Plus correspondant à la connexion souhaitée pour la modifier. Vous pouvez effectuer les actions suivantes :
   • Supprimez la connexion.
   • Définissez-le par défaut (cette option n'est disponible que si plusieurs connexions sont établies pour la même application.
   • Vérifiez la connexion pour vérifier son statut.

Renommer les connexions

Pour renommer une connexion, vous devez :

1. Access the Connections tab.
2. Dans le menu de gauche, sélectionnez Integration Service. La fenêtre Integration Service comprend des onglets distincts pour les connecteurs, les connexions et les déclencheurs, ainsi qu'une fenêtre de navigation de gauche affichant les dossiers.
3. Sélectionnez le Dossier dans lequel vous souhaitez modifier la connexion.
   Remarque :

   Le dossier peut être sélectionné après l'étape 4.

4. Go to the Connections tab, where the list of created connections is displayed.
5. Pointez avec le curseur de la souris sur le nom de la connexion que vous souhaitez modifier. Le bouton Modifier s'affiche.
   Remarque :

   Alternatively, you can select your connection from the list to access the detailed view. The Edit button is located on the right side of your connection name.

6. Sélectionnez le bouton Modifier et vous pouvez choisir un nouveau nom pour votre connexion.

Sélection du type d'authentification

Certains connecteurs d'Integration Service prennent en charge plusieurs méthodes d'authentification. Vous pouvez sélectionner votre méthode préférée avant de lancer une connexion.

1. Dans Integration Service, dans la liste Connecteurs , sélectionnez un connecteur pris en charge.
2. Sélectionnez Se connecter à <connector name> pour accéder à la page de configuration de la connexion.
3. Utilisez la liste déroulante Dossier dans lequel la connexion est stockée pour choisir le dossier approprié (par exemple, Mon espace de travail).
4. Utilisez la liste déroulante Type d’authentification pour choisir parmi les options disponibles, telles que :
   • 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 peuvent varier en fonction du connecteur.

5. Saisissez les informations d’identification requises pour le type d’authentification sélectionné, puis sélectionnez Connecter pour établir la connexion.

Apportez votre propre application OAuth 2.0

UiPath Integration Service propose un modèle d'application Apporter votre propre OAuth 2.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.

Remarque :

Lorsque vous utilisez Integration Service dans un environnement local, si vous devez vous authentifier à l'aide d'un ID client et d'une clé secrète, vous devez créer votre propre application OAuth 2.0, similaire à l'option Apporter votre propre OAuth 2.0 .

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 OAuth 2.0. Les autres types OAuth 2.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 OAuth 2.0 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://{yourDomain}/provisioning_/callback pour Automation Suite). 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://{yourDomain}/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. Dans Integration Service, dans la liste Connecteurs , sélectionnez le connecteur souhaité, puis cliquez sur Connecter pour ouvrir la page de création de la connexion.

2. Si plusieurs types d'authentification sont disponibles, sélectionnez le type d'authentification Apporter votre propre application OAuth 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.

Remarque :

Si votre organisation utilise BYOA, vous pouvez définir des valeurs par défaut pour ces informations d'identification via une politique de gouvernance Integration Service dans Automation Ops. Pour de plus amples informations, consultez la section Paramètres des politiques Integration Service.

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 des connexions, consultez Résolution des problèmes liés aux connexions.