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

Bevor Sie Verbindungen verwenden können, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

• Integration Service ist aktiviert und für Ihren Mandanten bereitgestellt.
• Benutzer, die mit Verbindungen arbeiten, verfügen über die erforderlichen Berechtigungen in Orchestrator. Zum Erstellen einer Verbindung muss ein Benutzer über die Berechtigung Verbindungen – Erstellen im Zielordner verfügen. Weitere Informationen zu Berechtigungen finden Sie unter Konfigurieren des Zugriffs für Konten im Orchestrator-Benutzerhandbuch.

Verbindungen in Orchestrator

Wichtig:

Ab März 2026 können Sie neue Integration Service-Verbindungen im Orchestrator erstellen. Vorhandene Integration Service-Verbindungen bleiben auf der Registerkarte „Integration Service-Verbindungen“ bis Juli 2026 sichtbar (dieses Datum unterliegt möglichen Erweiterungen). Nach diesem Datum werden vorhandene Integration Service-Verbindungen zu Orchestrator migriert und die Registerkarte „Verbindungen“ im Integration Service wird entfernt. Diese Änderung soll zuerst für Community-Benutzer und dann für Enterprise-Benutzer verfügbar werden, je nach Organisation und Mandantenregionen. In den Integration Service-Versionshinweisen erfahren Sie, wann die Änderung zum ersten Mal angekündigt wird.

Hauptvorteile der Verwaltung von Verbindungen 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

Die Registerkarte Verbindungen im Orchestrator bietet einen zentralen Ort zum Erstellen und Verwalten von Verbindungen. Sie können Verbindungen auch direkt aus Automatisierungen in UiPath Studio, UiPath Studio Web oder UiPath Assistant erstellen.

Um eine Verbindung im Orchestrator zu erstellen, führen Sie die folgenden Schritte aus:

1. Wählen Sie Orchestrator im Produktstartprogramm aus.
2. Wählen Sie einen Ordner aus und navigieren Sie dann zur Registerkarte Verbindungen .
3. Wählen Sie Verbindung hinzufügen aus.
4. Um die Seite zur Erstellung der Verbindung zu öffnen, wählen Sie den Konnektor in der Liste aus. Sie können die Suchleiste verwenden, um den Connector zu finden.
5. Wählen Sie den Authentifizierungstyp aus (falls zutreffend), geben Sie die erforderlichen Anmeldeinformationen ein und wählen Sie dann Verbinden aus .

Weitere Informationen finden Sie unter Verwalten von Verbindungen im Orchestrator-Benutzerhandbuch.

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

Einige Integration Service-Connectors unterstützen mehrere Authentifizierungstypen. Sie wählen den Typ beim Erstellen der Verbindung aus . Zu den verfügbaren Optionen können gehören:

• 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 variieren je nach Connector.

Verwalten von Verbindungen

Sie können alle Verbindungen an einem Ort über die Registerkarte Verbindungen im Orchestrator verwalten. Hier können Sie den Zustand von Verbindungen überprüfen, die Verbindung erneut herstellen, Trigger verwalten, Verbindungsdetails wie den Namen und das Abrufintervall bearbeiten und Verbindungen löschen.

Weitere Informationen finden Sie unter Verwalten von Verbindungen im Orchestrator-Benutzerhandbuch.

Verwalten von Verbindungen über den 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

Der UiPath Integration Service bietet ein Bring your own Oauth2.0 app (BYOA) , das es Unternehmen ermöglicht, mithilfe ihrer eigenen OAuth 2.0-Anwendungen anstelle der standardmäßigen bei UiPath registrierten öffentlichen OAuth-App eine Verbindung herzustellen .

UiPath registriert und verwaltet OAuth 2.0-Apps in Anbieterportalen für die meisten Connectors (z. B. Microsoft, Google, Salesforce, Atlassian Jira usw.). In den meisten Fällen verfügen diese Apps über vordefinierte Scopes und werden vollständig von UiPath verwaltet.

Einige Organisationen verfügen jedoch möglicherweise strenge IT-, Sicherheits- oder Compliance-Richtlinien, die sie daran hindern, externe App-Registrierungen zu verwenden. In solchen Fällen ermöglicht BYOA die Kunden , ihre eigene Client-ID und ihren eigenen geheimen Clientschlüssel zu verwenden, um Integration Service-Verbindungen zu authentifizieren und zu autorisieren.

Gängige Szenarien für die Verwendung von BYOA

Verwenden Sie BYOA in folgenden Fällen:

• Die Anwendung unterstützt den Authentifizierungstyp OAuth2.0: Autorisierungscodegewährung. Andere OAuth2.0-Typen können nicht unter BYOA verwendet werden.
• Ihr Unternehmen erfordert, dass alle Integrationen von Drittanbietern intern verwaltete OAuth-Apps verwenden.
• Sie müssen Scopes hinzufügen oder ändern, die nicht Teil der standardmäßig registrierten App von UiPath sind.
• Die Sicherheits- oder Compliance-Richtlinien Ihrer Organisation verbieten die gemeinsame Nutzung von Apps.
• Sie möchten den Lebenszyklus der OAuth-App, einschließlich der Rotation von Geheimnissen, steuern.

Hinweis:

Die öffentlichen OAuth-Apps von UiPath verwenden feste Scopes und können nicht pro Kundenanforderung geändert werden. Wenn Sie zusätzliche Scopes benötigen, ist BYOA die richtige Option.

So funktioniert BYOA

Beim Erstellen einer Verbindung im Integration Service können Sie Eigene OAuth2-App mitbringen als Authentifizierungstyp auswählen.

Dadurch können Sie Folgendes eingeben:

• Client-ID und geheimer Clientschlüssel – Anmeldeinformationen, die Sie aus Ihrer App-Registrierung im Entwicklerportal des Anbieters erhalten haben.
• Scopes – Berechtigungen, die für den Connector erforderlich sind.
• Umleitungs-URI – Nicht bearbeitbare Rückruf-URL (https://cloud.uipath.com/provisioning_/callback für Automation Cloud). Dies ist die Rückruf-URL, die der Integration Service verwendet, um den OAuth-Flow zu vervollständigen.

Der Integration Service verwendet Ihre Anmeldeinformationen, um den OAuth-Flow auszuführen, und speichert die resultierenden Zugriffs- und Aktualisierungstoken sicher.

Konfigurieren einer BYOA-Verbindung

Schritt 1: Registrieren Sie eine OAuth-App auf dem Anbieterportal

Erstellen Sie eine OAuth 2.0-App im Entwicklerportal des Anbieters (z. B. Salesforce, Microsoft, Jira oder Google). Während der Registrierung:

• Legen Sie den Umleitungs-/Rückruf-URI auf https://cloud.uipath.com/provisioning_/callback fest.
• Fügen Sie die erforderlichen Scopes hinzu (in der Connector-spezifischen Dokumentation finden Sie obligatorische Scopes.
• Stellen Sie sicher, dass der Anbieter den vom Connector benötigten Gewährungstyp unterstützt (Gewährung des Autorisierungscodes).

Schritt 2: Erstellen einer Verbindung im Integration Service

1. Navigieren Sie zu Integration Service > Konnektoren, wählen Sie den gewünschten Konnektor aus und klicken Sie dann auf Verbinden.

2. Wählen Sie den Authentifizierungstyp Bring Your Own OAuth2 2.0 app aus.

3. Geben Sie die folgenden Details in Ihrer registrierten App ein:

   • Client-ID
   • Geheimer Clientschlüssel
   • Scopes (aus vorhandenen auswählen oder manuell eingeben)
   Hinweis:

   Viele Anbieter (Atlassian Jira, Coupa usw.) erwarten, dass die gleichen Scopes auch in Ihrer App vorhanden sind.

4. Folgen Sie den Anweisungen auf dem Bildschirm, um den OAuth-Zustimmungsprozess abzuschließen, indem Sie Ihren Benutzernamen und Ihr Kennwort auf der Anmeldeseite des Anbieters angeben.

5. Nach der Autorisierung wird die Verbindung sicher gespeichert und kann verwendet werden.

6. Der Integration Service kümmert sich um die regelmäßige Aktualisierung des Zugriffstokens.

Schritt 3: Obligatorische Scopes überprüfen

Jeder Konnektor verfügt über obligatorische Scopes, die für seine Aktivitäten und Trigger erforderlich sind.

Wenn Ihre BYOA-App diese Scopes nicht enthält, schlägt die Erstellung der Verbindung fehl oder bestimmte Aktionen funktionieren möglicherweise nicht wie erwartet.

Informationen zur Liste der obligatorischen Scopes finden Sie in der Dokumentation des Konnektors.

Best Practices

• Verwenden Sie eine dedizierte Enterprise-App-Registrierung für den UiPath Integration Service; Vermeiden Sie die Wiederverwendung von App-IDs aus nicht zugehörigen Integrationen.
• Schließen Sie nur die erforderlichen Scopes für den Zugriff mit den geringsten Berechtigungen ein.
• Halten Sie Client-Geheimnisse regelmäßig rotiert und aktualisieren Sie sie im Integration Service, indem Sie Verbindungen bearbeiten.
• Dokumentieren Sie den App-Besitz und stellen Sie die Kontinuität sicher, wenn sich die Administratoren ändern.
• Überprüfen Sie, ob Umleitungs-URIs genau mit dem im Integration Service angezeigten Wert übereinstimmen; Nicht übereinstimmende URIs verursachen OAuth-Fehler.

Sicherheit und Wartung

• BYOA-Anmeldeinformationen sind verschlüsselt und sicher im UiPath Integration Service gespeichert und niemals im Klartext offengelegt.
• UiPath verwaltet oder überwacht Ihre benutzerdefinierten App-Anmeldeinformationen oder -Scopes nicht .
• Geheime Rotation, App-Aufhebung der Registrierung oder Scope-Wartung liegen in der Verantwortung des Kunden.

Häufige Probleme

In der folgenden Tabelle sind häufige Probleme aufgeführt, die bei der Verwendung von BYOA-Verbindungen auftreten, zusammen mit ihren möglichen Ursachen und Lösungen.

Problem	Mögliche Ursache	Resolution
Ungültiger Client oder geheimer Schlüssel	Client-ID oder Geheimschlüssel falsch.	Überprüfen Sie die Anmeldeinformationen aus der App-Registrierung des Anbieters.
Umleitungs-URI stimmt nicht überein	Der Umleitungs-URI in der Anbieter-App stimmt nicht mit dem Wert von UiPath überein.	Aktualisieren Sie die Umleitungs-URI in der App-Registrierung des Anbieters.
Unzureichende Scopes oder Zugriff verweigert	Fehlende obligatorische Scopes in der Anbieter-App.	Fügen Sie erforderliche Scopes hinzu und autorisieren Sie sie erneut.
Token läuft häufig ab	Anbieter-App, die mit kurz gültigen Token konfiguriert ist.	Aktivieren Sie Aktualisierungstokens in der App, oder erweitern Sie die Gültigkeit des Tokens.

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.

Beheben von Verbindungsproblemen

Informationen zum Beheben häufig auftretender Probleme, die bei der Verwendung der Verbindung auftreten können, finden Sie unter Fehlerbehebung bei Verbindungen.