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

Single-Sign-On

Übersicht

Zusätzlich zur Anmeldung mit Benutzername und Passwort unterstützt FactFinder NG Single-Sign-On (SSO).

Wenn Single-Sign-On aktivieren für einen Benutzer aktiviert ist, kann sich dieser Benutzer mit SSO anmelden. Diese Option finden Sie im unteren Teil des Dialogs für Benutzereinstellungen:

Hinweis: SSO übernimmt nur die Authentifizierung. Die Berechtigungen der SSO-Benutzer verwalten Sie weiterhin in der FactFinder NG-Oberfläche.

Standort

Erstellen und konfigurieren Identitätsanbieter (IdPs) für SSO-Benutzer auf der Single-Sign-On-Einstellungen Registerkarte der Systeminformationen Seite:

Single-Sign-On in NG konfigurieren

Durch Klicken auf das Häkchen werden Ihre Änderungen an der FactFinder NG-Konfiguration sofort gespeichert:

Das Hinzufügen eines neuen Eintrags zur Tabelle erfordert diese Attribute:

  • Anbieterschlüssel — eindeutige Anbieterkennung. Dieser Schlüssel wird in der Redirect-URI verwendet.

  • Anzeigename — Name, der auf der Anmeldeseite angezeigt wird.

  • Issuer-URL — URL des Anbieterendpunkts.

  • Client-ID — beim Anbieter konfigurierte ID.

  • Client-Secret — beim Anbieter konfiguriertes Geheimnis.

NG in Ihrem Identitätsanbieter konfigurieren

Um die SSO-Einrichtung abzuschließen, müssen Sie NG auch als Anwendung in Ihrem Identitätsanbieter konfigurieren. Dies umfasst typischerweise die folgenden Schritte:

  1. Registrieren Sie eine neue Anwendung in der Verwaltungskonsole Ihres Identitätsanbieters.

  2. Legen Sie den Anwendungstyp fest auf Webanwendung oder einen ähnlichen Wert.

  3. Konfigurieren Sie die Redirect-URI für die Authentifizierungsantwort.

  4. Generieren Sie Client-Anmeldedaten für die NG-Konfiguration.

Redirect-URI-Konfiguration

Die Redirect-URI teilt dem Identitätsanbieter mit, wohin der Benutzer nach der Authentifizierung gesendet werden soll. Sie muss exakt übereinstimmen.

Verwenden Sie für NG die Basis-URL der UI mit dem Query-Parameter idp=<providerKey>:

Dabei:

  • {your-ng-domain} ist die Domain, auf der Ihre NG-Instanz gehostet wird.

  • {provider-key} ist der exakt eingegebene Wert im Anbieterschlüssel Feld.

Wichtig: Der Anbieterschlüssel in der Redirect-URI muss exakt mit dem in NG konfigurierten Anbieterschlüssel übereinstimmen. Andernfalls schlägt der Authentifizierungsablauf fehl.

Anforderungen an den Identitätsanbieter

Stellen Sie sicher, dass Ihr Identitätsanbieter diese Anforderungen erfüllt:

  • Der Anbieter muss in der Lage sein, auf „OIDC Discovery“-Anfragen zu antworten.

  • Der Anbieter muss Anfragen mit den Scopes openid, profile und offline_access.

  • Der OIDC-Claim, der zur Benutzeridentifikation ausgewertet wird, heißt preferred_username und muss in den vom IdP zurückgegebenen Identitäts- oder Zugriffstokens enthalten sein.

  • Weitere erforderliche Claims, die in Identitäts-/Zugriffstokens vorhanden sein müssen, sind: sub, iss, iat, exp

  • Tokens müssen signiert sein, und die Signatur muss mit dem entsprechenden öffentlichen Schlüssel überprüfbar sein, der vom JWKS-Endpunkt des IdP zurückgegeben wird.

Mit SSO anmelden

Der Anzeigename jedes konfigurierten Identitätsanbieters wird auf der Anmeldeseite angezeigt. Klicken Sie in diesem Beispiel auf ANMELDEN ÜBER MICROSOFT um sich beim IdP namens anzumelden Microsoft:

Jeder konfigurierte IdP fügt der Seite eine eigene Anmeldeschaltfläche hinzu.

Mit Anmeldedaten anmelden

Um sich stattdessen mit Benutzername und Passwort anzumelden, klicken Sie auf Mit Anmeldedaten anmelden:

Fehlerbehebung bei der SSO-Konfiguration

Wenn Probleme bei der SSO-Anmeldung auftreten, prüfen Sie Folgendes:

  1. Überprüfen Sie die Redirect-URI — stellen Sie sicher, dass der Anbieterschlüssel exakt mit dem Wert in NG übereinstimmt.

  2. Prüfen Sie die Client-Anmeldedaten — bestätigen Sie, dass die Client-ID und das Client-Secret korrekt sind.

  3. Bestätigen Sie die Issuer-URL — stellen Sie sicher, dass die URL korrekt und vom NG-Server aus erreichbar ist.

  4. Prüfen Sie die Protokolle des Identitätsanbieters — prüfen Sie auf Authentifizierungsfehler.

  5. Kontaktieren Sie den FactFinder-Support — für einige Probleme ist eine Analyse der NG-Logs erforderlich.

Einschränkungen

SSO-Benutzer können keine Nicht-SSO-Benutzer erstellen oder bearbeiten. Das ist beabsichtigt. Es verhindert, dass ausgeschiedene Benutzer den Zugriff auf NG behalten, indem ihre Konten von SSO getrennt werden.

Aus demselben Grund wird die Rückumwandlung eines SSO-Benutzers in einen Nicht-SSO-Benutzer nicht unterstützt.

Behalten Sie mindestens ein Administratorenkonto ohne SSO für den Notfallzugriff, falls ein IdP nicht verfügbar ist. Verwenden Sie einen Benutzernamen, der auf der IdP-Seite nicht existiert, damit das Konto niemals mit SSO verknüpft wird.

Dieselbe Empfehlung gilt für das Konto, das für FactFinder-Integrationssuchen verwendet wird.

Benutzer können sich außerdem nicht über mehrere Identitätsanbieter anmelden.

Zuletzt aktualisiert

War das hilfreich?