Richten Sie OIDC SSO ein
OIDC ist eine Alternative zu SAML für die Anbindung Ihres Identitätsanbieters. Bei beiden kann sich Ihr Team mit den vorhandenen Unternehmenskonten anmelden. OIDC ist ein moderneres Protokoll, das einige Anbieter bevorzugen. Wenn Sie nicht sicher sind, welches Sie verwenden sollen, verwenden Sie SAML – es ist der Standard und funktioniert mit jedem unterstützten Anbieter. Greifen Sie zu OIDC, wenn Ihr Anbieter es empfiehlt oder wenn SAML für Sie keine Option ist.
Das Setup hat dieselbe Form wie bei SAML – konfigurieren, Ihre Domain verifizieren, testen und dann einschalten – mit ein paar OIDC-spezifischen Details.
Bevor Sie beginnen
- Ein Administratorkonto mit der Berechtigung zum Verwalten von Single Sign-On.
- Zugriff auf die Admin-Konsole Ihres Identitätsanbieters.
- Eine Domain, die Sie verifizieren können (die E-Mail-Domain, mit der sich Ihr Team anmeldet).
Öffnen Sie den Einrichtungsassistenten
- Gehen Sie zu Benutzerverwaltung → Single Sign-On.
- Wählen Sie Single Sign-On einrichten.
- Wählen Sie Ihren Anbieter aus und stellen Sie dann das Protokoll auf OIDC um.
Tauschen Sie Einstellungen mit Ihrem Identitätsanbieter aus
-
Erstellen Sie eine neue OIDC-Anwendung (oder „OpenID Connect“) in der Konsole Ihres Anbieters. Kliv zeigt Ihnen die Weiterleitungs-URL zum Einfügen an.
-
Ihr Anbieter gibt Ihnen eine Client-ID, ein Client-Secret und eine Aussteller-URL (die Webadresse, die den Anmeldedienst Ihres Anbieters identifiziert). Fügen Sie alle drei in Kliv ein.
-
Die Aussteller-URL muss Zeichen für Zeichen genau mit Ihrem Anbieter übereinstimmen. Das ist der häufigste Fehler:
- Microsoft Entra-Aussteller sind spezifisch für Ihren Mandanten und enthalten eine lange Kennung – kopieren Sie sie aus Ihrer eigenen App, übernehmen Sie sie nicht aus einem Leitfaden.
- Google veröffentlicht seinen Aussteller in mehr als einer Form; verwenden Sie genau die, die Ihre Konsole anzeigt.
Wenn der Aussteller auch nur geringfügig abweicht, werden gültige Anmeldungen abgelehnt. Der folgende Testschritt zeigt Ihnen, ob dies das Problem ist.
Kliv speichert dies als Entwurf – konfiguriert, aber nicht live. Ihr Team meldet sich weiterhin wie bisher an, bis Sie fertig sind.
Verifizieren Sie Ihre Domain
Wie bei SAML erstellt Kliv keine Konten von Ihrem Anbieter, bis Sie nachgewiesen haben, dass Sie die E-Mail-Domain kontrollieren. Folgen Sie Verifizieren Sie Ihre Domain und kehren Sie dann hierher zurück, sobald Verifiziert angezeigt wird.
Testen Sie mit einer echten Anmeldung
- Wählen Sie Anmeldung testen.
- Melden Sie sich bei Ihrem Anbieter genau so an, wie es Ihr Team tun wird.
- Bei Erfolg zeichnet Kliv den Test auf und schaltet Aktivieren frei.
- Bei einem Fehler zeigt Kliv die erwarteten gegenüber den empfangenen Details an, sodass Sie den Aussteller, das Secret oder die Weiterleitung korrigieren können – siehe Beheben Sie eine fehlgeschlagene SSO-Anmeldung.
Schalten Sie es ein
Sobald eine Testanmeldung erfolgreich war, wählen Sie Aktivieren. Personen auf Ihrer verifizierten Domain werden jetzt zur Anmeldung an Ihren Anbieter weitergeleitet, und bei der erstmaligen Anmeldung wird automatisch ein Standardmitgliedskonto erstellt.
Neue Mitglieder erhalten nur Mitgliederzugriff – keine erhöhte Rolle, es sei denn, Sie konfigurieren die Gruppenzuordnung.
Ein Hinweis zur Benutzeridentität
OIDC identifiziert jede Person anhand eines stabilen Wertepaars Ihres Anbieters, nicht anhand ihrer E-Mail-Adresse. Das ist Absicht: Es bedeutet, dass eine Person dasselbe Kliv-Konto behält, auch wenn sich ihre E-Mail-Adresse ändert, und es bedeutet, dass Kliv nicht davon abhängt, dass Ihr Anbieter eine E-Mail als „verifiziert“ markiert (einige Anbieter senden dies nicht für Arbeitskonten). Sie müssen hierfür nichts konfigurieren – es ist nur nützlich zu wissen, warum eine geänderte E-Mail-Adresse kein doppeltes Konto erstellt.