Skip to main content
Dieser Artikel wurde maschinell übersetzt.

Überblick

Verbinden Sie Ihren SAML-2.0-Identitätsanbieter, damit Mitglieder sich mit ihren beruflichen Zugangsdaten bei Legora anmelden können. Die Schritte gelten für SAML, ADFS und PingFederate, auch für eine Entra-Unternehmensanwendung mit SAML. Die Anbieteroption Entra ID verwendet OpenID Connect.

Voraussetzungen

Ihre Organisation muss die globale Authentifizierung von Legora verwenden. Sie benötigen Manage authentication security in Legora und Administratorzugriff auf Ihren Identitätsanbieter. Siehe Authentifizierung verwalten.

So funktioniert es

Legora reserviert Service-Provider-Werte für jede neue SAML-Verbindung. Registrieren Sie diese beim Identitätsanbieter und importieren Sie anschließend die Metadaten dieser Anwendung in Legora. Legora empfängt die Assertion an der Assertion Consumer Service-URL (ACS). Die Entity ID (Identifier) des Service Providers identifiziert die Legora-Verbindung. Die Entity ID des Identitätsanbieters identifiziert den Aussteller. Senden Sie bei neuen Verbindungen ein Attribut id mit einem stabilen, eindeutigen Wert für jede Person.

Verbindung einrichten

Beginnen Sie in Legora. Lassen Sie funktionierende Verbindungen und deren Kennungszuordnungen während der Einrichtung unverändert.

Einrichtung in Legora beginnen

Reservieren Sie zuerst die Verbindung.
  1. Wählen Sie im Menü Ihren Namen und dann Settings. Wählen Sie unter People die Option Authentication.
  2. Wählen Sie unter SSO Add, dann SAML, ADFS oder PingFederate.
  3. Geben Sie einen Connection name ein und wählen Sie Continue.
  4. Kopieren Sie Entity ID (Identifier) und ACS URL (Reply URL). Sie können später zur Einrichtung zurückkehren.

Identitätsanbieter konfigurieren

Erstellen Sie eine SAML-Anwendung. Übernehmen Sie Entity ID (Identifier) als Entity ID, Audience URI oder Identifier und ACS URL (Reply URL) als ACS-, Single Sign-On- oder Reply-URL. Kopieren Sie die vollständigen Werte, die für Ihre Verbindung angezeigt werden. Fügen Sie keinen abschließenden Schrägstrich hinzu und entfernen Sie keinen. In Okta heißt das Identifier-Feld Audience URI (SP Entity ID). Prüfen Sie bei einem vom Legora-Support bereitgestellten Service-Provider-Metadatenlink, ob Entity ID und ACS-URL mit der Verbindung übereinstimmen. Die Metadaten-URL des Identitätsanbieters beschreibt die Anwendung, die Sie in Legora importieren.

Benutzerkennungen und Attribute zuordnen

Ordnen Sie die SAML-Attribute dem Verzeichniseintrag der angemeldeten Person zu:
Kontaktieren Sie bei einer bestehenden SAML-Verbindung den Legora-Support, bevor Sie id hinzufügen oder Quelle, Format oder Zuordnung einer Kennung ändern. Eine andere Kennung kann den Zugriff auf bestehende Konten beeinträchtigen, auch wenn die E-Mail-Adressen gleich bleiben. Behalten Sie die aktuelle Konfiguration bei, bis Sie einen Migrationsplan abgestimmt haben.
Fügen Sie für jede neue SAML-Verbindung ein Attribut namens id hinzu und ordnen Sie ihm die stabile, eindeutige Verzeichniskennung der angemeldeten Person zu. Konfigurieren Sie es ausdrücklich, statt sich auf NameID, ein anderes Kennungsattribut oder einen aus der E-Mail-Adresse abgeleiteten Ersatzwert zu verlassen. Folgen Sie bei einer neuen Anwendung den Anleitungen Ihres Anbieters, um diese Attribute hinzuzufügen:
Anwendungsspezifische SAML-Claims hinzufügen. Verwenden Sie die Attributnamen aus der Tabelle mit einem leeren Namespace und stellen Sie sicher, dass user.mail ausgefüllt ist.
Wählen Sie eine nicht leere Kennung, die für dieselbe Person bei jeder Anmeldung gleich bleibt und sich für jede andere Person unterscheidet. Bevorzugen Sie eine dauerhafte Verzeichniskennung, die nicht erneut vergeben wird und vom Anbieter unterstützt wird. Sie darf von der E-Mail-Adresse abweichen. NameID ist die Benutzerkennung im Subject einer SAML-Antwort. Sie ist von den Attributen in der Tabelle oben getrennt: Ein explizites Attribut id oder nameidentifier kann Vorrang vor NameID haben. Prüfen Sie NameID und alle gesendeten Attribute id oder nameidentifier. Sie müssen die angemeldete Person konsistent identifizieren. Verwenden Sie keine festen Texte, Mandanten- oder Anwendungs-IDs, gemeinsamen Adressen, Anzeigenamen oder bei jeder Anmeldung neu erzeugten Werte. Prüfen Sie, ob Anbieter und Verbindung das NameID-Format unterstützen. E-Mail-basierte Kennungen benötigen einen Plan für Adressänderungen und Wiederverwendung.
Bestehende Zuordnungen können diese Standardaliase mit folgendem Präfix verwenden:http://schemas.xmlsoap.org/ws/2005/05/identity/claims/

Einrichtung in Legora abschließen

Importieren Sie die Konfiguration der gerade erstellten Anwendung.
  1. Geben Sie die Metadata URL oder die Entity ID, Sign-In Endpoint URL und das Signing Certificate (PEM) des Identitätsanbieters ein.
  2. Wählen Sie Complete setup.
  3. Lassen Sie bei der neuen Verbindung Status und Auto-provision bis zu den folgenden kontrollierten, vollständigen Anmeldungen ausgeschaltet.

Mit zwei Testbenutzern prüfen

Melden Sie dieselbe Person zweimal an, um die Stabilität der Kennung zu prüfen. Melden Sie danach eine zweite Person an und prüfen Sie, ob sich die Kennungen unterscheiden. Auch eine erfolgreiche Anmeldung kann eine fälschlich gemeinsam verwendete Kennung nutzen. Test connection zeigt keine SAML-Attribute an und vergleicht keine Benutzer. Bitten Sie den Administrator Ihres Identitätsanbieters, die bei jeder Testanmeldung gesendete SAML-Antwort mit dem Antwortbetrachter des Anbieters oder einem von Ihrer Organisation genehmigten SAML-Tracing-Tool zu prüfen. Wenn Sie diese Werte nicht einsehen können, wenden Sie sich vor der Aktivierung der Verbindung an den Legora-Support. Prüfen Sie bei einer neuen Verbindung in jedem der folgenden Tests den expliziten id-Wert. Fehlt er oder ist er leer, korrigieren Sie die Zuordnung vor der Aktivierung, auch wenn Test connection erfolgreich ist. Prüfen Sie bei einer bestehenden Verbindung die bisherige Kennungszuordnung, ohne sie zu ändern.
  1. Weisen Sie der Anwendung beim Identitätsanbieter zwei verschiedene Testbenutzer zu. Beide müssen bereits Mitglieder Ihrer Legora-Organisation sein und eigene Verzeichniseinträge und berufliche E-Mail-Adressen haben. Beschränken Sie bei einer neuen Anwendung den Zugriff bis zum Abschluss der Prüfung auf diese Testbenutzer.
  2. Wählen Sie Test connection und melden Sie sich als erster Benutzer an.
  3. Öffnen Sie die Antwort auf diese Anmeldung im Antwort-Viewer Ihres Identitätsanbieters oder in einem von Ihrer Organisation genehmigten SAML-Tracing-Tool. Prüfen Sie id und weitere Kennungsfelder, einschließlich NameID innerhalb von Subject und des Standardattributs nameidentifier.
  4. Starten Sie eine neue Anmeldung als derselbe Benutzer. Die Kennung muss gleich bleiben.
  5. Verwenden Sie ein separates Browserprofil oder eine private Sitzung für den zweiten Benutzer. Seine Kennung muss sich unterscheiden. Prüfen Sie E-Mail- und Namensattribute beider Benutzer.
  6. Aktivieren Sie bei der neuen Verbindung Status für die folgenden kontrollierten Anmeldungen. Lassen Sie Auto-provision ausgeschaltet.
  7. Planen Sie vor breiter Freigabe oder automatischer Bereitstellung vollständige Legora-Testanmeldungen für beide Benutzer. Jeder muss sein eigenes Konto und die erwartete Organisation erreichen. Wiederholen Sie die Anmeldung des ersten Benutzers. Das Testfenster prüft diese Kontozuordnung nicht.
  8. Erweitern Sie den Zugriff auf die Anwendung beim Identitätsanbieter wie geplant, nachdem beide Benutzer diese Prüfungen bestanden haben. Aktivieren Sie Auto-provision erst nach Prüfung der vorgesehenen Zuweisungen und E-Mail-Domains.
Stoppen Sie die Freigabe bei wechselnden oder gemeinsamen Kennungen oder einem unerwarteten Konto und wenden Sie sich an support@legora.com. Senden Sie keine Tokens, privaten Schlüssel oder vollständigen Assertions per E-Mail oder Supportticket.

Bestehende Verbindung migrieren

Vergleichen Sie gemeinsam mit dem Legora-Support die aktuellen und geplanten Kennungen und klären Sie, ob eine Kontomigration erforderlich ist. Vereinbaren Sie vor der Konfigurationsänderung eine kontrollierte Einführung, Prüfungen des Zugriffs auf bestehende Konten bei erneuten Anmeldungen und einen Plan zur Rückkehr zur bisherigen Konfiguration. Migration zur globalen Authentifizierung Bereiten Sie eine separate Anwendung mit den Werten der neuen Verbindung vor. Lassen Sie die funktionierende Anwendung samt gemeinsamem oder verbindungsspezifischem Callback bis zur abgestimmten und geprüften Umstellung bestehen. Siehe Migration zur globalen Authentifizierung.

Fehlerbehebung

Vergleichen Sie die angezeigten Verbindungswerte mit der Konfiguration des Identitätsanbieters und den Attributzuordnungen.

Reply-URL oder Audience abgelehnt

Kopieren Sie Identifier und ACS-URL dieser Verbindung exakt. Ein erfolgreicher Metadatenabruf bestätigt die Übereinstimmung noch nicht.

Fehlendes oder falsches Profil

Prüfen Sie die oben genannten SAML-Attributnamen und benutzerspezifischen Werte. Stellen Sie sicher, dass die Person eine berufliche E-Mail-Adresse hat und diese im konfigurierten E-Mail-Attribut gesendet wird. Der Metadatenimport prüft keine einzelnen Benutzerattribute.

Unerwartetes Konto oder wechselnde Kennung

Stoppen Sie die Freigabe und prüfen Sie die Kennungsquellen mit dem Legora-Support, bevor Sie bestehende Zuordnungen ändern. Bleibt das Problem bestehen, kontaktieren Sie support@legora.com.