Verwalten externer Anwendungen

Registered external applications can access your UiPath resources for the current tenant over API, using the OAuth 2.0 flow.

Hinweis:

Sie müssen Administrator für den Mandanten sein, um die auf dieser Seite beschriebenen Aufgaben ausführen zu können.

Hinzufügen einer externen Anwendung

So registrieren Sie eine externe Anwendung, damit sie mithilfe von OAuth auf Ihre UiPath-Ressourcen zugreifen kann:

1. Melden Sie sich beim Mandanten als Administrator an.

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. Along the left, select External Applications. The External Applications page opens, listing all the existing external applications registered for the current tenant:

   

4. Klicken Sie rechts über der Tabelle auf Anwendung hinzufügen.

5. Füllen Sie das Feld Anwendungsname aus.

6. Wählen Sie eine Option für Anwendungstyp aus.

   Wenn Sie Vertrauliche Anwendung auswählen, erhalten Sie am Ende einen geheimen App-Schlüssel, also stellen Sie sicher, dass Ihre Anwendung ihn sicher speichern kann. Wenn dies nicht der Fall ist, wählen Sie die Option Nicht vertrauliche Anwendung aus.

7. Under Resources, click Add Scopes. The Edit Resource panel opens on the right, where you can select the resources to which the application should have access.

8. Wählen Sie von der Dropdownliste Ressource die UiPath-API aus, welche die Anwendung verwenden kann.

   Hinweis:

   Sie können jeweils nur einen Scope für eine Ressource hinzufügen. Wenn Sie den Zugriff auf mehrere Ressourcen zulassen möchten, wiederholen Sie diesen Vorgang, um einen Scope für jede Ressource hinzuzufügen.

9. Aktivieren Sie auf der Registerkarte Benutzer-Scope(s) nach Bedarf die Kontrollkästchen für die logischen API-Berechtigungen, die Sie gewähren möchten.

   Die Erteilung von Berechtigungen unter dem Benutzer-Scope bedeutet, dass die externe Anwendung im Rahmen eines Benutzerkontexts auf diese Ressourcen zugreifen kann und ein Benutzer mit den entsprechenden Berechtigungen angemeldet sein muss.

10. Wenn es sich um eine vertrauliche Anwendung handelt, können Sie zur Registerkarte Anwendungs-Scope(s) wechseln, um nach Bedarf auch Berechtigungen auf Anwendungsebene für die ausgewählte Ressource zu erteilen.

    Mit Berechtigungen im Anwendungs-Scope hat die externe Anwendung Zugriff auf anwendungsweite Daten für die ausgewählten Scopes, ohne dass eine Benutzerinteraktion erforderlich ist.

    Nicht vertrauliche Anwendungen können nicht auf den Anwendungs-Scope zugreifen.

11. Click Save. The panel closes and the selected resource and scopes are added to the Resources table in the form.

12. Wenn die externe Anwendung sie akzeptieren kann, können Sie eine URL im Feld Umleitungs-URL hinzufügen und die Autorisierungsantwort wird dorthin gesendet. Die Anwendung kann sie dann verwenden, um auf UiPath-Ressourcen zuzugreifen.

13. Klicken Sie auf Hinzufügen, um die Registrierung zu erstellen.

    Eine Bestätigungsmeldung wird geöffnet. Für vertrauliche Anwendungen enthält die Bestätigungsmeldung den geheimen App-Schlüssel, den die registrierte externe Anwendung verwenden kann, um eine Autorisierung anzufordern. Speichern Sie ihn an einem sicheren Ort, da er Ihnen nicht erneut angezeigt wird.

Ändern des Scope für eine vorhandene Anwendung

Scopes sind die Berechtigungen der externen Anwendung in Bezug auf eine UiPath-Ressource.

1. Melden Sie sich beim Mandanten als Administrator an.

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. Wählen Sie auf der linken Seite Externe Anwendungen aus.

   The External Applications page opens, listing all the existing external applications registered for the current tenant.

4. Click Edit at the right of the application row.

5. Ändern Sie den Scope, auf den die Anwendung Zugriff hat:

   • Verwenden Sie die Symbole rechts neben einer Ressourcenzeile, um einen vorhandenen Scope zu bearbeiten oder die Ressource zu löschen.
   • Klicken Sie auf Scopes hinzufügen, um eine zusätzliche Ressource hinzuzufügen, und wählen Sie dann Scopes dafür aus.

6. Klicken Sie auf Speichern (Save).

Generieren eines neuen geheimen App-Schlüssels

Wenn Sie den geheimen Schlüssel nicht kennen, der für eine vertrauliche externe Anwendung generiert wurde, können Sie ihn nicht wiederherstellen. Sie können jedoch einen neuen generieren.

Hinweis:

Wenn Sie einen neuen geheimen App-Schlüssel generieren, stellen Sie sicher, dass Sie ihn dem Entwickler mitteilen, der sich um die Integration mit der externen Anwendung kümmert. Der Entwickler muss den Authentifizierungsmechanismus anpassen, sonst funktioniert die vorhandene Integration nicht mehr.

So generieren Sie einen neuen geheimen App-Schlüssel:

1. Melden Sie sich beim Mandanten als Administrator an.

2. Go to Tenant > Manage access > Assign roles and click Manage Accounts & Groups. The tenant-level Management portal opens.

3. Along the left, select External Applications. The External Applications page opens, listing all the existing external applications registered for the current tenant.

4. Klicken Sie rechts neben der Anwendungszeile auf .

5. Klicken Sie unter Geheimer App-Schlüssel auf Neu generieren.

   Ein neuer geheimer App-Schlüssel wird generiert und über der Schaltfläche angezeigt. Er bleibt sichtbar, bis Sie auf Abbrechen klicken, um die Seite zu schließen.

6. Kopieren Sie den geheimen App-Schlüssel und speichern Sie ihn an einem sicheren Ort.

Bereitstellen von Details für Entwickler

Nachdem Sie eine externe Anwendung registriert haben, muss ein Entwickler zudem die externe Anwendung so einrichten, dass sie sich korrekt authentifiziert, die Autorisierung vom UiPath Identity Server anfordert und dann auf die erlaubten UiPath-Ressourcen zugreift.

Instructions for the developers maintaining the integration with the external application are available in Accessing UiPath Resources Using External Applications.

Damit Entwickler diese Aufgaben ausführen können, müssen Sie ihnen die folgenden Informationen zur Verfügung stellen:

• Anwendungstyp und Anwendungs-ID, die beide auf der Seite Externe Anwendungen zu sehen sind

• Scopes, die für jeden Scope-Typ hinzugefügt wurden; für einige Ressourcen wird der gleiche Name sowohl für den Benutzer- als auch für den Anwendungs-Scope verwendet, daher ist der Typ auch wichtig.

• Wenn es sich um eine vertrauliche Anwendung handelt, wurde der geheime Anwendungsschlüssel generiert, als Sie die externe Anwendung registriert haben.

  Hinweis:

  If you don't have the secret anymore, generate a new one, as described above on this page.