Italiano
  • localizzazione
  • internazionalizzazione
  • i18n
  • l10n
  • ui_locales
  • locale

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.

Charles
Charles
Developer

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.
Inizia ora
Product screenshot

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, 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:

Come vengono localizzate le email

Quando un'interazione genera un'email (es. codice di verifica), Logto risolve la lingua in questo ordine:

  1. ui_locales (primo tag supportato)
  2. Altrimenti rilevamento automatico tramite header HTTP Accept-Language
  3. 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.

Riferimenti