> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers.md).

# Identitätsanbieter (SSO)

Lassen Sie Ihre Benutzer sich mit Ihrem bestehenden Identitätsanbieter bei Dispel anmelden. Verbinden Sie Microsoft Entra ID, Okta oder PingIdentity über OAuth (OIDC) oder SAML für Single Sign-on.

## Übersicht

Wenn Sie einen Identitätsanbieter (IdP) anbinden, können sich Ihre Nutzer mit denselben Unternehmenszugangsdaten bei Dispel anmelden, die sie auch sonst überall verwenden – Single Sign-on (SSO). Statt ein separates Dispel-Passwort zu verwalten, übernimmt Ihr IdP die Authentifizierung und teilt Dispel mit, wer der Nutzer ist.

Dispel unterstützt vier Identitätsanbieter. Active Directory wird über LDAP(S) angebunden; Microsoft Entra ID, Okta und Ping Identity können jeweils entweder über OAuth (OIDC) oder SAML angebunden werden:

* [**Active Directory**](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/active-directory.md) – Microsofts lokaler Verzeichnisdienst.
* [**Microsoft Entra ID**](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/microsoft-entra-id.md) – Microsofts cloudbasierte Identitätsplattform (früher Azure AD).
* [**Okta**](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/okta.md) – Oktas Identitätsplattform für Unternehmen.
* [**PingIdentity**](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/ping-identity.md) – Pings föderierte Identitätsplattform.

{% hint style="info" %}
**Wo Sie sie finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen** (oder die spezielle Seite **Einstellungen → Authentifizierung** ). Die Anbieter finden Sie im Abschnitt **Identität & Authentifizierung (IdP / SSO)** . Klicken Sie bei einem Anbieter auf **Verbinden** , um zu beginnen.
{% endhint %}

{% hint style="warning" %}
**Ein Identitätsanbieter pro Organisation.** Eine Organisation kann jeweils nur einen aktiven IdP und ein einziges Protokoll verwenden. Um den Anbieter zu wechseln oder einen bestehenden Anbieter von OAuth zu SAML (oder umgekehrt) umzustellen, müssen Sie zuerst die Verbindung zum aktuellen Anbieter trennen.
{% endhint %}

## Ein Protokoll auswählen

Welches Protokoll Sie verwenden, hängt vom Anbieter ab, den Sie anbinden:

* Active Directory kann nur über LDAP(S) angebunden werden.
* Microsoft Entra ID, Okta und Ping Identity unterstützen sowohl OAuth (OIDC) als auch SAML. Wenn Sie einen dieser Anbieter konfigurieren, können Sie zwischen den beiden Protokollen wählen. Pro Anbieter kann jeweils nur eines aktiv sein.

Wählen Sie bei diesen drei Cloudanbietern zwischen OIDC und SAML – je nachdem, wie Ihre IdP-Anwendung eingerichtet ist:

| Protokoll        | Beschreibung                                                                                                              | Wählen Sie es, wenn                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **OAuth** (OIDC) | Ein offener Standard für die Delegierung des Zugriffs, der häufig für die tokenbasierte Authentifizierung verwendet wird. | Ihre IdP-Anwendung als OIDC- / OAuth-Anwendung eingerichtet ist.                                            |
| **SAML**         | Ein XML-basiertes Framework zum Austausch von Authentifizierungs- und Autorisierungsdaten zwischen Parteien.              | Ihre IdP-Anwendung als SAML-Anwendung eingerichtet ist oder Ihre Organisation standardmäßig SAML verwendet. |

> Active Directory verwendet LDAP(S) – ein Protokoll zum Abfragen eines Verzeichnisservers und zur Authentifizierung bei diesem, abgesichert durch TLS. Da AD nur LDAP(S) unterstützt, ist für Active Directory keine Protokollauswahl erforderlich.

## Was Sie bereitstellen und was Dispel bereitstellt

Die Einrichtung von SSO ist ein Austausch in beide Richtungen. Sie geben Dispel Details zu Ihrem IdP an und fügen – bei SAML – die Details von Dispel als Dienstanbieter in Ihrem IdP ein.

#### OAuth (OIDC)

Geben Sie Folgendes in Dispel ein:

| Feld                     | Einzugebender Wert                                                                                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Client-URL**           | Die URL, an die OAuth-Token gesendet werden. Sie finden sie in den Einstellungen Ihres IdP.                                                                                    |
| **Client-ID**            | Die eindeutige Kennung Ihres IdP (häufig eine URL oder URN). Sie finden sie in den Einstellungen Ihres IdP.                                                                    |
| **Client-Secret**        | Das von Ihrem IdP ausgegebene Client-Secret.                                                                                                                                   |
| **Organisationskennung** | Eine eindeutige Kennung, die *Sie* festlegen. Ihre Nutzer geben sie auf dem Dispel-Anmeldebildschirm ein. Zulässig sind nur Buchstaben, Zahlen, Bindestriche und Unterstriche. |

Registrieren Sie Dispel auf der Seite Ihres IdP als Anwendung und legen Sie dessen **Weiterleitungs-URI** auf Ihre Dispel-Adresse gefolgt von `/oauth/login-callback` (zum Beispiel `https://app.dispel.com/oauth/login-callback`). Wenn Sie sich bei der genauen Adresse für Ihre Umgebung nicht sicher sind, fragen Sie Ihre Ansprechperson bei Dispel.

#### SAML

Dispel zeigt oben im SAML-Formular zwei schreibgeschützte Werte an – fügen Sie diese in die SAML-Anwendung Ihres IdP ein:

| Dispel stellt bereit                     | In Ihrem IdP einfügen als                             |
| ---------------------------------------- | ----------------------------------------------------- |
| **Entity-ID des Service Providers (SP)** | Die SP-Entity-ID bzw. Audience.                       |
| **Assertion Consumer Service-URL**       | Die ACS-URL bzw. Antwort-URL oder Single-Sign-on-URL. |

Verwenden Sie die Schaltflächen **ID kopieren** und **URL kopieren** neben den jeweiligen Werten. Geben Sie anschließend Folgendes in Dispel ein:

| Feld                                  | Einzugebender Wert                                                                                                                  |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **SSO-URL**                           | Die URL, an die die SAML-Assertion gesendet wird – finden Sie in den Einstellungen Ihres IdP.                                       |
| **Entity-ID des Identitätsanbieters** | Der eindeutige Bezeichner Ihres IdP (oft eine URL oder URN).                                                                        |
| **Base64-Signaturzertifikat**         | Das Zertifikat, mit dem Ihr IdP SAML-Assertions signiert. Fügen Sie es ein oder verwenden Sie **Zertifikat hochladen** (max. 1 MB). |
| **Organisationskennung**              | Ein eindeutiger Bezeichner, *den* Sie auswählen. Ihre Benutzer geben ihn auf dem Dispel-Anmeldebildschirm ein.                      |

#### LDAP(S)

Im Gegensatz zu SSO-Abläufen basiert LDAP nicht auf einem Weiterleitungs-Handshake – Dispel stellt direkt eine Verbindung zu Ihrem Verzeichnis her und authentifiziert Benutzer darüber. Es müssen keine Werte in ein anderes System übertragen werden; die gesamte Konfiguration erfolgt in Dispel. Die folgenden Werte erhalten Sie von Ihrer Active-Directory-Administration.

Geben Sie Folgendes in Dispel ein:

| Feld                                       | Einzugebender Wert                                                                                                                                                                                                                                     |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Anmeldekennung**                         | Ein eindeutiger Bezeichner, *den* Sie auswählen. Ihre Benutzer geben ihn auf dem Dispel-Anmeldebildschirm ein.                                                                                                                                         |
| **Active-Directory-Domäne**                | Ihre AD-DNS-Domäne, z. B. `corp.example.com`.                                                                                                                                                                                                          |
| **Domänencontroller**                      | Der Hostname bzw. die Hostnamen der Domänencontroller, zu denen Dispel über LDAPS (Port 636) eine Verbindung herstellt, z. B. `dc01.corp.example.com`.                                                                                                 |
| **Zertifikatsvertrauen und CA-Zertifikat** | Legen Sie fest, wie Dispel die TLS-Verbindung überprüft, und geben Sie (empfohlen) das CA-Zertifikat an, mit dem die Zertifikate Ihrer Domänencontroller ausgestellt wurden. Erhalten Sie es von Ihrer PKI- oder AD-Administration; PEM, CRT oder CER. |
| **Bind-DN oder UPN**                       | Das schreibgeschützte Dienstkonto, mit dem sich Dispel authentifiziert, z. B. `svc-dispel@corp.example.com`.                                                                                                                                           |
| **Bind-Kennwort**                          | Das Kennwort des Dienstkontos.                                                                                                                                                                                                                         |
| **Suchbasis für Benutzer**                 | Der Verzeichnisstandort (OU), in dem nach Benutzern gesucht wird, z. B. `OU=Users,DC=corp,DC=example,DC=com`.                                                                                                                                          |
| **Suchbasis für Gruppen**                  | Der Verzeichnisstandort (OU), in dem nach Gruppen gesucht wird.                                                                                                                                                                                        |
| **Anmeldeattribut**                        | Das Attribut, das Benutzer als Benutzernamen eingeben – häufig `sAMAccountName`.                                                                                                                                                                       |

## Einen Anbieter einrichten

Die genauen Schritte auf der IdP-Seite unterscheiden sich je nach Anbieter – Einzelheiten finden Sie auf der jeweiligen Anbieterseite. Der allgemeine Ablauf ist derselbe:

1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie auf **Verbinden** auf der Karte des Anbieters.
2. **Authentifizierungsprotokoll auswählen** — OAuth oder SAML.
3. *(nur SAML)* Kopieren Sie die **SP-Entity-ID** und die **ACS-URL** in die SAML-App Ihres IdP.
4. Füllen Sie die Verbindungsfelder mit den Werten Ihres IdP aus und wählen Sie eine **Organisationskennung**.
5. Klicken Sie auf **Einstellungen speichern**.
6. *(nur SAML)* Klicken Sie auf **Verbindung testen**. Dispel leitet Sie zum Anmelden an Ihren IdP weiter und zeigt anschließend die empfangenen Benutzerattribute an (E-Mail, Vorname, Nachname). Schlägt der Test fehl, prüfen Sie, ob die Angaben mit der SAML-App Ihres IdP übereinstimmen und ob der Testbenutzer in Ihrem IdP vorhanden und zu dieser Organisation eingeladen ist.

> Verbinden Sie Active Directory? AD verwendet LDAP(S) und folgt einem anderen Ablauf – Dispel stellt die Verbindung direkt zu Ihrem Verzeichnis her, statt über einen SSO-Handshake umzuleiten. Außerdem muss kein Protokoll ausgewählt werden. Die vollständige Anleitung finden Sie im [Einrichtungsleitfaden für Active Directory](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/active-directory.md) .

{% hint style="info" %}
**Geheimnisse werden maskiert.** Nach dem Speichern werden Geheimnisfelder (Clientgeheimnis, Zertifikat) maskiert. Lassen Sie ein maskiertes Feld bei späteren Änderungen unverändert, um den gespeicherten Wert beizubehalten.
{% endhint %}

## So melden sich Benutzer an

Sobald SSO eingerichtet ist, melden sich Benutzer mit Ihrem IdP statt mit einem Dispel-Passwort an:

1. Auf der Dispel-Anmeldeseite gibt der Benutzer Ihre **Organisationskennung**.
2. ein. Dispel leitet ihn zur Authentifizierung an Ihren IdP weiter.
3. Nach erfolgreicher Anmeldung wird der Benutzer zu Dispel zurückgeleitet und angemeldet.

Dispel liest die Angaben des Benutzers zu **E-Mail-Adresse,**, **Vorname**, und **Nachname** aus der Antwort des IdP aus.

{% hint style="info" %}
**Benutzer müssen zuerst eingeladen werden.** SSO authentifiziert einen Benutzer, gewährt aber nicht automatisch Zugriff. Ein Benutzer muss bereits in Dispel zu Ihrer Organisation eingeladen worden sein, bevor er sich per SSO anmelden kann. Siehe [Einen Benutzer zu Dispel einladen](https://docs.dispel.com/documentation/documentation-de/benutzer-and-zugriff-verwalten/users/invite-a-user.md).
{% endhint %}

## Gruppenzuordnung

Sie können SSO-Benutzer anhand ihrer Gruppen in Ihrem IdP automatisch Dispel-Gruppen zuordnen. Dispel synchronisiert die Gruppenmitgliedschaften nach einem Zeitplan, damit die Zugriffsrechte mit Ihrem IdP übereinstimmen. Siehe [Gruppenzuordnung](https://docs.dispel.com/documentation/documentation-de/integrieren-and-administrieren/integrations/group-mapping.md).

## SSO und Multi-Faktor-Authentifizierung

Wenn SSO verwendet wird, ist Ihr IdP für die Authentifizierung zuständig – einschließlich aller dort durchgesetzten MFA-Anforderungen. Daher werden die einmalig verwendbaren E-Mail-Codes von Dispel nicht auf Benutzer angewendet, die sich per SSO anmelden. Berücksichtigen Sie dies beim Festlegen der MFA-Anforderungen im [Richtlinien-Builder](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/policy-builder.md).

## Anbieter wechseln oder Verbindung trennen

Um den Anbieter zu wechseln oder einen Anbieter zwischen OAuth und SAML umzustellen, müssen Sie zuerst die aktuelle Integration **trennen** und dann die neue verbinden.

{% hint style="warning" %}
**Beim Trennen der Verbindung wird ein Passwort-Reset erzwungen.** Wenn Sie eine SSO-Integration entfernen, können die betroffenen Nutzer sich nicht mehr über den IdP anmelden. Sie müssen ihre Dispel-Passwörter zurücksetzen, um sich wieder anzumelden. Außerdem müssen Sie alle Felder erneut ausfüllen, um die Verbindung wiederherzustellen.
{% endhint %}

## Häufig gestellte Fragen

<details>

<summary>Kann ich mehrere Identitätsanbieter gleichzeitig verwenden?</summary>

Nein. Eine Organisation kann jeweils nur einen aktiven IdP haben. Wenn Sie bereits mit einem Anbieter verbunden sind, sind die anderen nicht verfügbar, bis Sie die Verbindung trennen. Sie sehen dann einen Hinweis, dass Sie derzeit mit einem anderen Anbieter verbunden sind und zuerst die Verbindung trennen müssen.

</details>

<details>

<summary>Kann ich für denselben Anbieter sowohl OAuth als auch SAML verwenden?</summary>

Nein. Pro Identitätsanbieter wird jeweils nur ein Authentifizierungsprotokoll unterstützt. Um das Protokoll zu wechseln, trennen Sie die Verbindung und stellen Sie sie mit dem anderen Protokoll wieder her.

</details>

<details>

<summary>Was ist die Organisationskennung?</summary>

Das ist eine kurze, eindeutige Kennung, die Sie auswählen (Buchstaben, Zahlen, Bindestriche und Unterstriche). Ihre Nutzer geben sie auf dem Dispel-Anmeldebildschirm ein, damit Dispel weiß, an welchen IdP sie weitergeleitet werden sollen.

</details>

<details>

<summary>Erhält ein Nutzer bei der ersten SSO-Anmeldung automatisch ein Konto?</summary>

Nur, wenn der Nutzer bereits in Ihre Organisation eingeladen wurde. SSO bestätigt die Identität eines Nutzers, aber um Zugriff zu erhalten, muss er in Dispel eingeladen worden sein.

</details>

<details>

<summary>Wer kann SSO konfigurieren?</summary>

Ein Organisationsadministrator. Zum Konfigurieren oder Trennen der Verbindung zu einem Identitätsanbieter ist die Berechtigung zum Bearbeiten der Organisation erforderlich.

</details>


---

# 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.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers.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.
