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

Before you can use connections, make sure the following conditions are met:

• Integration Service is enabled and provisioned for your tenant.
• Users who work with connections have the necessary permissions in Orchestrator. To create a connection, a user must have the Connections - Create permission in the target folder. For more information on permissions, see Configuring access for accounts in the Orchestrator user guide.

Connexions dans Orchestrator

Important :

Starting with March 2026, you can create new Integration Service connections in Orchestrator. Existing Integration Service connections will continue to be visible on the Integration Service Connections tab until July 2026 (this date is subject to possible extensions). After this date, existing Integration Service connections will be migrated to Orchestrator, and the Connections tab in Integration Service will be removed. This change is scheduled to become available to Community users first, then to Enterprise users progressively, depending on organization and tenant regions. Follow the Integration Service release notes to learn when the change is first announced.

Key benefits of managing connections in 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

The Connections tab in Orchestrator provides a central location for creating and managing connections. You can also create connections directly from automations in UiPath Studio, UiPath Studio Web, or UiPath Assistant.

To create a connection in Orchestrator, follow these steps:

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Sélectionnez Ajouter une connexion (Add connecion).
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Select the authentication type (if applicable), enter the required credentials, and then select Connect.

For more details, refer to Managing connections in the Orchestrator user guide.

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

Some Integration Service connectors support multiple authentication types. You select the type when creating the connection. Available options can include:

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

Available options vary depending on the connector.

Gérer les connexions

You can manage all connections in one place from the Connections tab in Orchestrator. This is where you can check the health of connections, reconnect, manage triggers, edit connection details such as the name and polling interval, and delete connections.

For more details, refer to Managing connections in the Orchestrator user guide.

Managing connections from UiPath Assistant

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 offers a Bring your own Oauth2.0 app (BYOA) model that allows enterprises to connect using their own OAuth 2.0 applications instead of the default UiPath-registered public OAuth app.

UiPath registers and maintains OAuth 2.0 apps on vendor developer portals for the majority of connectors (for example, Microsoft, Google, Salesforce, Atlassian Jira, etc.). In most cases, these apps come with predefined scopes and are managed entirely by UiPath.

However, some organizations may have strict IT, security, or compliance policies that prevent them from using external app registrations. In such cases, BYOA enables customers to use their own Client ID and Client Secret to authenticate and authorize Integration Service connections.

Common scenarios for when to use BYOA

Use BYOA when:

• The application supports the OAuth2.0 Authorization code grant authentication type. Other OAuth2.0 types cannot be used under BYOA.
• Your enterprise requires that all third-party integrations use internally managed OAuth apps.
• You need to add or modify scopes that are not part of UiPath's default registered app.
• Your organization's security or compliance policies prohibit shared app usage.
• You want to control the OAuth app lifecycle, including rotation of secrets.

Remarque :

UiPath's public OAuth apps use fixed scopes and cannot be modified per customer request. If you require additional scopes, BYOA is the correct option.

How BYOA works

When creating a connection in Integration Service, you can select Bring your own Oauth2 app as the authentication type.

This allows you to enter:

• Client ID and Client Secret - Credentials obtained from your app registration in the vendor's developer portal.
• Scopes - Permissions required by the connector.
• Redirect URI - Non-editable callback URL (https://cloud.uipath.com/provisioning_/callback for Automation Cloud). This is the callback URL that Integration Service uses to complete the OAuth flow.

Integration Service uses your credentials to perform the OAuth flow and securely stores the resulting access and refresh tokens.

Configuring a BYOA connection

Step 1: Register an OAuth App on the vendor portal

Create an OAuth 2.0 app in the vendor's developer portal (for example, Salesforce, Microsoft, Jira or Google). During registration:

• Set the redirect/callback URI to https://cloud.uipath.com/provisioning_/callback.
• Add the required scopes (see connector-specific documentation for mandatory scopes).
• Ensure the vendor supports the grant type required by the connector (Authorization Code Grant).

Step 2: Create a connection in Integration Service

1. Navigate to Integration Service > Connectors, select the desired connector, and then click Connect.

2. Select the authentication type Bring Your Own OAuth2 2.0 app.

3. Enter the following details from your registered app:

   • ID de client
   • Clé secrète du client
   • Scopes (select from existing or type them manually)
   Remarque :

   Many vendors (Atlassian Jira, Coupa, etc.) expect the same scopes are present in your app as well.

4. Follow the on-screen prompts to complete the OAuth consent flow by providing your username and password on the vendor's login page.

5. Once authorized, the connection is securely stored and available to be used.

6. Integration service takes care of periodically refreshing the access token.

Step 3: Verify mandatory scopes

Each connector has mandatory scopes required for its activities and triggers.

If your BYOA app does not include these scopes, connection creation will fail, or certain actions may not work as expected.

Refer to the connector's documentation to confirm the list of mandatory scopes.

Meilleures pratiques

• Use a dedicated enterprise app registration for UiPath Integration Service; avoid reusing app IDs from unrelated integrations.
• Include only the necessary scopes for least-privilege access.
• Keep client secrets rotated periodically and update them in Integration Service by editing connections.
• Document app ownership and ensure continuity if admins change.
• Verify redirect URIs exactly match the value displayed in Integration Service; mismatched URIs cause OAuth errors.

Security and maintenance

• BYOA credentials are encrypted and stored securely in UiPath Integration Service and never exposed in plain text.
• UiPath does not manage or monitor your custom app credentials or scopes.
• Secret rotation, app de-registration, or scope maintenance are the customer's responsibility.

Problèmes couramment rencontrés

The following table lists common issues encountered when using BYOA connections, along with their possible causes and resolutions.

Problème	Cause possible	Résolution
Invalid client or secret	Wrong client ID or secret.	Verify credentials from the vendor app registration.
Redirect URI mismatch	The redirect URI in the vendor app does not match UiPath's value.	Update the redirect URI in the vendor app registration.
Insufficient scopes or Access denied	Missing mandatory scopes in vendor app.	Add required scopes and reauthorize.
Token expiring frequently	Vendor app configured with short-lived tokens.	Enable refresh tokens in the app or extend token validity.

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.

Troubleshooting connection issues

For information on how to fix common issues you might encounter when using connection, see Connections troubleshooting.