Auth0 in Jitterbit App Builder konfigurieren

Auth0 ist ein Identitätsanbieter (IdP), der mehrere Authentifizierungsprotokolle unterstützt, einschließlich SAML Single Sign-On (SSO)-Authentifizierung. App Builder integriert sich mit Auth0 als Service Provider (SP). Jede App Builder-Instanz muss einzeln mit Auth0 integriert werden und umgekehrt. Es gibt drei Hauptaufgaben:

1. Registrieren Sie App Builder als Auth0-Client.
2. Konfigurieren Sie Auth0 als App Builder-Sicherheitsanbieter.
3. Ordnen Sie App Builder-Benutzer Auth0-Identitäten zu.

Es wird davon ausgegangen, dass Ihre Organisation bereits über ein bestehendes Auth0-Konto verfügt.

Die folgenden Anweisungen beziehen sich auf die folgenden Eigenschaften:

App Builder als Auth0-Client registrieren

Um App Builder als Auth0-Client zu registrieren, melden Sie sich zunächst als Dashboard-Administrator im Auth0-Dashboard an.

1. Wählen Sie den Menülink Clients aus.

   

2. Klicken Sie auf die Schaltfläche Client erstellen.

   

3. Geben Sie den Client-Namen an.

4. Wählen Sie für den Client-Typ Regular Web Applications aus.
5. Klicken Sie auf die Schaltfläche Erstellen.
6. Klicken Sie auf die Registerkarte Add-ons.

7. Wählen Sie die Option SAML2 Web App aus.

   

8. Geben Sie für die Application Callback URL die Assertion Consumer Service URL an.

   Beispiel: https://example.com/Vinyl/signin-Auth0

9. Klicken Sie auf die Registerkarte Verwendung.

10. Beachten Sie die Metadaten-URL des Identitätsanbieters – klicken Sie mit der rechten Maustaste auf den Download-Link und wählen Sie „Linkadresse kopieren".

    https://example.auth0.com/samlp/metadata/aBcDeFgHiJkLmNoPqRsTuVwXyZ

11. Klicken Sie auf die Schaltfläche Speichern.

    Beachten Sie, dass Single Sign-On (SSO) standardmäßig nicht aktiviert ist. Falls Single Sign-On erforderlich ist:

12. Klicken Sie auf die Registerkarte Einstellungen.

13. Aktivieren Sie die Option Auth0 statt des IdP für Single Sign On verwenden.

    

14. Klicken Sie auf die Schaltfläche Speichern.

Auth0 als App Builder-Sicherheitsanbieter konfigurieren

Um Auth0 als App Builder-Sicherheitsanbieter zu konfigurieren, melden Sie sich zunächst als Administrator bei App Builder an.

1. Navigieren Sie zur IDE
2. Wählen Sie die Schaltfläche Sicherheitsanbieter
3. Klicken Sie auf die Schaltfläche + Sicherheitsanbieter

4. Geben Sie Folgendes an:

5. Name: {Security Provider Name}

   Beispiel: Auth0

6. Type: SAML

7. Priority: Eine eindeutige ganze Zahl zwischen 10 und 100. Beachten Sie, dass dieser Wert eindeutig sein muss.

   Beispiel: 50

8. Enabled: Aktivieren

9. User Provisioning: Aktivieren, um die Just-in-Time-Benutzerbereitstellung zu aktivieren
10. Supplies Group Membership: Aktivieren, wenn Auth0 so konfiguriert wurde, dass die Gruppenmitgliedschaft des Benutzers weitergegeben wird.
11. Redirect on Challenge: Wenn diese Option aktiviert ist, umgeht der Web-Client das Anmeldeformular und leitet den Benutzer zum OAuth-Anbieter weiter

12. Show On Login Form: Aktivieren

13. Klicken Sie auf die Schaltfläche Save

14. Klicken Sie im Bereich Properties auf die Schaltfläche + Property
15. Wählen Sie in der Parameterliste MetadataEndpoint aus

16. Geben Sie für den Value den Link {Identity Provider Metadata} an (siehe oben).

    Beispiel: https://example.auth0.com/samlp/metadata/aBcDeFgHiJkLmNoPqRsTuVwXyZ

17. Klicken Sie auf das Symbol Save (Häkchen)

App Builder-Benutzer Auth0-Identitäten zuordnen

Mit Benutzerbereitstellung

Wenn Sie die Benutzerbereitstellung wie oben beschrieben aktiviert haben und versuchen, sich anzumelden, werden Sie möglicherweise mit der folgenden Meldung zum App Builder-Anmeldeformular zurückgeleitet:

The user account (arthur.dent@example.com) has not been granted access to an application.

Obwohl App Builder den Benutzer erfolgreich bereitgestellt hat, hat der Benutzer standardmäßig keinen Zugriff auf App Builder-Anwendungen. Angenommen, der Auth0-Benutzer wurde zu einer oder mehreren Gruppen hinzugefügt und die Gruppenmitgliedschaft wird bereitgestellt (wie oben beschrieben), müssen Sie die Auth0-Sicherheitsgruppen den App Builder-Sicherheitsgruppen zuordnen.

Um Auth0-Sicherheitsgruppen App Builder-Sicherheitsgruppen zuzuordnen, melden Sie sich zunächst als Administrator bei App Builder an.

1. Navigieren Sie zur IDE
2. Wählen Sie die Schaltfläche User Management aus
3. Klicken Sie auf die Registerkarte Identities
4. Suchen Sie im Bereich Providers den Auth0-Sicherheitsanbieter und wählen Sie ihn aus
5. Suchen Sie im Bereich Provider Groups eine Auth0-Gruppe, die Sie zuordnen möchten, und klicken Sie auf das Symbol Edit (Stift). Falls es nicht angezeigt wird, klicken Sie auf + Group und konfigurieren Sie einen Datensatz entsprechend.
6. Wählen Sie die App Builder-Sicherheitsgruppe (Group) aus, der die Auth0-Gruppe zugeordnet wird
7. Klicken Sie auf die Schaltfläche Save

Weitere Informationen finden Sie im Abschnitt zur Identitäts- und Gruppenzuordnung.

Ohne Benutzerbereitstellung

Wenn Sie die Benutzerbereitstellung nicht aktiviert haben, schlägt die Authentifizierung mit einer ähnlichen Meldung fehl:

Although you've successfully authenticated with Auth0, the account arthur.dent@example.com (auth0|aBcDeFgHiJkLmNoPqRsTuVwZyZ) is not associated with a local account.

In der obigen Meldung ist arthur.dent@example.com der Benutzername (in der Claims-Authentifizierung „name" genannt). Der Text in Klammern ist die eindeutige Kennung (in der Claims-Authentifizierung „name identifier" genannt). Sie benötigen diese beiden Informationen für den nächsten Schritt.

Um ein App Builder-Benutzerkonto einer Auth0-Identität zuzuordnen, melden Sie sich zunächst als Administrator bei App Builder an:

1. Navigieren Sie zur IDE
2. Wählen Sie die Schaltfläche User Management aus
3. Wählen Sie Users aus dem Menü
4. Suchen Sie im Bereich Users den Benutzer, den Sie zuordnen möchten, und wählen Sie ihn aus
5. Klicken Sie im Bereich Identities auf die Schaltfläche + Identity

6. Geben Sie folgende Informationen an:

   • Provider: Auth0 (oder der Name, der im vorherigen Abschnitt gewählt wurde)
   • Name: Der Auth0-Benutzername (siehe oben)
   • Identifier: Der Auth0-Name-Identifikator (siehe oben)

7. Klicken Sie auf das Symbol Save (Häkchen)

Fehlerbehebung

Der Benutzer wird nach der Anmeldung zur Anmeldeseite zurückgeleitet.

1. Wenn Provisioning aktiviert wurde, wurde der Benutzer möglicherweise erstellt, aber keiner Gruppe zugewiesen, oder die Gruppen, denen der Benutzer zugewiesen wurde, wurde keiner App Builder-Anwendung Zugriff gewährt. Die einzige Gruppe, die neuen Benutzern standardmäßig zugewiesen wird (d. h. die Option Grant On User Create ist aktiviert), ist die Gruppe „Users". Diese Gruppe hat standardmäßig keinen Zugriff auf Anwendungen.

2. Wenn die Option Supplies Group Membership aktiviert wurde, registriert App Builder alle Auth0-Gruppen, die über eine SAML-Assertion übertragen werden. Melden Sie sich als Administrator an und ordnen Sie die Auth0-Gruppen den App Builder-Sicherheitsgruppen zu.

3. Wenn die Option Supplies Group Membership nicht aktiviert wurde, hat der Auth0-Sicherheitsanbieter keine Gruppen. Melden Sie sich als Administrator an und definieren Sie eine oder mehrere Auth0-Anbietergruppen mit aktivierter Option Grant On Identity Create und ordnen Sie die Anbietergruppen den App Builder-Sicherheitsgruppen zu.

4. Wenn der Sicherheitsanbieter Require HTTPS nicht aktiviert wurde, kann der Benutzer den SAML-SSO-Prozess von einer unsicheren URL aus initiieren (z. B. http://example.com/). Auth0 kann den Benutzer jedoch zur sicheren Assertion Consumer Service (ACS)-URL (https://example.com/signin-Auth0) zurückleiten. App Builder authentifiziert den Benutzer im Kontext der sicheren URL, bevor der Benutzer zur unsicheren URL zurückgeleitet wird. Letztendlich hat der Benutzer zwei separate Sitzungen. Um dieses Problem zu beheben, aktivieren Sie den Sicherheitsanbieter Require HTTPS.