Français
  • localisation
  • internationalisation
  • i18n
  • l10n
  • ui_locales
  • locale

Adaptez l' expérience de connexion Logto grâce à OIDC ui_locales

Rendez l'expérience de connexion naturelle pour chaque utilisateur. Dans ce tutoriel, tu apprendras à utiliser le paramètre standard OIDC ui_locales pour définir la langue d’exécution de l’UI de connexion Logto et des emails associés.

Charles
Charles
Developer

Arrêtez de perdre des semaines sur l'authentification des utilisateurs
Lancez des applications sécurisées plus rapidement avec Logto. Intégrez l'authentification des utilisateurs en quelques minutes et concentrez-vous sur votre produit principal.
Commencer
Product screenshot

Pourquoi utiliser ui_locales ?

Logto prend déjà en charge le contenu multilingue et la détection automatique, mais il y a des situations où tu veux spécifiquement choisir la langue pour une interaction donnée :

  • Produits multi-organisations, chaque organisation ayant ses préférences linguistiques
  • Liens profonds issus de campagnes dans une langue précise
  • Pages produit avec des CTA localisés qui démarrent la connexion dans la même langue
  • Tests A/B pour l’onboarding localisé

De plus, ui_locales est un paramètre standard pris en charge par de nombreux fournisseurs d'identité et SDK.

Que fait ui_locales

  • Définit la langue de l’interface de connexion pour la session en cours (le premier tag pris en charge l’emporte)
  • Influence la langue des emails déclenchés par cette interaction
  • Expose la valeur d’origine aux modèles d’emails via une variable uiLocales (ex : "Langues demandées : {{uiLocales}}")

En savoir plus sur la documentation : UI locales docs.

Prérequis

  • Un tenant Logto (Cloud ou OSS)
  • Une application intégrée à Logto (Démarrage rapide)
  • Au moins une langue supplémentaire activée dans l’Expérience de connexion (Langues localisées)

Optionnel mais utile :

  • Des modèles d’e-mails personnalisés ou des modèles gérés par un provider, pour voir la localisation des e-mails (Templates e-mail)

Option 1 : Utiliser ui_locales via les extraParams du SDK

Les SDK Logto te permettent de passer des paramètres OIDC additionnels pendant la connexion. Ajoute ui_locales dans extraParams :

Remarques :

  • Fournis une liste d'étiquettes BCP 47 séparées par un espace. Logto choisira le premier tag existant dans la bibliothèque de langues de ton tenant (par exemple, fr-CA, sinon fr, sinon en).
  • Fonctionne pour chaque interaction—la langue par défaut du tenant n'est pas modifiée.
  • Tu peux combiner ui_locales avec d'autres paramètres standards/personnalisés (ex : login_hint, organization_id, ou des instructions d’affichage du premier écran).

Option 2 : Ajouter ui_locales à ton URL d’autorisation

Si tu construis la requête d'autorisation OIDC manuellement (ou via un client OIDC générique), ajoute ui_locales directement :

Comment les emails sont localisés

Quand une interaction déclenche un e-mail (ex : code de vérification), Logto détermine la langue dans cet ordre :

  1. ui_locales (premier tag supporté)
  2. Sinon, détection automatique via l’en-tête HTTP Accept-Language
  3. Sinon, langue par défaut du tenant

Logto tente ensuite de trouver un modèle d'e-mail personnalisé correspondant à la langue résolue et au type de template ; si aucun n’est trouvé, il utilise le template par défaut du connecteur.

Pour les modèles gérés par le provider (ex : Postmark, HTTP Email) : Logto transmet à la fois uiLocales et locale à ton provider. Si ui_locales est présent, locale utilisera le premier tag supporté de ui_locales.

À voir : Localisation des modèles d’e-mails.

Références

Essayez Logto Cloud gratuitement