SSO mit Okta einrichten

Erstelle in Okta eine SAML-App für Lingo.dev, weise Personen zu, verbinde die App mit deiner Organisation und stelle Mitglieder über SCIM bereit.

In dieser Anleitung verbindest du Okta über SAML 2.0 mit Lingo.dev. Du benötigst ein Okta-Administratorkonto mit der Berechtigung, App-Integrationen zu erstellen, und musst Inhaber einer Lingo.dev-Organisation im Enterprise-Tarif sein. Wie SSO in Lingo.dev funktioniert, erfährst du unter Single Sign-on.

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

App-Integration erstellen #

  1. Melde dich in der Okta-Administrationskonsole an.
  2. Gehe zu Anwendungen → Anwendungen (in neueren Administrationskonsolen Anwendungen und Ressourcen → Anwendungen) und wähle App-Integration erstellen.
  3. Wähle SAML 2.0 und anschließend Weiter.
  4. Gib unter App-Name Lingo.dev ein. Wähle Weiter.

SAML konfigurieren #

Fülle die folgenden Felder aus und behalte für alle übrigen die Standardwerte bei:

Okta-FeldWert
Single-Sign-on-URLhttps://auth.lingo.dev/auth/v1/sso/saml/acs (die ACS-URL in Lingo.dev)
Für Empfänger-URL und Ziel-URL verwendenAusgewählt
Zielgruppen-URI (SP-Entitäts-ID)https://auth.lingo.dev/auth/v1/sso/saml/metadata (die Entitäts-ID in Lingo.dev)
Standard-RelayStateLeer
Namens-ID-FormatEmailAddress
AnwendungsbenutzernameE-Mail

Füge unter Attributanweisungen ein Attribut hinzu:

NameNamensformatWert
emailNicht angegebenuser.email

Mit EmailAddress als Namens-ID-Format und diesem email-Attribut sendet Okta die E-Mail-Adresse, die Lingo.dev benötigt.

In neueren Okta-Organisationen werden beim Erstellen der App keine Attributanweisungen mehr angezeigt. Füge das Attribut in diesem Fall hinzu, nachdem du Fertigstellen gewählt hast: Wähle auf der Registerkarte Anmeldung der App im Abschnitt Attributanweisungen die Option Ausdruck hinzufügen. Gib email unter Name und user.profile.email unter Ausdruck ein und wähle anschließend Speichern.

Wähle Weiter. Wähle im Schritt Feedback die Option Ich bin Okta-Kunde und füge eine interne App hinzu und anschließend Fertigstellen.

Metadaten-URL kopieren #

Kopiere auf der Registerkarte Anmeldung der App die Metadaten-URL aus dem Abschnitt Metadatendetails. Sie sieht so aus: https://your-company.okta.com/app/exk.../sso/saml/metadata.

Personen zuweisen #

  1. Öffne die Registerkarte Zuweisungen der App.
  2. Wähle Zuweisen und anschließend Personen zuweisen oder Gruppen zuweisen.
  3. Wähle neben jeder Person oder Gruppe Zuweisen und anschließend Fertig.

Nur zugewiesene Personen können sich über Okta bei Lingo.dev anmelden.

Verbindung in Lingo.dev herstellen #

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

Wenn eine Domain abgelehnt wird, findest du unter Domainregeln weitere Informationen.

Anmeldung testen #

  1. Öffne ein privates Browserfenster und rufe die Anmeldeseite von Lingo.dev auf.
  2. Wähle Mit SSO fortfahren, gib die E-Mail-Adresse einer zugewiesenen Person ein und wähle Anmelden.
  3. Melde dich bei Okta 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 Okta dich angemeldet hat, und ist nicht unbedingt die Adresse, die du eingegeben hast. Wenn im Browser bereits eine Okta-Sitzung aktiv ist, etwa mit dem Administratorkonto, mit dem die App eingerichtet wurde, verwendet Okta dieses Konto weiter. Bei einem Administratorkonto, das der App nicht zugewiesen ist, erscheint „Der Benutzer ist dieser Anwendung nicht zugewiesen“. Deshalb brauchst du für den Test ein privates Fenster.

Starte den Test in Lingo.dev. Über die Kachel der SAML-App im Okta-Dashboard wirst du nicht angemeldet: Du landest auf der Startseite von Lingo.dev und bist weiterhin abgemeldet. Um dich über das Dashboard anzumelden, füge das unter Über das Okta-Dashboard anmelden beschriebene Lesezeichen hinzu.

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

Über das Okta-Dashboard anmelden #

Damit Mitglieder sich über eine Lingo.dev-Kachel anmelden können, füge eine Lesezeichen-App hinzu, die den Dashboard-Anmeldelink öffnet. Blende anschließend das Symbol der SAML-App aus, sodass Mitglieder nur das Lesezeichen sehen.

  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. Gehe in der Okta-Administrationskonsole zu Anwendungen → Anwendungen (in neueren Administrationskonsolen Anwendungen und Ressourcen → Anwendungen) und wähle App-Katalog durchsuchen.
  3. Suche nach Lesezeichen-App, wähle sie aus und wähle anschließend Integration hinzufügen.
  4. Gib unter Allgemeine Einstellungen Lingo.dev als Namen ein und füge den Link als URL ein. Lass Anwendungssymbol für Benutzer nicht anzeigen deaktiviert. Wähle Fertig.
  5. Weise auf der Registerkarte Zuweisungen des Lesezeichens dieselben Personen oder Gruppen zu wie bei der SAML-App.
  6. Öffne die Lingo.dev-SAML-App. Wähle auf der Registerkarte Allgemein unter App-Einstellungen die Option Bearbeiten.
  7. Aktiviere unter Anwendungssichtbarkeit die Optionen Anwendungssymbol für Benutzer nicht anzeigen und Anwendungssymbol in der Okta-Mobil-App nicht anzeigen. Wähle Speichern.

Lass die Personen der SAML-App zugewiesen. Die App übernimmt weiterhin die Anmeldung und ist lediglich ausgeblendet.

Mitglieder sehen jetzt eine einzige Lingo.dev-Kachel. Diese öffnet Lingo.dev. Von dort werden sie zu Okta und anschließend angemeldet zurückgeleitet, ohne ihre E-Mail-Adresse eingeben zu müssen.

Mitglieder mit SCIM bereitstellen #

Okta kann Mitglieder in Lingo.dev über SCIM verwalten und ihre Rollen über Gruppen festlegen. Richte zuerst SSO mithilfe 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 der Okta-Administrationskonsole die Lingo.dev-SAML-App. Wähle auf der Registerkarte Allgemein unter App-Einstellungen die Option Bearbeiten.
  3. Setze Bereitstellung auf SCIM und wähle Speichern. Die App erhält eine Registerkarte Bereitstellung.
  4. Öffne auf der Registerkarte Bereitstellung den Bereich Integration und wähle Bearbeiten.

Fülle die folgenden Felder aus:

Okta-FeldWert
Basis-URL des SCIM-Konnektorshttps://api.lingo.dev/v2/scim (die SCIM-Basis-URL in Lingo.dev)
Feld für die eindeutige BenutzerkennunguserName
Unterstützte BereitstellungsaktionenNeue Benutzer übertragen, Profilaktualisierungen übertragen und Gruppen übertragen. Lass die Importaktionen deaktiviert. Okta importiert keine Benutzer oder Gruppen aus Lingo.dev.
AuthentifizierungsmodusHTTP-Header. Füge den SCIM-Schlüssel als Bearer-Token ein.

Wähle Konnektorkonfiguration testen. Wenn der Test erfolgreich ist, schließe ihn und wähle Speichern.

Öffne auf der Registerkarte Bereitstellung den Bereich Zur App und wähle Bearbeiten. Aktiviere Benutzer erstellen, Benutzerattribute aktualisieren und Benutzer deaktivieren und wähle Speichern.

Okta überträgt erst dann Personen an Lingo.dev, wenn du Benutzer erstellen aktiviert und gespeichert hast. Danach erhält jede Person, die du zuweist, eine ausstehende Einladung in Lingo.dev und wird bei ihrer ersten SSO-Anmeldung Mitglied.

Wenn du die Zuweisung einer Person in Okta aufhebst oder sie dort deaktivierst, deaktiviert Okta sie auch in Lingo.dev. Dadurch wird ihre Mitgliedschaft entfernt. Siehe Personen entfernen.

Rollen mit Okta-Gruppen festlegen #

  1. Stelle sicher, dass die Okta-Gruppe denselben Namen wie eine Lingo.dev-Rolle hat, etwa Translator.
  2. Wähle auf der Registerkarte Gruppen übertragen der App die Option Gruppen übertragen und anschließend Gruppen nach Namen suchen.
  3. Suche die Gruppe und wähle Speichern.

Übertrage eine andere Gruppe als die, über die du die App zuweist. Okta unterstützt die Verwendung derselben Gruppe für beide Zwecke nicht. Okta überträgt nur Mitglieder, die der App zugewiesen sind. Weise deshalb alle Personen in einer übertragenen Gruppe der App zu – entweder direkt oder über eine andere Gruppe.

Okta verknüpft die Gruppe mit der gleichnamigen Rolle. Ihre Mitglieder erhalten die Rolle; Personen, die du aus der Gruppe entfernst, verlieren sie. Wenn keine Rolle den Namen der Gruppe trägt, erscheint bei der Übertragung eine Fehlermeldung mit „Keine Rolle mit dem Namen“. Erstelle die Rolle in Lingo.dev und übertrage die Gruppe anschließend erneut.

Wenn du die Übertragung einer Gruppe beendest und Okta fragt, ob sie in der App gelöscht werden soll, wird mit Löschen die Rollenzuweisung für ihre Mitglieder entfernt. Die Rolle selbst bleibt in Lingo.dev bestehen.

Fehlerbehebung #

ProblemLösung
Lingo.dev zeigt nach der Anmeldung bei Okta „Single Sign-on wurde nicht abgeschlossen“ an.Kontrolliere Zielgruppen-URI (SP-Entitäts-ID) und Single-Sign-on-URL. Sie müssen exakt mit der Entitäts-ID und der ACS-URL in Lingo.dev übereinstimmen, ohne abschließenden Schrägstrich.
Lingo.dev zeigt „Dein Identitätsanbieter hat keine E-Mail-Adresse gesendet“ an.Setze Namens-ID-Format auf EmailAddress und Anwendungsbenutzername auf E-Mail und füge die email-Attributanweisung hinzu: user.email im Einrichtungsassistenten oder user.profile.email auf der Registerkarte Anmeldung.
Okta meldet, dass du der App nicht zugewiesen bist.Weise die Person oder eine Gruppe, der sie angehört, auf der Registerkarte Zuweisungen zu. Wenn du die E-Mail-Adresse einer zugewiesenen Person eingegeben hast, Okta aber dein Administratorkonto anzeigt, ist deine Okta-Sitzung im Browser noch aktiv. Melde dich bei Okta ab oder verwende ein privates Fenster.
Lingo.dev zeigt „Single Sign-on hat zu lange gedauert. Versuche es erneut.“ an.Die Okta-Anmeldung hat länger als etwa 5 Minuten gedauert, zum Beispiel bei der erstmaligen Einrichtung der Multi-Faktor-Authentifizierung. Starte die Anmeldung erneut 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 es weiterhin nicht funktioniert, bitte jemanden mit der Rolle Inhaber, nachzusehen, ob unter Einstellungen → SSO die Anzeige Verbunden seit erscheint.
Lingo.dev zeigt „Single Sign-on ist nicht eingerichtet für“ gefolgt von deiner Domain an.Füge die Domain unter Einstellungen → SSO hinzu oder kontrolliere die eingegebene E-Mail-Adresse.
Konnektorkonfiguration 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 Integration ein oder generiere einen neuen in Lingo.dev.
Eine in Okta zugewiesene Person wird unter Einstellungen → Team auf der Registerkarte Einladungen nicht angezeigt.Stelle sicher, dass Benutzer erstellen unter Zur App aktiviert ist. Öffne für Personen, die bereits vor dem Speichern zugewiesen waren, die Liste der Bereitstellungsaufgaben in Okta und führe die entsprechenden Aufgaben erneut aus.

Weitere Meldungen findest du unter Fehlerbehebung.