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 Attributid 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.- Wählen Sie im Menü Ihren Namen und dann Settings. Wählen Sie unter People die Option Authentication.
- Wählen Sie unter SSO Add, dann SAML, ADFS oder PingFederate.
- Geben Sie einen Connection name ein und wählen Sie Continue.
- 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:
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:
- Microsoft Entra ID
- Okta
- PingFederate
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.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.
Standardattribut-Aliase
Standardattribut-Aliase
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.- Geben Sie die Metadata URL oder die Entity ID, Sign-In Endpoint URL und das Signing Certificate (PEM) des Identitätsanbieters ein.
- Wählen Sie Complete setup.
- 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 explizitenid-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.
- 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.
- Wählen Sie Test connection und melden Sie sich als erster Benutzer an.
- Ö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
idund weitere Kennungsfelder, einschließlichNameIDinnerhalb vonSubjectund des Standardattributsnameidentifier. - Starten Sie eine neue Anmeldung als derselbe Benutzer. Die Kennung muss gleich bleiben.
- 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.
- Aktivieren Sie bei der neuen Verbindung Status für die folgenden kontrollierten Anmeldungen. Lassen Sie Auto-provision ausgeschaltet.
- 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.
- 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.