Aller au contenu principal

Langues 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 ultérieures 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 choisit la première balise de langue dans ui_locales qui est prise en charge dans la bibliothèque de langues de votre locataire.
  • 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, vous permettant de l’inclure dans l’objet / contenu de l’e-mail si nécessaire.
  • Définit l’indicatif pays par défaut pour les numéros de téléphone dans l’expérience de connexion. Par exemple, si ui_locales=fr, le champ de saisie du numéro de téléphone sera par défaut la France (+33). Ceci est utile lorsque vous souhaitez contrôler l’indicatif pays par défaut de manière programmatique pour des groupes d’utilisateurs ou des régions spécifiques.

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 locataire 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 locataire.