Verbindungen

Über Verbindungen

Verbindungen helfen bei der Einrichtung von Aufgaben zwischen einzelnen Benutzern und externen Anwendungen. Die Verbindungen werden erstellt, sobald sich Benutzer bei einem API-Anbieter authentifizieren.

Voraussetzungen

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.

Erstellen einer Verbindung

1. Greifen Sie auf die Automation Suite zu.
2. Wählen Sie im Menü auf der linken Seite Integration Service. Die Integration Service-Fenster enthalten drei separate Registerkarten: Connectors, Verbindungen und Trigger. Standardmäßig ist die Registerkarte Konnektoren ausgewählt. Es werden nur die in Ihrer lokalen Umgebung installierten Konnektoren angezeigt.

1. Im Abschnitt Meine Ordner können Sie auswählen, ob Sie in Ihrem persönlichen Arbeitsbereich oder in einem freigegebenen Ordner arbeiten möchten, in dem erstellte Verbindungen von allen Benutzern verwendet werden können, die Zugriff auf diesen Ordner haben.

2. Wählen Sie den gewünschten Connector aus, um eine neue Verbindung zu erstellen oder eine vorhandene zu aktualisieren.
3. Wählen Sie Verbindung mit <connector name> herstellen aus. Je nach gewähltem Connector werden die spezifischen Anmeldeinformationen für Ihre Verbindungen angefordert.

Freigegebene Verbindungen

Wenn eine Verbindung in einem freigegebenen Ordner erstellt wird, können alle Benutzer mit Zugriff auf diesen Ordner die Verbindung in ihren Automatisierungsworkflows verwenden. Die Verbindung kann von allen Benutzern bearbeitet werden, die Zugriff darauf haben.

Hinweis:

Alle Integration Service-Connectors unterstützen die Verbindungsfreigabe und -konfiguration zur Laufzeit. Weitere Informationen zur Konfiguration von Verbindungen zur Laufzeit finden Sie im Orchestrator-Benutzerhandbuch.

Ändern von Verbindungen

1. Wählen Sie in der linken Leiste Integration Service aus . Das Integration Service-Fenster enthält drei separate Registerkarten: Connectors, Verbindungen und Trigger.
2. Wählen Sie den Ordner aus, in dem Sie die Verbindung ändern möchten.
   Hinweis:

   Der Ordner, in dem Sie die Verbindung erstellen möchten, kann auch nach Schritt 4 ausgewählt werden.

3. Go to the Connections tab, where the list of created connections is displayed.
4. Wählen Sie die Schaltfläche Mehr der gewünschten Verbindung aus, um sie zu ändern. Sie können die folgenden Aktionen ausführen:
   • Löschen Sie die Verbindung.
   • Als Standard festlegen (diese Option ist nur verfügbar, wenn Sie mehrere Verbindungen für dieselbe Anwendung eingerichtet haben).
   • Überprüfen Sie die Verbindung, um ihren Status zu überprüfen.

Umbenennen von Verbindungen

Um eine Verbindung umzubenennen, müssen Sie:

1. Access the Connections tab.
2. Wählen Sie im Menü auf der linken Seite Integration Service aus. Das Integration Service-Fenster enthält separate Registerkarten für Connectors, Verbindungen und Trigger sowie ein linkes Navigationsfenster, in dem die Ordner angezeigt werden.
3. Wählen Sie den Ordner aus, in dem Sie die Verbindung ändern möchten.
   Hinweis:

   Der Ordner kann nach Schritt 4 ausgewählt werden.

4. Go to the Connections tab, where the list of created connections is displayed.
5. Zeigen Sie mit dem Mauszeiger auf den Namen der Verbindung, die Sie ändern möchten. Die Schaltfläche Bearbeiten wird angezeigt.
   Hinweis:

   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. Wählen Sie die Schaltfläche Bearbeiten aus und Sie können einen neuen Namen für Ihre Verbindung wählen.

Auswählen des Authentifizierungstyps

Einige Connectors im Integration Service unterstützen mehrere Authentifizierungsmethoden. Sie können Ihre bevorzugte Methode auswählen, bevor Sie eine Verbindung initiieren.

1. Wählen Sie im Integration Service von der Liste Konnektoren einen unterstützten Konnektor aus.
2. Wählen Sie Verbindung mit <connector name>herstellen aus, um zur Seite für die Verbindungseinrichtung zu wechseln.
3. Verwenden Sie die Dropdownliste Ordner, in der Verbindung gespeichert ist , um den entsprechenden Ordner auszuwählen (z. B. Mein Arbeitsbereich).
4. Verwenden Sie die Dropdownliste Authentifizierungstyp , um aus den verfügbaren Optionen auszuwählen, z. B.:
   • OAuth 2.0: Autorisierungscode
   • OAuth 2.0-Kennwort
   • Bringen Sie Ihre eigene OAuth 2.0-App mit
   • Persönliches Zugriffstoken (PAT)
   Hinweis:

   Die verfügbaren Optionen können je nach Connector variieren.

5. Geben Sie die erforderlichen Anmeldeinformationen für Ihren ausgewählten Authentifizierungstyp ein und wählen Sie dann Verbinden aus, um die Verbindung herzustellen.

Bringen Sie Ihre eigene OAuth 2.0-App mit

UiPath Integration Service offers a Bring your own OAuth 2.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.

Hinweis:

Wenn Sie den Integration Service in einer lokalen Umgebung verwenden und sich mit einer Client-ID und einem Geheimschlüssel authentifizieren müssen, müssen Sie Ihre eigene OAuth 2.0-Anwendung erstellen, ähnlich wie bei der Option Mitbringen Ihrer eigenen OAuth 2.0-App .

Common scenarios for when to use BYOA

Use BYOA when:

• The application supports the OAuth 2.0 Authorization code grant authentication type. Other OAuth 2.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.

Hinweis:

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 OAuth 2.0 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://{yourDomain}/provisioning_/callback for Automation Suite). 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://{yourDomain}/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. In Integration Service, from the Connectors list, select the desired connector, and then click Connect to open the connection creation page.

2. If multiple authentication types are available, select the authentication type Bring your own OAuth 2.0 app.

3. Enter the following details from your registered app:

   • Client-ID
   • Geheimer Clientschlüssel
   • Scopes (select from existing or type them manually)
   Hinweis:

   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.

Best Practices

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

Häufige Probleme

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

Problem	Mögliche Ursache	Resolution
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.

Hinweis:

Wenn Ihre Organisation BYOA verwendet, können Sie über eine Integration Service-Governance-Richtlinie in Automation Ops Standardwerte für diese Anmeldeinformationen festlegen. Weitere Informationen finden Sie unter Einstellungen für Integration Service-Richtlinien.

Troubleshooting connection issues

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