> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/oidc-identitatsanbieter/auth0-oidc-konfiguration.md).

# Auth0 – OIDC – Konfiguration

{% hint style="success" %}

#### Erforderliche Benutzeranmeldeinformationen

\[**Flosum-Benutzer**] - **Systemadministrator** Rolle
{% endhint %}

{% hint style="success" %}

#### 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.
{% endhint %}

## ![](https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) Ü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.

{% hint style="info" %}
Allgemeinere Anweisungen zum Hinzufügen eines Identity Providers finden Sie im folgenden Artikel.

* [Einen Identitätsanbieter hinzufügen (SSO)](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/einen-identitatsanbieter-hinzufugen-sso.md)
  {% endhint %}

{% hint style="warning" %}

#### 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.
{% endhint %}

### Ü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.

{% hint style="warning" %}
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.
{% endhint %}

{% stepper %}
{% step %}

### 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**.

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FomnigYvY4E4F48xh3wxC%2FAuth0Setup-S01-01.png?alt=media&amp;token=b0027c85-595b-4fa5-8d08-52ce8d319c95" alt=""><figcaption></figcaption></figure></div>
3. Klicken Sie auf **Standard-App** um den Bildschirm „Default App“ zu öffnen.

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F1MaPpR3sugGZcgddLZuh%2FAuth0Setup-S01-02.png?alt=media&amp;token=108cb236-47a9-47e9-ada0-fccdbc08c37b" alt="" width="545"><figcaption></figcaption></figure></div>
4. Kopieren Sie die **Domäne**, **Client-ID**, und **Client-Secret** Werte zum Erstellen eines Identity Providers in den globalen Flosum-Einstellungen.
   {% endstep %}

{% step %}

### 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.

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FlUTgoT5hR3slZeLNU6LR%2FAuth0Setup-S01-03.png?alt=media&amp;token=b3abf8b5-c3f5-46ce-ba00-0734151f1c2b" alt=""><figcaption></figcaption></figure></div>

{% tabs %}
{% tab title="USA-URLs" %}

<table><thead><tr><th width="180">Flosum Cloud-App</th><th>Callback-URL</th></tr></thead><tbody><tr><td>Globale Einstellungen</td><td>https://global-us.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Sicherung &#x26; Archiv</td><td>https://backup-us.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-us.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs für Deutschland" %}

<table><thead><tr><th width="180">Flosum Cloud-App</th><th>Callback-URL</th></tr></thead><tbody><tr><td>Globale Einstellungen</td><td>https://global-de.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Sicherung &#x26; Archiv</td><td>https://backup-de.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-de.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs für Japan" %}

<table><thead><tr><th width="180">Flosum Cloud-App</th><th>Callback-URL</th></tr></thead><tbody><tr><td>Globale Einstellungen</td><td>https://global-jp.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Sicherung &#x26; Archiv</td><td>https://backup-jp.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-jp.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}

{% tab title="URLs für Australien" %}

<table><thead><tr><th width="180">Flosum Cloud-App</th><th>Callback-URL</th></tr></thead><tbody><tr><td>Globale Einstellungen</td><td>https://global-au.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>Sicherung &#x26; Archiv</td><td>https://backup-au.flosum.app/api/v1/auth/login/open-id</td></tr><tr><td>DevOps</td><td>https://devops-au.flosum.app/api/v1/auth/login/open-id</td></tr></tbody></table>
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

## Identity Provider in den globalen Einstellungen erstellen

{% stepper %}
{% step %}

### 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)](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/einen-identitatsanbieter-hinzufugen-sso.md)
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** |

<div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FrmX0ZPRXgUouMlH6G1eR%2FAuth0Setup-CreateIdentityProvider-01.png?alt=media&amp;token=536005e8-3a36-4414-9e93-9d397c06278d" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Speichern und testen

{% hint style="info" %}
Anweisungen zum Anmelden mit SSO finden Sie im folgenden Artikel.

* [Mit SSO anmelden](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/mit-sso-anmelden.md)
  {% endhint %}

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.&#x20;

<div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fy19T52NShfgsh5O0sKcn%2FAuth0Setup-CreateIdentityProvider-02.png?alt=media&amp;token=7c54c63e-6928-496e-96ed-7dd4704fa33c" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FToj56imIEMIUdhQZkJMB%2FAuth0Setup-S03-03.png?alt=media&amp;token=0b2c641c-fb7d-4147-9b72-53f25894bfb9" alt="" width="269"><figcaption></figcaption></figure></div>

{% hint style="info" %}
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`
  {% endhint %}
  {% endstep %}
  {% endstepper %}

## 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.

{% stepper %}
{% step %}

### Benutzer erstellen und Attribute hinzufügen

{% hint style="info" %}
Wenn Sie bereits ein Benutzer sind, können Sie Attribute hinzufügen, indem Sie die Schritte 1 und 2 in diesem Abschnitt überspringen.
{% endhint %}

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

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/jGieDyPNFSHI5mTiWUkx/rtaImage" alt=""><figcaption></figcaption></figure>
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.&#x20;
4. Notieren Sie sich Ihre **user\_id**, da Sie sie später im Prozess benötigen.

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/733VcyIwresF2GlGG5Ht/rtaImage" alt=""><figcaption></figcaption></figure>
5. Klicken Sie auf **Anwendung** in der linken Seitenleiste und klicken Sie dann auf **APIs**.

   <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/zudbVc7VcNN28LlnrcG8/rtaImage" alt=""><figcaption></figcaption></figure>
6. Klicken Sie auf **Auth0 Management API**.
7. Klicken Sie auf die **Test** Registerkarte.

   <div align="left"><figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/MqRFhBx8tw4NcsfDMs2D/rtaImage" alt="" width="563"><figcaption></figcaption></figure></div>
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.

    <div align="left"><figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/vitukU0KDNwKgugdEdqs/rtaImage" alt="" width="563"><figcaption></figcaption></figure></div>
11. Klicken Sie auf **Dokumentation** oben rechts auf Ihrem Bildschirm, um [Auth0-Dokumentation](https://auth0.com/docs).

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/WkNSHVe9dZGqDcGxgRKv/rtaImage" alt=""><figcaption></figcaption></figure>
12. Klicken Sie auf **Auth0-APIs**.
13. Klicken Sie auf **Management-API-Explorer** in der linken Seitenleiste.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/METFuADxEhqPQZY6rvs2/rtaImage" alt=""><figcaption></figcaption></figure>
14. Klicken Sie auf **Benutzer** in der linken Seitenleiste und klicken Sie dann auf **Einen Benutzer aktualisieren**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/htpHtJF88mbqRNU90MtG/rtaImage" alt=""><figcaption></figcaption></figure>
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.&#x20;
16. Die Schaltfläche „API-Token festlegen“ sollte jetzt **Autorisiert**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/Aujhq6QaCcZqLAKYHTFa/rtaImage" alt=""><figcaption></figcaption></figure>
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.&#x20;
18. Klicken Sie auf **Endpunkt testen**.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/TQ9lbBsxdWVvT3hfuiy9/rtaImage" alt=""><figcaption></figcaption></figure>
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.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/e2vy1dwDF8gdq0zItUls/rtaImage" alt=""><figcaption></figcaption></figure>
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.

    <figure><img src="https://content.gitbook.com/content/sEk2hU5IMh3HEY5dJZjR/blobs/Pcr2053LShUl0OhKzAlf/rtaImage" alt=""><figcaption></figcaption></figure>
21. Kehren Sie zu Flosum Backup & Archive zurück und melden Sie sich an.
    {% endstep %}
    {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/oidc-identitatsanbieter/auth0-oidc-konfiguration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.