SSO mit Microsoft Entra ID einrichten

Erstelle eine Unternehmensanwendung für Lingo.dev in Microsoft Entra ID, weise ihr Benutzer zu, verbinde sie mit deiner Organisation und stelle Mitglieder über SCIM bereit.

In dieser Anleitung verbindest du Microsoft Entra ID über SAML 2.0 mit Lingo.dev. Dafür brauchst du in Entra mindestens die Rolle „Cloudanwendungsadministrator“ und musst Inhaber einer Lingo.dev-Organisation mit Enterprise-Tarif sein. Wie SSO in Lingo.dev funktioniert, erfährst du unter Einmaliges Anmelden.

Lass Einstellungen → SSO in Lingo.dev geöffnet. Von dort kopierst du zwei Werte nach Entra.

Unternehmensanwendung erstellen #

  1. Melde dich beim Microsoft Entra Admin Center an.
  2. Gehe zu Entra ID → Unternehmensanwendungen → Alle Anwendungen und wähle Neue Anwendung aus.
  3. Wähle Eigene Anwendung erstellen aus.
  4. Gib Lingo.dev als Namen ein, wähle Beliebige andere, nicht im Katalog gefundene Anwendung integrieren (Nicht-Katalog) und anschließend Erstellen aus.

SAML konfigurieren #

  1. Öffne in der neuen Anwendung Einmaliges Anmelden und wähle SAML aus.
  2. Wähle unter Grundlegende SAML-Konfiguration die Option Bearbeiten aus.
  3. Wähle unter Bezeichner (Entitäts-ID) die Option Bezeichner hinzufügen aus und füge https://auth.lingo.dev/auth/v1/sso/saml/metadata ein (die Entitäts-ID in Lingo.dev).
  4. Wähle unter Antwort-URL (Assertionsverbraucherdienst-URL) die Option Antwort-URL hinzufügen aus und füge https://auth.lingo.dev/auth/v1/sso/saml/acs ein (die ACS-URL in Lingo.dev).
  5. Lass Anmelde-URL, Relayzustand und Abmelde-URL vorerst leer. Wähle Speichern aus. Die Anmelde-URL legst du nach dem Verbinden fest, wie unter Über Microsoft „Meine Apps“ anmelden beschrieben.

Behalte die standardmäßigen Attribute & Ansprüche bei. Apps, die im Entra Admin Center erstellt werden, senden die E-Mail-Adresse des Benutzers aus user.mail im Anspruch emailaddress sowie eine Namens-ID im E-Mail-Format. Stelle sicher, dass alle Benutzer, die sich anmelden, eine E-Mail-Adresse in Entra hinterlegt haben.

Eine App, die ohne die Standardansprüche erstellt wurde, etwa über die Microsoft Graph API, sendet keine E-Mail-Adresse. Die Anmeldung schlägt dann mit der Meldung „Dein Identitätsanbieter hat keine E-Mail-Adresse gesendet.“ fehl. Füge unter Attribute & Ansprüche den E-Mail-Anspruch mit dem Quellattribut user.mail hinzu.

Metadaten-URL kopieren #

Kopiere unter SAML-Zertifikate die App-Verbundmetadaten-URL.

Benutzer und Gruppen zuweisen #

  1. Öffne in der Anwendung Benutzer und Gruppen und wähle Benutzer/Gruppe hinzufügen aus.
  2. Wähle unter Benutzer und Gruppen die Option Keine ausgewählt aus. Wähle die gewünschten Benutzer oder Gruppen und anschließend Auswählen aus.
  3. Wähle Zuweisen aus.
  4. Öffne Eigenschaften, setze Zuweisung erforderlich? auf Ja und wähle Speichern aus.

Wenn Zuweisung erforderlich? auf Ja steht, können sich nur zugewiesene Benutzer über Entra bei Lingo.dev anmelden. Bei Nein können alle Benutzer in deinem Mandanten die App aufrufen, auch Gastkonten. Lingo.dev erlaubt den Beitritt weiterhin nur für Konten mit E-Mail-Adressen aus deinen verbundenen Domains; alle anderen werden wieder abgemeldet. Bei Apps, die über die Microsoft Graph API erstellt werden, ist zunächst Nein eingestellt. Für die Zuweisung von Gruppen brauchst du Microsoft Entra ID P1 oder P2. Im kostenlosen Tarif weist du Benutzer einzeln zu.

In Lingo.dev verbinden #

  1. Öffne Einstellungen → SSO.
  2. Füge die App-Verbundmetadaten-URL unter Metadaten-URL des Identitätsanbieters ein.
  3. Gib unter E-Mail-Domains die E-Mail-Domains deines Unternehmens ein, getrennt durch Kommas.
  4. Wähle Verbinden aus.

Wenn eine Domain abgelehnt wird, sieh unter Domainregeln nach.

Anmeldung testen #

  1. Öffne ein privates Browserfenster und rufe die Anmeldeseite von Lingo.dev auf.
  2. Wähle Mit SSO fortfahren aus, gib die E-Mail-Adresse eines zugewiesenen Benutzers ein und wähle Anmelden aus.
  3. Melde dich mit Microsoft an.

Du kehrst als Mitglied der Organisation zu Lingo.dev zurück. Sieh dir die E-Mail-Adresse auf der Organisationsseite an: Sie gehört zu dem Konto, mit dem Microsoft dich angemeldet hat, und ist nicht unbedingt die Adresse, die du eingegeben hast. Wenn du im Browser bereits bei Microsoft angemeldet bist, etwa mit dem Administratorkonto, mit dem die App eingerichtet wurde, verwendet Microsoft dieses Konto, ohne nach einem Passwort zu fragen. Deshalb brauchst du für den Test ein privates Fenster.

Starte den Test von Lingo.dev aus, nicht über die Schaltfläche Testen in Entra. Solange du keine Anmelde-URL festgelegt hast, meldet dich die Lingo.dev-Kachel in Microsoft „Meine Apps“ nicht an: Du landest auf der Startseite von Lingo.dev und bleibst abgemeldet.

Wenn dein Mandant Sicherheitsstandards verwendet, fordert Microsoft alle Benutzer bei ihrer ersten Anmeldung auf, eine Authenticator-App zu registrieren. Das kann länger dauern als die Wartezeit von Lingo.dev (etwa 5 Minuten). Der erste Versuch schlägt dann mit der Meldung „Das einmalige Anmelden hat zu lange gedauert. Versuche es erneut.“ fehl. Beim erneuten Versuch funktioniert die Anmeldung.

Wenn der Test funktioniert, kannst du SSO verpflichtend machen. Weise zuerst deinem eigenen SSO-Konto die Rolle „Inhaber“ zu, wie unter Aktivieren beschrieben.

Über Microsoft „Meine Apps“ anmelden #

Lege die Anmelde-URL fest, damit die Anmeldung über die Lingo.dev-Kachel in „Meine Apps“ funktioniert.

  1. Öffne in Lingo.dev Einstellungen → SSO und kopiere den Dashboard-Anmeldelink. Er sieht so aus: https://lingo.dev/auth/sso?domain=example.com.
  2. Öffne in Entra die Lingo.dev-Anwendung und wähle Einmaliges Anmelden aus.
  3. Wähle unter Grundlegende SAML-Konfiguration die Option Bearbeiten aus.
  4. Füge den Link unter Anmelde-URL ein. Wähle Speichern aus.

Die Lingo.dev-Kachel in „Meine Apps“ öffnet jetzt diesen Link. Lingo.dev leitet den Benutzer zu Microsoft und nach der Anmeldung wieder zurück, ohne nach einer E-Mail-Adresse zu fragen.

Mitglieder mit SCIM bereitstellen #

Entra kann Mitglieder in Lingo.dev über SCIM verwalten und ihre Rollen über Gruppen festlegen. Richte zuerst SSO anhand dieser Anleitung ein. Wie SCIM in Lingo.dev funktioniert, erfährst du unter Mitglieder mit SCIM bereitstellen.

  1. Generiere einen SCIM-Schlüssel in Lingo.dev.
  2. Öffne in Entra die Lingo.dev-Unternehmensanwendung und wähle Bereitstellung aus.
  3. Setze Bereitstellungsmodus auf Automatisch.
  4. Füge unter Administratoranmeldeinformationen die SCIM-Basis-URL aus Lingo.dev, https://api.lingo.dev/v2/scim, in das Feld Mandanten-URL ein. Füge den SCIM-Schlüssel in das Feld Geheimes Token ein.
  5. Wähle Verbindung testen und anschließend Speichern aus.
  6. Behalte die standardmäßigen Attributzuordnungen bei. Lingo.dev übernimmt userName aus userPrincipalName und die geschäftliche E-Mail-Adresse aus mail.
  7. Setze unter Einstellungen den Bereich auf Nur zugewiesene Benutzer und Gruppen synchronisieren.
  8. Wähle Bereitstellung starten aus.

Die Einladung geht an die mail-Adresse des Benutzers. Alle zugewiesenen Benutzer brauchen daher eine solche Adresse aus einer verbundenen Domain. Es ist kein Problem, wenn userPrincipalName von mail abweicht.

Alle Benutzer, die du zuweist, erhalten eine ausstehende Einladung in Lingo.dev und werden bei ihrer ersten SSO-Anmeldung Mitglied.

Entra führt die Bereitstellung in Zyklen durch, etwa alle 40 Minuten. Änderungen und Entfernungen werden daher im nächsten Zyklus an Lingo.dev übertragen. Um einen einzelnen Benutzer sofort zu übertragen, verwende Bei Bedarf bereitstellen.

Wenn du die Zuweisung eines Benutzers aufhebst, sendet Entra eine Deaktivierung statt einer Löschung. Lingo.dev beendet daraufhin dessen Mitgliedschaft. Siehe Personen entfernen.

Rollen mit Entra-Gruppen festlegen #

  1. Stelle sicher, dass die Entra-Gruppe denselben Namen wie eine Lingo.dev-Rolle hat, etwa Translator.
  2. Weise die Gruppe unter Benutzer und Gruppen der Anwendung zu.

Entra ordnet die Gruppe der gleichnamigen Rolle zu und stellt ihre Mitglieder mit dieser Rolle bereit. Personen, die du aus der Gruppe entfernst, verlieren die Rolle. War die Gruppe die einzige Zuweisung eines Benutzers, wird dieser beim Entfernen aus der Gruppe auch aus Lingo.dev entfernt.

Fehlerbehebung #

ProblemLösung
Microsoft zeigt AADSTS700016 an: „Die Anwendung mit dem Bezeichner '…' wurde im Verzeichnis nicht gefunden“.Bezeichner (Entitäts-ID) entspricht nicht exakt https://auth.lingo.dev/auth/v1/sso/saml/metadata. Korrigiere den Wert unter Grundlegende SAML-Konfiguration.
Microsoft zeigt AADSTS50011 an: „Die Antwort-URL stimmt nicht mit den für die Anwendung konfigurierten Antwort-URLs überein“.Setze Antwort-URL (Assertionsverbraucherdienst-URL) exakt auf https://auth.lingo.dev/auth/v1/sso/saml/acs.
Microsoft zeigt AADSTS50105 an: Der Benutzer ist der Anwendung nicht zugewiesen.Weise unter Benutzer und Gruppen den Benutzer oder eine Gruppe zu, der er angehört.
Jemand ohne Zuweisung hat sich angemeldet, oder Lingo.dev zeigt eine E-Mail-Adresse an, die du nicht eingegeben hast.Zuweisung erforderlich? steht auf Nein, oder im Browser bestand bereits eine Microsoft-Anmeldung mit einem anderen Konto. Setze Zuweisung erforderlich? unter Eigenschaften auf Ja und teste die Anmeldung in einem privaten Fenster.
Lingo.dev meldet, dass deine E-Mail-Adresse nicht zu einer Domain gehört, die deine Organisation für einmaliges Anmelden verwendet.Microsoft hat ein Konto mit einer E-Mail-Adresse außerhalb deiner verbundenen Domains angemeldet, häufig ein Gastkonto oder das Administratorkonto, mit dem der Mandant erstellt wurde. Melde dich mit einem Geschäftskonto an oder füge dessen Domain unter Einstellungen → SSO hinzu.
Lingo.dev zeigt „Dein Identitätsanbieter hat keine E-Mail-Adresse gesendet“ an.Die App sendet keinen E-Mail-Anspruch, oder der Benutzer hat keine E-Mail-Adresse in Entra hinterlegt. Füge den E-Mail-Anspruch (user.mail) unter Attribute & Ansprüche hinzu und hinterlege die E-Mail-Adresse des Benutzers.
Lingo.dev zeigt „Das einmalige Anmelden hat zu lange gedauert. Versuche es erneut.“ an.Die Microsoft-Anmeldung hat länger als etwa 5 Minuten gedauert, häufig wegen der Registrierung einer Authenticator-App. Starte einen neuen Versuch von Lingo.dev aus. Der nächste Versuch funktioniert.
Lingo.dev zeigt „Du bist angemeldet, aber wir konnten dich nicht zu deiner Organisation hinzufügen.“ an.Melde dich erneut mit SSO an. Wenn die Anmeldung weiterhin fehlschlägt, bitte einen Inhaber, nachzusehen, ob unter Einstellungen → SSO die Angabe Verbunden seit angezeigt wird.
Lingo.dev zeigt „Das einmalige Anmelden wurde nicht abgeschlossen“ an.Vergleiche Bezeichner (Entitäts-ID) und Antwort-URL mit den Werten in Lingo.dev und versuche es dann erneut.
Verbindung testen oder die Bereitstellung schlägt mit 401 Unauthorized fehl.Der SCIM-Schlüssel wurde erneuert oder widerrufen. Füge den aktuellen Schlüssel unter Geheimes Token ein oder generiere einen neuen in Lingo.dev.
Ein zugewiesener Benutzer wird unter Einstellungen → Team auf dem Tab Einladungen nicht angezeigt.Warte auf den nächsten Bereitstellungszyklus oder verwende Bei Bedarf bereitstellen. Stelle sicher, dass die Adresse unter mail beim Benutzer zu einer verbundenen Domain gehört.

Hinweise zu weiteren Meldungen findest du unter Fehlerbehebung.