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.
Perché usare ui_locales?
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.
Cosa fa ui_locales
- Imposta la lingua dell'interfaccia di accesso per l'interazione attuale (vince il primo tag supportato)
- Influenza la localizzazione delle email per i messaggi generati da questa interazione
- Espone il valore originale ai template email come variabile
uiLocales
(es., "Lingue richieste:{{uiLocales}}
")
Scopri di più nella documentazione di riferimento: Documentazione UI locales.
Prerequisiti
- Un tenant Logto (Cloud o OSS)
- 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
, altrimentifr
, altrimentien
). - Funziona per interazione: la lingua predefinita del tenant non viene cambiata.
- Puoi combinare
ui_locales
con altri parametri standard/personalizzati (comelogin_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
:
Come vengono localizzate le email
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
.
Vedi: Localizzazione dei template email.