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.

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

Der UiPath Integration Service bietet ein Bring your own OAuth 2.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.

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 .

Gängige Szenarien für die Verwendung von BYOA

Verwenden Sie BYOA in folgenden Fällen:

• Die Anwendung unterstützt den Authentifizierungstyp OAuth 2.0 Autorisierungscodegewährung. Andere OAuth 2.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 OAuth 2.0-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://{yourDomain}/provisioning_/callback für Automation Suite). 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://{yourDomain}/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. Wählen Sie im Integration Service von der Liste Connectors den gewünschten Connector aus und klicken Sie dann auf Verbinden , um die Seite zur Verbindung zur Verbindung zu öffnen.

2. Wenn mehrere Authentifizierungstypen verfügbar sind, wählen Sie den Authentifizierungstyp Bring your own OAuth 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. 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.

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.

Beheben von Verbindungsproblemen

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