Aller au contenu principal

Locales de l’interface utilisateur

Logto prend en charge le paramètre standard d’authentification OIDC ui_locales pour contrôler la langue de l’expérience de connexion et des communications associées pour une interaction donnée.

Ce que cela fait​

  • Détermine la langue de l’interface utilisateur de l’expérience de connexion hébergée par Logto à l’exécution. Logto sélectionne la première balise de langue dans ui_locales qui est prise en charge dans la bibliothèque de langues de votre tenant.
  • Affecte la localisation des e-mails pour les messages déclenchés par l’interaction (par exemple, les e-mails de code de vérification). Voir Localisation des modèles d’e-mails.
  • Expose la valeur d’origine aux modèles d’e-mails sous forme de variable uiLocales, ce qui vous permet de l’inclure dans l’objet ou le contenu de l’e-mail si nécessaire.

Format du paramètre​

  • Nom : ui_locales
  • Type : string
  • Valeur : Liste d’étiquettes de langue BCP 47 séparées par des espaces, par exemple fr-CA fr en.
  • Référence : OpenID Connect Core - ui_locales

Ordre de résolution et priorité​

Lors de la détermination de la langue de l’interface utilisateur pour l’expérience de connexion et les e-mails associés, Logto résout la langue de l’utilisateur final selon cet ordre :

  1. ui_locales de la requête d’authentification en cours (la première balise prise en charge l’emporte).
  2. Sinon, l’en-tête Accept-Language (Experience APIs / User Account APIs) ou messagePayload.locale (Management APIs comme les invitations d’organisation).
  3. Sinon, la langue par défaut du tenant configurée dans l’Expérience de connexion.

Ce comportement ne modifie pas de façon permanente vos paramètres de langue ; il ne s’applique qu’à l’interaction en cours.

Utilisation dans les SDK​

Si vous utilisez un SDK Logto, transmettez ui_locales via extraParams lors de l’appel de connexion afin qu’il soit transmis à la requête d’autorisation :

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

Exemples​

  • ui_locales=fr-CA fr en → Si fr-CA existe dans votre bibliothèque de langues, l’interface de connexion s’affiche en français (Canada) ; sinon, elle passe à fr, puis à en.
  • ui_locales=ja mais le japonais n’est pas activé → Bascule vers Accept-Language ou la langue par défaut du tenant.