Dieser Artikel wurde maschinell übersetzt.
Überblick
Dieser Leitfaden richtet sich an IT-Admins, die Microsoft Entra ID für Single Sign-on (SSO) mit der globalen Authentifizierung von Legora verbinden. Mitglieder melden sich danach mit ihren Entra-ID-Konten bei Legora an. Sie arbeiten an zwei Orten: im Microsoft Entra Admin Center und unter Authentication in Legora. Entra ID verwendet OpenID Connect mit der globalen Authentifizierung von Legora.Ihre Organisation muss die globale Authentifizierung von Legora verwenden, und Ihre Rolle muss Manage authentication security enthalten. Siehe Wie verwalte ich die Authentifizierung für meine Organisation?.Wenn Ihre Organisation noch nicht umgestellt hat, richtet der Legora-Support Single Sign-on (SSO) ein. Wenden Sie sich an support@legora.com. Um eine bestehende Organisation zu verschieben, siehe IT-Admin-Leitfaden: die globale Authentifizierung von Legora.
So funktioniert es
Jeder Schritt nennt, wo Sie ihn ausführen. Schließen Sie die Entra-Schritte ab, bevor Sie die Verbindung in Legora testen.Schritt 1: Die Unternehmensanwendung erstellen (in Entra)
Erstellen Sie in Entra die Unternehmensanwendung, über die Legora Mitglieder anmeldet. Entra erstellt dazu auch eine App-Registrierung, die Sie in Schritt 2 und 3 verwenden. Legora muss eine Unternehmensanwendung außerhalb des Katalogs sein. Erstellen Sie sie mit den folgenden Schritten unter Enterprise apps, damit Entra sie als Anwendung außerhalb des Katalogs einrichtet. Kataloganwendungen geben an, dass sie SCIM nicht unterstützen, sodass die Bereitstellung für Directory Sync nicht verfügbar bleibt. Wenn Ihre Anwendung aus dem Katalog stammt oder Sie sie unter App registrations erstellt haben, erstellen Sie eine neue Unternehmensanwendung und verwenden Sie sie für die Anmeldung und die Bereitstellung.- Melden Sie sich im Microsoft Entra Admin Center an.
- Gehen Sie zu Entra ID > Enterprise apps und wählen Sie New application.
- Wählen Sie Create your own application.
- Füllen Sie das Formular aus und wählen Sie Create:
- What’s the name of your app?: Ein Name, der den Zweck der App beschreibt, zum Beispiel „Legora SSO.“
- What are you looking to do with your application?: Wählen Sie Integrate any other application you don’t find in the gallery (Non-gallery).
- Gehen Sie zu Entra ID > App registrations, wählen Sie All applications und öffnen Sie die App mit dem eingegebenen Namen.
- Kopieren Sie auf der Seite Overview der App-Registrierung diese Werte für Schritt 4:
- Application (client) ID
- Directory (tenant) ID
Schritt 2: Den Redirect-URI hinzufügen (in Entra)
Registrieren Sie den Callback von Legora, damit Entra Mitglieder nach der Anmeldung zurückschicken kann.- Gehen Sie in Ihrer App-Registrierung zu Authentication.
- Wählen Sie Add a platform und dann Web.
- Fügen Sie diesen Redirect-URI ein und wählen Sie Configure:
https://sso.legora.com/api/oauth/oidc
Verwenden Sie diesen URI für jede Organisation auf der globalen Authentifizierung von Legora. Nachdem Sie die Verbindung in Schritt 4 erstellt haben, zeigt Redirect URL auf der Verbindung denselben Wert.
Wenn Entra fragt, welche OpenID-Connect-Scopes zugelassen werden sollen, aktivieren Sie openid, profile und email. Legora braucht nach der Anmeldung die E-Mail-Adresse. Vorname und Nachname sind empfohlen.
Wenn diese App-Registrierung bereits Redirect-URIs aus einer älteren Legora-Anmeldekonfiguration hat, lassen Sie sie stehen und fügen Sie den URI oben hinzu. Entfernen Sie die älteren URIs erst, nachdem Ihre Organisation den Wechsel zur globalen Authentifizierung von Legora abgeschlossen hat. Die vollständige Aufgabenliste steht in IT-Admin-Leitfaden: die globale Authentifizierung von Legora.
Schritt 3: Ein Client Secret erstellen (in Entra)
Erstellen Sie das Secret, mit dem Legora sich mit Ihrer App-Registrierung verbindet.- Gehen Sie in Ihrer App-Registrierung zu Certificates & secrets > Client secrets und wählen Sie New client secret.
- Fügen Sie eine Beschreibung hinzu, zum Beispiel „Legora SSO secret,“ und wählen Sie das Ablaufdatum.
- Wählen Sie Add, kopieren Sie dann den Value und speichern Sie ihn sicher. Entra zeigt den Value nur einmal. Die Secret-ID kann nicht in Legora eingefügt werden.
- Wählen Sie im Menü Ihren Namen und dann Settings > People > Authentication.
- Wählen Sie unter SSO die Verbindung.
- Wählen Sie unter Connection details die Option Edit.
- Geben Sie den neuen Wert unter Client secret ein. Lassen Sie das Feld nur leer, wenn Sie das aktuelle Secret behalten möchten.
- Speichern.
Schritt 4: Die Verbindungsdetails hinzufügen (in Legora)
Geben Sie in Legora die Werte aus den Schritten 1 bis 3 ein. Verwenden Sie für die Domäne eine Domäne, die Ihrer Organisation gehört. Im Entra Admin Center finden Sie sie unter Entra ID > Domain names. Verwenden Sie eine verifizierte Domäne wielegora.com. Überspringen Sie eine Domäne, die auf onmicrosoft.com endet.
- Wählen Sie im Menü Ihren Namen und dann Settings > People > Authentication.
- Wählen Sie unter SSO die Option Add und dann Entra ID.
- Füllen Sie das Formular aus:
- Display Name: Der Name, den Mitglieder auf dem Anmeldebildschirm sehen.
- Domain: Die Domäne Ihrer Organisation.
- Tenant ID: Die Directory (tenant) ID aus Schritt 1.
- Client ID: Die Application (client) ID aus Schritt 1.
- Client Secret: Der Secret-Wert aus Schritt 3.
- Wählen Sie Create connection. Legora öffnet die neue Verbindung.
Schritt 5: Benutzer und Gruppen zuweisen (in Entra)
Legen Sie fest, wer sich über Entra bei Legora anmelden kann.- Gehen Sie zu Entra ID > Enterprise apps und wählen Sie die App, die Sie in Schritt 1 erstellt haben.
- Legen Sie unter Properties fest, ob sich jede Person in Ihrem Verzeichnis anmelden kann oder nur zugewiesene Benutzer. Assignment required? ist standardmäßig No. Setzen Sie den Wert auf Yes, um nur zugewiesene Benutzer und Gruppen zuzulassen.
- Wenn eine Zuweisung erforderlich ist, gehen Sie zu Users and groups und wählen Sie Add user/group.
- Wählen Sie die Benutzer oder Gruppen, die Zugriff auf Legora haben sollen, und wählen Sie dann Assign.
Schritt 6: Die Verbindung testen (in Legora)
Bestätigen Sie, dass die Verbindung funktioniert, bevor Mitglieder sie nutzen.- Wählen Sie im Menü Ihren Namen und dann Settings > People > Authentication.
- Wählen Sie unter SSO die Verbindung.
- Wählen Sie Test connection. Ein Anmeldefenster wird geöffnet.
Schritt 7: Die Verbindung aktivieren (in Legora)
Machen Sie die Verbindung für Mitglieder verfügbar. Aktivieren Sie auf der Verbindung Status. Mitglieder können sich dann mit Entra ID anmelden. Bis dahin bleibt die Verbindung eingerichtet, erscheint aber nicht als Anmeldemethode.Wer beitreten kann
Entra steuert, wer sich authentifizieren kann. Legora steuert, wer Mitglied wird. Sie legen die Mitgliedschaft auf der Verbindung unter Auto-provision und Email domains fest.Auto-provision aktiviert
Wenn Auto-provision aktiviert ist, fügt Legora eine Person hinzu, sobald sie sich zum ersten Mal mit einer E-Mail-Adresse einer gelisteten Domäne anmeldet. Sie braucht trotzdem die Berechtigung, sich in Entra zu authentifizieren. App-Zuweisung, Conditional Access und Multi-Faktor-Authentifizierung bleiben in Entra. Fügen Sie mindestens eine Domäne unter Email domains hinzu, bevor Sie Auto-provision aktivieren. Die Verbindung muss aktiv sein. Wenn Directory Sync für die Verbindung aktiviert ist, verwalten Sie die Mitgliedschaft über Directory Sync. Siehe Directory Sync.Auto-provision deaktiviert
Wenn Auto-provision deaktiviert ist, kann sich eine Person trotzdem in Entra authentifizieren. Legora fügt sie erst hinzu, nachdem ein Admin sie eingeladen hat und sie angenommen hat. Ohne aktive Mitgliedschaft bricht die Anmeldung ab. Legora zeigt: „User has no active membership in any of the connection organisations.“ Um Zugriff zu gewähren, lassen Sie die Person in Entra zu und laden Sie sie in Legora ein. Um Zugriff zu entziehen, entfernen Sie sie aus der Entra-App oder aus der Organisation in Legora.Häufig gestellte Fragen
Diese Antworten behandeln die Anmeldeprobleme, die Admins nach dem Aktivieren der Verbindung am häufigsten melden.Was passiert, wenn ein Benutzer aus der Enterprise-Anwendung in Entra entfernt wird?
Die Person kann sich über diese App nicht mehr anmelden. Das Legora-Profil bleibt bestehen. Wenn Sie sie der App erneut zuweisen, kann sie sich anmelden, sofern sie noch Mitglied ist oder Auto-provision sie hinzufügen kann. Wenn die Organisation auch Directory Sync verwendet, entzieht das Deaktivieren oder Entfernen des Benutzers in Entra den Zugriff auf die Organisation. Das Legora-Profil wird nicht gelöscht.Warum meldet sich ein Benutzer bei einem leeren Legora-Konto an?
Wenn Auto-provision aktiviert ist, erstellt Legora das Konto aus der E-Mail-Adresse, die Entra sendet. Unterscheidet sich diese Adresse von der Einladung, zum Beispieljdoe@example.com statt jane.doe@example.com, erstellt Legora ein separates Konto für die Entra-Adresse. Gleichen Sie die E-Mail in Entra mit der in Legora verwendeten Adresse ab, oder wenden Sie sich an support@legora.com.