Localizza la tua esperienza di accesso Logto con OIDC ui_locales
Rendi l'esperienza di accesso nativa per ogni utente. In questo tutorial imparerai a usare il parametro standard OIDC ui_locales per impostare la lingua in tempo reale dell'interfaccia di accesso di Logto e delle email correlate.
CharlesDeveloper
Smetti di sprecare settimane sull'autenticazione degli utenti
Lancia app sicure più velocemente con Logto. Integra l'autenticazione degli utenti in pochi minuti e concentrati sul tuo prodotto principale.
Logto supporta già contenuti multilingue e il rilevamento automatico della lingua, ma ci sono momenti in cui vuoi scegliere esplicitamente la lingua per una specifica interazione:
Prodotti multi-organizzazione con preferenze linguistiche diverse per ogni organizzazione
Deep link da campagne in una lingua specifica
Pagine prodotto con CTA localizzate che avviano l'accesso nella stessa lingua
Test A/B per onboarding localizzato
Inoltre, ui_locales è un parametro standard supportato da molti identity provider e SDK.
Un'applicazione integrata con Logto (Guide rapide)
Almeno una lingua aggiuntiva abilitata in Sign-in Experience (Lingue localizzate)
Opzionale ma utile:
Template email personalizzati o gestiti dal provider abilitati, per vedere la localizzazione delle email in azione (Template email)
Opzione 1: Usa ui_locales tramite extraParams dell'SDK#
Gli SDK Logto ti permettono di passare parametri OIDC extra durante l'accesso. Aggiungi ui_locales in extraParams:
Note:
Fornisci un elenco di tag BCP 47 separati da uno spazio. Logto selezionerà il primo tag presente nella libreria delle lingue del tuo tenant (es. fr-CA, altrimenti fr, altrimenti en).
Funziona per interazione: la lingua predefinita del tenant non viene cambiata.
Puoi combinare ui_locales con altri parametri standard/personalizzati (come login_hint, organization_id o direttive per la prima schermata).
Opzione 2: Aggiungi ui_locales alla tua URL di autorizzazione#
Se stai gestendo manualmente la richiesta di autorizzazione OIDC (o tramite un client OIDC generico), aggiungi direttamente ui_locales:
Quando un'interazione genera un'email (es. codice di verifica), Logto risolve la lingua in questo ordine:
ui_locales (primo tag supportato)
Altrimenti rilevamento automatico tramite header HTTP Accept-Language
Altrimenti lingua predefinita del tenant
Poi Logto prova a trovare un template email personalizzato che corrisponda alla lingua risolta e al tipo di template; se non ne trova, usa quello predefinito del connettore.
Template gestiti dal provider (per esempio Postmark, HTTP Email): Logto passa sia uiLocales che locale al provider. Se è presente ui_locales, locale utilizza il primo tag supportato di ui_locales.
