For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Das Verbinden eines Identitätsanbieters (IdP) ermöglicht es Ihren Benutzern, sich mit denselben Unternehmensanmeldedaten bei Dispel anzumelden, die sie bereits überall sonst verwenden — Single Sign-On (SSO). Anstatt ein separates Dispel-Passwort zu verwalten, übernimmt Ihr IdP die Authentifizierung und teilt Dispel mit, wer der Benutzer ist.

Dispel unterstützt vier Identitätsanbieter. Active Directory verbindet sich über LDAP(S); Microsoft Entra ID, Okta und Ping Identity verbinden sich jeweils entweder über OAuth (OIDC) oder SAML:

Wo Sie es finden. Melden Sie sich als Organisationsadministrator an und öffnen Sie Einstellungen → Integrationen (oder auf der speziellen Einstellungen → Authentifizierung Seite). Die Anbieter erscheinen in der Identität & Authentifizierung (IdP / SSO) . Klicken Sie auf Verbinden auf einen Anbieter, um zu beginnen.

Ein Protokoll auswählen

Das Protokoll, das Sie verwenden, wird durch den Anbieter bestimmt, den Sie verbinden:

  • Active Directory verbindet sich nur über LDAP(S).

  • Microsoft Entra ID, Okta und Ping Identity unterstützen jeweils sowohl OAuth (OIDC) als auch SAML. Wenn Sie einen dieser Anbieter konfigurieren, können Sie zwischen diesen beiden Protokollen wählen. Pro Anbieter kann jeweils nur eines aktiv sein.

Für diese drei Cloud-Anbieter wählen Sie zwischen OIDC und SAML anhand der Einrichtung Ihrer IdP-Anwendung:

Protokoll
Was es ist
Wählen Sie es, wenn

OAuth (OIDC)

Ein offener Standard für die Zugriffsdelegierung, der häufig für tokenbasierte Authentifizierung verwendet wird.

Ihre IdP-App ist als OIDC-/OAuth-Anwendung eingerichtet.

SAML

Ein XML-basiertes Framework zum Austausch von Authentifizierungs- und Autorisierungsdaten zwischen Parteien.

Ihre IdP-App ist als SAML-Anwendung eingerichtet, oder Ihre Organisation standardisiert auf SAML.

Active Directory verwendet LDAP(S) — ein Protokoll zum Abfragen und zur Authentifizierung gegenüber einem Verzeichnisserver, abgesichert mit TLS. Da AD nur LDAP(S) unterstützt, gibt es dafür keinen Schritt zur Protokollauswahl.

Was Sie bereitstellen und was Dispel bereitstellt

Die Einrichtung von SSO ist ein zweiseitiger Austausch. Sie geben Dispel Details zu Ihrem IdP, und — bei SAML — fügen Sie die Details des Dienstanbieters von Dispel wieder in Ihren IdP ein.

OAuth (OIDC)

Sie geben in Dispel Folgendes ein:

Feld
Was einzugeben ist

Client-URL

Die URL, an die OAuth-Tokens gesendet werden — zu finden in Ihren IdP-Einstellungen.

Client ID

Die eindeutige Kennung Ihres IdP (oft eine URL oder URN) aus Ihren IdP-Einstellungen.

Client-Secret

Das von Ihrem IdP ausgestellte Client-Geheimnis.

Organisationskennung

Eine eindeutige Kennung Sie auswählen. Ihre Benutzer geben dies auf dem Anmeldebildschirm von Dispel ein. Nur Buchstaben, Zahlen, Bindestriche und Unterstriche.

Auf der IdP-Seite registrieren Sie Dispel als Anwendung und setzen dessen Umleitungs-URI auf Ihre Dispel-Adresse gefolgt von /oauth/login-callback (zum Beispiel, https://app.dispel.com/oauth/login-callback). Wenn Sie sich über die genaue Adresse für Ihre Umgebung nicht sicher sind, bestätigen Sie sie mit Ihrem Dispel-Ansprechpartner.

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 Ihren IdP einfügen als

Entity-ID des Service Providers (SP)

Die SP-Entity-ID / Audience.

Assertion-Consumer-Service-URL

Die ACS-URL / Reply-URL / Single-Sign-On-URL.

Verwenden Sie die ID kopieren und URL kopieren Schaltflächen daneben. Geben Sie dann Folgendes in Dispel ein:

Feld
Was einzugeben ist

SSO-URL

Die URL, an die die SAML-Assertion gesendet wird — zu finden in Ihren IdP-Einstellungen.

Entity-ID des Identitätsanbieters

Die eindeutige Kennung 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

Eine eindeutige Kennung Sie auswählen. Ihre Benutzer geben dies auf dem Anmeldebildschirm von Dispel ein.

LDAP(S)

Im Gegensatz zu den SSO-Flows ist LDAP kein Weiterleitungs-basiertes Handshake-Verfahren — Dispel verbindet sich direkt mit Ihrem Verzeichnis und authentifiziert Benutzer dagegen. Es gibt nichts, was in ein anderes System zurückzukopieren wäre; die gesamte Konfiguration erfolgt in Dispel. Die folgenden Werte stammen von Ihrem Active Directory-Administrator.

Sie geben in Dispel Folgendes ein:

Feld
Was einzugeben ist

Anmeldekennung

Eine eindeutige Kennung Sie auswählen. Ihre Benutzer geben dies auf dem Anmeldebildschirm von Dispel ein.

Active Directory-Domäne

Ihre AD-DNS-Domäne — z. B. corp.example.com.

Domänencontroller

Der/die Hostname(s) des/der Domänencontroller(s), mit denen sich Dispel über LDAPS (Port 636) verbindet — z. B. dc01.corp.example.com.

Zertifikatsvertrauen + CA-Zertifikat

Wie Dispel die TLS-Verbindung validiert, und das (empfohlene) CA-Zertifikat, das die Zertifikate Ihrer Domänencontroller ausgestellt hat. Von Ihrem PKI- oder AD-Administrator; PEM, CRT oder CER.

Bind-DN oder UPN

Das schreibgeschützte Dienstkonto, als das sich Dispel authentifiziert — z. B. svc-dispel@corp.example.com.

Bind-Passwort

Das Passwort des Dienstkontos.

Benutzersuchbasis

Der Verzeichnisort (OU), in dem nach Benutzern gesucht wird — z. B. OU=Users,DC=corp,DC=example,DC=com.

Gruppensuchbasis

Der Verzeichnisort (OU), in dem nach Gruppen gesucht wird.

Anmeldeattribut

Das Attribut, das Benutzer als ihren Benutzernamen eingeben — üblicherweise sAMAccountName.

Anbieter einrichten

Die genauen Schritte auf der IdP-Seite unterscheiden sich je nach Anbieter — Details finden Sie auf der Seite des jeweiligen Anbieters. 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 ACS-URL in die SAML-App Ihres IdP.

  4. Füllen Sie die Verbindungsfelder mit den Werten Ihres IdP aus und wählen Sie einen Organisationskennung.

  5. Klicken Sie auf Einstellungen speichern.

  6. (nur SAML) Klicken Sie auf Verbindung testen. Dispel leitet Sie zu Ihrem IdP weiter, damit Sie sich anmelden, und zeigt dann die erhaltenen Benutzerattribute an (E-Mail, Vorname, Nachname). Wenn der Test fehlschlägt, prüfen Sie, ob die Details mit der SAML-App Ihres IdP übereinstimmen und ob der Testbenutzer in Ihrem IdP existiert und zu dieser Organisation eingeladen ist.

Verknüpfen Sie Active Directory? AD verwendet LDAP(S) und folgt einem anderen Ablauf — Dispel verbindet sich direkt mit Ihrem Verzeichnis statt über einen SSO-Handshake umzuleiten, und es gibt kein auszuwählendes Protokoll. Siehe den Einrichtungsanleitung für Active Directory für die vollständige Schritt-für-Schritt-Anleitung.

Geheimnisse werden maskiert. Nach dem Speichern werden geheime Felder (Client-Geheimnis, Zertifikat) maskiert. Wenn Sie später bearbeiten, lassen Sie ein maskiertes Feld unverändert, um den gespeicherten Wert beizubehalten.

Wie sich Benutzer anmelden

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

  1. Auf dem Anmeldebildschirm von Dispel gibt der Benutzer Ihren Organisationskennung.

  2. Dispel leitet sie zu Ihrem IdP weiter, damit sie sich authentifizieren.

  3. Bei Erfolg werden sie zu Dispel zurückgeleitet und angemeldet.

Dispel liest die E-Mail, Vorname und Nachname aus der Antwort des IdP.

Benutzer müssen zuerst eingeladen werden. SSO authentifiziert einen Benutzer, gewährt aber nicht automatisch Zugriff. Ein Benutzer muss bereits zu Ihrer Organisation in Dispel eingeladen sein, bevor er sich per SSO anmelden kann. Siehe Benutzer zu Dispel einladen.

Gruppenzuordnung

Sie können SSO-Benutzer automatisch anhand der Gruppen oder Claims, die Ihr IdP sendet, Dispel-Gruppen zuordnen. Die Gruppenmitgliedschaft wird bei jeder Anmeldung neu bewertet, sodass der Zugriff mit Ihrem IdP synchron bleibt. Siehe OIDC-Gruppenzuordnung.

SSO und Multi-Faktor-Authentifizierung

Wenn SSO verwendet wird, ist Ihr IdP für die Authentifizierung verantwortlich — einschließlich jeglicher MFA, die Sie dort erzwingen. Daher werden die E-Mail-Einmalcodes von Dispel nicht auf Benutzer angewendet, die sich per SSO anmelden. Berücksichtigen Sie dies bei der Gestaltung von MFA-Anforderungen in der Richtlinien-Builder.

Anbieter wechseln oder trennen

Um Anbieter zu ändern oder einen Anbieter zwischen OAuth und SAML umzuschalten, Trennen trennen Sie zuerst die aktuelle Integration und verbinden Sie dann die neue.

Häufig gestellte Fragen

Kann ich mehr als einen Identitätsanbieter gleichzeitig verwenden?

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

Kann ich für denselben Anbieter sowohl OAuth als auch SAML verwenden?

Nein. Pro Identitätsanbieter wird gleichzeitig nur ein Authentifizierungsprotokoll unterstützt. Um Protokolle zu wechseln, trennen Sie die Verbindung und verbinden Sie sich mit dem anderen erneut.

Was ist die Organisationskennung?

Es ist ein kurzes, eindeutiges Label, das Sie auswählen (Buchstaben, Zahlen, Bindestriche und Unterstriche). Ihre Benutzer geben es auf dem Anmeldebildschirm von Dispel ein, damit Dispel weiß, zu welchem IdP sie weitergeleitet werden sollen.

Erhält ein Benutzer beim ersten SSO-Anmelden automatisch ein Konto?

Nur wenn er bereits zu Ihrer Organisation eingeladen wurde. SSO weist nach, wer ein Benutzer ist, aber er muss in Dispel eine Einladung haben, um Zugriff zu erhalten.

Wer kann SSO konfigurieren?

Ein Organisationsadministrator. Das Konfigurieren oder Trennen eines Identitätsanbieters erfordert die Berechtigung zum Bearbeiten der Organisation.

Zuletzt aktualisiert

War das hilfreich?