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
- Name:
ui_locales
- Typ:
string
- Wert: Durch Leerzeichen getrennte Liste von BCP 47 Sprach-Tags, z. B.
fr-CA fr en
. - Referenz: OpenID Connect Core - ui_locales
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:
ui_locales
aus der aktuellen Authentifizierungsanfrage (das erste unterstützte Tag gewinnt).- Andernfalls
Accept-Language
-Header (Experience APIs / User Account APIs) odermessagePayload.locale
(Management APIs wie Organisationseinladungen). - 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
→ Wennfr-CA
in deiner Sprachbibliothek vorhanden ist, wird die Anmelde-UI auf Französisch (Kanada) angezeigt; andernfalls wird auffr
, dann aufen
zurückgegriffen.ui_locales=ja
, aber Japanisch ist nicht aktiviert → Es wird aufAccept-Language
oder die Mandanten-Standardsprache zurückgegriffen.