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.

Verbindungen in Orchestrator

Wichtig:

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

Dieser Schritt bringt mehrere wesentliche Vorteile:

• Weniger Kontextwechsel

  Sie können jetzt Assets, Warteschlangen, Trigger und Verbindungen an einem Ort erstellen, ohne zu einem anderen Menü auf der linken Seite navigieren zu müssen. Weniger Klicks, weniger Seitenladen und geringere kognitive Last führen zu einem reibungsloseren Workflow.

• Einfachere Fehlerbehebung

  Wenn Ausführungen fehlschlagen, überprüfen Sie bereits Aufträge, Warteschlangen oder Protokolle in Orchestrator. Sie können jetzt die zugehörige Verbindung auf derselben Oberfläche anzeigen und verwalten und so die Zeit bis zur Lösung verkürzen.

• Ein konsistentes gemerktes Modell

  Der Orchestrator zentralisiert bereits Ihre Ressourcen. Die Verwaltung von Verbindungen neben Assets und Triggern gewährleistet eine intuitivere und einheitlichere Erfahrung.

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.

Wir empfehlen, Verbindungen zu erstellen, für die die Authentifizierung über persönliche Konten in persönlichen Arbeitsbereichen erfolgt und freigegebene Ordner nur für Verbindungen zu verwenden, bei denen die Authentifizierung über Dienstkonten erfolgt. Administratoren können reguläre Benutzer daran hindern, gemeinsame Integration Service-Verbindungen in Teamordnern zu erstellen. Weitere Informationen dazu finden Sie unter Erzwingen der Integration Service-Verbindungs-Governance auf Benutzerebene im Orchestrator-Benutzerhandbuch.

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.

Erstellen einer Verbindung

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. Wählen Sie Verbindung hinzufügen aus.
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.

Hinweis:

Um erfolgreich eine Verbindung zu erstellen, müssen Sie eine Zulassungsliste für IP-Adressen für den Integration Service konfigurieren. Weitere Informationen finden Sie unter Konfigurieren der Firewall im Automation Cloud-Administratorhandbuch.

Auswählen des Authentifizierungstyps

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

• OAuth 2.0: Autorisierungscode
• OAuth 2.0-Kennwort
• Bringen Sie Ihre eigene OAuth 2.0-App mit
• Persönliches Zugriffstoken (PAT)

Hinweis:

Available options vary depending on the connector.

Verwalten von Verbindungen

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

Sie können Integration Service-Verbindungen direkt über UiPath Assistant verwalten. Weitere Informationen finden Sie unter Verbindungen im UiPath Assistant.

Wählen Sie Im Browser konfigurieren aus , um die Seite Verbindungen in Studio Web zu öffnen. Weitere Informationen dazu finden Sie unter Verwalten von Verbindungen im Benutzerhandbuch zu Studio Web.

Hinweis:

Benutzer der Automation Cloud – Öffentlicher Sektor können Verbindungen im UiPath Assistant anzeigen, aber nicht verwalten. Stattdessen können sie Integration Service-Verbindungen mithilfe der Registerkarte Paketanforderungen im Orchestrator konfigurieren und verwalten.

Bringen Sie Ihre eigene OAuth 2.0-App mit

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.

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

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

Verbindungen in Lösungen

Sie können Verbindungen und Ereignistrigger als Teil Ihres Lösungspakets verwalten. Unter Übersicht über die Lösungsverwaltung erfahren Sie, was Lösungspakete sind, wie sie funktionieren und wie Sie sie erstellen, verwalten und bereitstellen können.

Wenn Sie ein Lösungspaket erstellen, sind Verbindungen und die zugehörigen Ereignistrigger im Komponentenbereich verfügbar. Sie können die folgenden Eigenschaften bearbeiten: Verbindungsname, Verbindungsbeschreibung und Authentifizierungstyp. Für Ereignistrigger können Sie die gleichen Konfigurationsschritte wie im Orchestrator ausführen.

Hinweis:

Sie können diese Felder auch zum Zeitpunkt der Bereitstellung bearbeiten, es sei denn, sie sind für die Bearbeitung gesperrt.

Sobald die Lösung erstellt und veröffentlicht wurde, sind die Verbindungen im Komponentenbereich der Lösung verfügbar. Alle beim Erstellen des Lösungspakets ausgewählten Verbindungen können nun bereitgestellt werden.

Die Lösungsverwaltung zeigt nur Verbindungen für Prozesse an, wenn auch ein Ereignistrigger verbunden ist. Das Problem kann sich auf die Lösungsbereitstellung auswirken und eine manuelle Verbindungskonfiguration für den ordnungsgemäßen Betrieb erfordern.

Sie können das Lösungspaket in einem bestimmten Ordner bereitstellen, der im Integration Service noch nicht vorhanden ist. In diesem Fall wird der Ordner automatisch erstellt.

Typ der Verbindungsauthentifizierung

Als Administrator entscheiden Sie während der Bereitstellung, ob Sie eine vorhandene Verbindung verwenden, eine neue erstellen oder dem Endbenutzer erlauben, die Verbindung auszuwählen.

Hinweis:

Lösungen verschiebt die Verbindungen und die zugehörigen Entitätsbeziehungen (z. B. Workflows und Prozesse, zu denen die Verbindung gehört), überträgt jedoch keine Anmeldeinformationen für die Authentifizierung.

Während der Bereitstellung kann der Administrator den Authentifizierungstyp wie folgt festlegen:

• Von Benutzern konfigurierbar: Es werden keine Verbindungen aus vorhandenen Verbindungen erstellt oder verwendet. Von Benutzern wird erwartet, dass sie die Verbindung konfigurieren, nachdem die Lösung zur Laufzeit bereitgestellt wurde. Weitere Informationen finden Sie unter Konfigurieren von Verbindungen in der Orchestrator-Dokumentation.

• Authentifizierung nach Bereitstellung erfolgt: Eine neue Verbindung wird erstellt und erfordert nach der Bereitstellung eine Authentifizierung. Die Verbindung bleibt inaktiv, bis der Authentifizierungsschritt abgeschlossen ist.

  • Bevor die Authentifizierung abgeschlossen ist, wird der Benutzername als System angezeigt. Sobald die Authentifizierung erfolgreich ist, wird der Benutzername aktualisiert, um die Anmeldeinformationen des Authentifikators anzuzeigen.

Sie haben auch die Möglichkeit, Komponenten zu verknüpfen. Wenn Sie Mit vorhandener verknüpfen auswählen, zeigt ein Popup-Fenster alle Verbindungen an, auf die der Benutzer zugreifen kann, der das Lösungspaket bereitstellt. Sie können eine beliebige vorhandene Verbindung auswählen, um Teil des Lösungspakets zu sein.

Hinweis:

Wenn Sie vorhandene Verbindungen für die im Lösungspaket enthaltenen Connectors auswählen und während der Bereitstellung auch einen neuen Ordner auswählen, wird der Ordner im Integration Service ohne Verbindungen erstellt. Verwenden Sie diesen Ordner, wenn Einstellungen geändert oder neue Verbindungen hinzugefügt werden.

Die Option Mit vorhandener Konfiguration verknüpfen ist nicht verfügbar, wenn Sie eine Konfiguration mit den folgenden Methoden bearbeiten: Bereitstellungskonfiguration oder Bereitstellungskonfiguration bearbeiten. Um Komponenten zu verknüpfen oder den Authentifizierungstyp nach der Bereitstellung zu bearbeiten, müssen Sie das Lösungspaket aktualisieren . Dazu muss die Lösung bearbeitet und die neue Version erneut bereitgestellt werden.

Verbindungen, die in einem beliebigen Ordner über Lösungen erstellt wurden, werden nicht gelöscht, auch wenn der Workflow aktualisiert wird, um andere Verbindungen zu verwenden. Dadurch wird sichergestellt, dass Prozesse und Automatisierungen, die auf diesen Verbindungen basieren, nicht vom Upgrade betroffen sind.

Troubleshooting connection issues

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