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.
CharlesDeveloper
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.
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.
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 :
Quand une interaction déclenche un e-mail (ex : code de vérification), Logto détermine la langue dans cet ordre :
ui_locales (premier tag supporté)
Sinon, détection automatique via l’en-tête HTTP Accept-Language
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.
