Auth0 – OIDC – Konfiguration

Erforderliche Benutzeranmeldeinformationen

[Flosum-Benutzer] - Systemadministrator Rolle

Wichtiger Hinweis

Die Anweisungen in diesem Artikel beziehen sich auf eine App eines Drittanbieters und spiegeln möglicherweise nicht die neueste Version wider. Bitte verwenden Sie diese Anweisungen als Leitfaden zur Durchführung der Aufgabe, seien Sie jedoch darauf aufmerksam, dass einige Bildschirme, Feldnamen und Schritte geändert worden sein können.

Überblick

Dieser Leitfaden erklärt, wie Sie Auth0 mithilfe von OpenID Connect (OIDC) mit Flosum Cloud Apps integrieren, um Single Sign-On (SSO) für eine nahtlose Anmeldung zu ermöglichen.

Allgemeinere Anweisungen zum Hinzufügen eines Identity Providers finden Sie im folgenden Artikel.

• Einen Identitätsanbieter hinzufügen (SSO)

Kunden-gehostet

Kunden, die Flosum-Apps auf ihrer eigenen Infrastruktur hosten, haben eine benutzerdefinierte URL zum Anmelden bei ihren Apps. Wenn Sie diese Dokumentation verwenden, ersetzen Sie beliebige Flosum-gehostete URLs durch Ihre eigenen URLs.

Überblick über die beteiligten Schritte

• Auth0-App konfigurieren
• Callback-URLs hinzufügen
• Einen Identity Provider mit den globalen Flosum-Einstellungen erstellen
• SSO testen

Auth0 für Flosum Cloud Apps konfigurieren

In diesem Abschnitt erfahren Sie, wie Sie eine Auth0-Anwendung so konfigurieren, dass sie mit Flosum Cloud Apps für SSO funktioniert.

Bitte beachten Sie, dass die Anweisungen für Auth0-Anwendungen möglicherweise nicht der neuesten Version entsprechen. Einige Bildschirme, Feldnamen und Schritte haben sich möglicherweise geändert.

1

Anwendung in Auth0 konfigurieren

1. Melden Sie sich bei Ihrem Auth0-Konto an.
2. Klicken Sie auf Anwendungen in der linken Seitenleiste und klicken Sie dann auf Anwendungen.

   
3. Klicken Sie auf Standard-App um den Bildschirm „Default App“ zu öffnen.

   
4. Kopieren Sie die Domäne, Client-ID, und Client-Secret Werte zum Erstellen eines Identity Providers in den globalen Flosum-Einstellungen.

2

Callback-URLs hinzufügen

1. Klicken Sie auf die Einstellungen Registerkarte.
2. Im Zulässige Callback-URLs Feld, fügen Sie die URL Ihrer Region für jede Flosum Cloud App hinzu, die Sie mit SSO verwenden möchten. Die URLs für Ihre Region finden Sie in der unten stehenden Tabelle.

   

USA-URLs

Flosum Cloud-App	Callback-URL
Globale Einstellungen	https://global-us.flosum.app/api/v1/auth/login/open-id
Sicherung & Archiv	https://backup-us.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-us.flosum.app/api/v1/auth/login/open-id

URLs für Deutschland

Flosum Cloud-App	Callback-URL
Globale Einstellungen	https://global-de.flosum.app/api/v1/auth/login/open-id
Sicherung & Archiv	https://backup-de.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-de.flosum.app/api/v1/auth/login/open-id

URLs für Japan

Flosum Cloud-App	Callback-URL
Globale Einstellungen	https://global-jp.flosum.app/api/v1/auth/login/open-id
Sicherung & Archiv	https://backup-jp.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-jp.flosum.app/api/v1/auth/login/open-id

URLs für Australien

Flosum Cloud-App	Callback-URL
Globale Einstellungen	https://global-au.flosum.app/api/v1/auth/login/open-id
Sicherung & Archiv	https://backup-au.flosum.app/api/v1/auth/login/open-id
DevOps	https://devops-au.flosum.app/api/v1/auth/login/open-id

Identity Provider in den globalen Einstellungen erstellen

1

Identity Provider in den globalen Einstellungen erstellen

Befolgen Sie die allgemeinen Anweisungen im folgenden Artikel, um mit der Erstellung eines OIDC-Identitätsanbieters zu beginnen.

1. Einen Identitätsanbieter hinzufügen (SSO)

2. Vervollständigen Sie die Grundlegenden Informationen Abschnitt.

   1. Wählen Sie OPEN_ID für den Identitätsanbieter Typ.
3. Vervollständigen Sie die Schaltflächeninformationen Abschnitt.
4. (Optional) Vervollständigen Sie die Gruppeninformationen Abschnitt.

OpenID-Informationsfelder vervollständigen

Kopieren Sie die Informationen aus Ihrer Auth0-Anwendung in den Abschnitt OpenId Information. Die Tabelle erklärt, welche Auth0-Felder in welche Flosum-Felder eingetragen werden müssen. Der letzte Screenshot zeigt einen vollständig eingerichteten Identity Provider für eine Auth0-OIDC-Anwendung.

Die Auth0-Felder finden Sie unter: Auth0 -> Default App -> Settings -> Basic Information

Flosum-Feld	Auth0-Feld
Client-ID	Client-ID
Client-Secret	Client-Secret
Issuer	https:// + Domäne

2

Speichern und testen

Anweisungen zum Anmelden mit SSO finden Sie im folgenden Artikel.

• Mit SSO anmelden

1. Klicken Sie Speichern um den Identitätsanbieter zu speichern.
2. Zum Testen öffnen Sie ein Inkognito-Fenster.
3. Beginnen Sie die Anmeldung bei Global Settings mit Ihrem Mandantennamen.
4. Wenn der Identitätsanbieter erfolgreich konfiguriert wurde, sollten Sie die SSO-Schaltfläche sehen, die Sie erstellt haben.

Wenn Sie nach der Eingabe Ihrer Anmeldedaten auf den Fehler „IdP-Attribut given_name ist nicht definiert“ stoßen, fügen Sie dem Benutzer in Ihrem Auth0-Konto die folgenden Attribute hinzu.

• given_name
• family_name

Auth0 – Benutzer erstellen und Attribute hinzufügen

Wenn beim Versuch, sich mit Ihren Auth0-Anmeldedaten bei Backup & Archive anzumelden, ein Fehler auftritt, müssen Sie einen Benutzer erstellen und die given_name und family_name Attribute zu diesem Benutzer hinzufügen.

1

Benutzer erstellen und Attribute hinzufügen

Wenn Sie bereits ein Benutzer sind, können Sie Attribute hinzufügen, indem Sie die Schritte 1 und 2 in diesem Abschnitt überspringen.

1. Klicken Sie in Ihrem Auth0-Konto auf Benutzerverwaltung in der linken Seitenleiste und klicken Sie dann auf Benutzer.

   
2. Klicken Sie auf Benutzer erstellen und füllen Sie die erforderlichen Felder aus.
3. Öffnen Sie Ihren Benutzer und klicken Sie auf die Roh-JSON Registerkarte.
4. Notieren Sie sich Ihre user_id, da Sie sie später im Prozess benötigen.

   
5. Klicken Sie auf Anwendung in der linken Seitenleiste und klicken Sie dann auf APIs.

   
6. Klicken Sie auf Auth0 Management API.
7. Klicken Sie auf die Test Registerkarte.

   
8. Klicken Sie auf Testanwendung erstellen und autorisieren.
9. Klicken Sie auf die API-Explorer Registerkarte und klicken Sie auf Testanwendung erstellen und autorisieren.
10. Notieren Sie sich den Token, da Sie ihn später im Prozess benötigen.

    
11. Klicken Sie auf Dokumentation oben rechts auf Ihrem Bildschirm, um Auth0-Dokumentation.

    
12. Klicken Sie auf Auth0-APIs.
13. Klicken Sie auf Management-API-Explorer in der linken Seitenleiste.

    
14. Klicken Sie auf Benutzer in der linken Seitenleiste und klicken Sie dann auf Einen Benutzer aktualisieren.

    
15. Klicken Sie auf API-Token festlegen oben rechts auf Ihrem Bildschirm und fügen Sie dann den Wert des zuvor gespeicherten Tokens in das modale Fenster zur Autorisierung ein.
16. Die Schaltfläche „API-Token festlegen“ sollte jetzt Autorisiert.

    
17. Einfügen in Pfad: id den zuvor gespeicherten Benutzer-ID-Wert ein und löschen Sie alle Zeilen außer given_name und family_name. Füllen Sie die Bedeutung dieser Zeilen bei Bedarf aus.
18. Klicken Sie auf Endpunkt testen.

    
19. Sie müssen einen Antwortcode erhalten 200. Wenn Sie keinen 200-Antwortcode erhalten, wird eine Meldung angezeigt, die das Problem identifiziert. Typische Probleme könnten ein falscher Token oder Benutzer-ID sein.

    
20. Klicken Sie auf Benutzer in der linken Seitenleiste und klicken Sie auf die Roh-JSON Registerkarte. „given_name“ und „family_name“ hinzugefügt werden.

    
21. Kehren Sie zu Flosum Backup & Archive zurück und melden Sie sich an.