Zum Hauptinhalt springen

UI-Sprachen

Logto unterstützt den standardmäßigen OIDC-Authentifizierungsparameter ui_locales, um die Sprache der Anmeldeerfahrung (Sign-in Experience) und nachgelagerter Kommunikation für eine bestimmte Interaktion zu steuern.

Was es bewirkt

  • Bestimmt zur Laufzeit die UI-Sprache der von Logto gehosteten Anmeldeerfahrung. Logto wählt das erste Sprach-Tag in ui_locales, das in der Sprachbibliothek deines Mandanten unterstützt wird.
  • Beeinflusst die E-Mail-Lokalisierung für Nachrichten, die durch die Interaktion ausgelöst werden (z. B. Verifizierungscode-E-Mails). Siehe E-Mail-Vorlagen-Lokalisierung.
  • Stellt den Originalwert als Variable uiLocales in E-Mail-Vorlagen zur Verfügung, sodass du ihn bei Bedarf im E-Mail-Betreff / -Inhalt einfügen kannst.

Parameterformat

Auflösungsreihenfolge und Priorität

Bei der Bestimmung der UI-Sprache für die Anmeldeerfahrung und zugehörige E-Mails löst Logto die Sprache des Endbenutzers in folgender Reihenfolge auf:

  1. ui_locales aus der aktuellen Authentifizierungsanfrage (das erste unterstützte Tag gewinnt).
  2. Andernfalls Accept-Language-Header (Experience APIs / User Account APIs) oder messagePayload.locale (Management APIs wie Organisationseinladungen).
  3. Andernfalls die in der Sign-in Experience konfigurierte Standardsprache des Mandanten.

Dieses Verhalten ändert deine Spracheinstellungen nicht dauerhaft; es gilt nur für die aktuelle Interaktion.

SDK-Verwendung

Wenn du ein Logto SDK verwendest, übergib ui_locales über die extraParams des Sign-in-Aufrufs, damit es an die Autorisierungsanfrage weitergeleitet wird:

await logtoClient.signIn({
redirectUri: 'https://your.app/callback',
extraParams: {
ui_locales: 'fr-CA fr en',
},
});

Beispiele

  • ui_locales=fr-CA fr en → Wenn fr-CA in deiner Sprachbibliothek vorhanden ist, wird die Anmelde-UI auf Französisch (Kanada) angezeigt; andernfalls wird auf fr, dann auf en zurückgegriffen.
  • ui_locales=ja, aber Japanisch ist nicht aktiviert → Es wird auf Accept-Language oder die Mandanten-Standardsprache zurückgegriffen.