Saltar al contenido principal

Idiomas de la interfaz de usuario (UI locales)

Logto admite el parámetro estándar de autenticación OIDC ui_locales para controlar el idioma de la experiencia de inicio de sesión y las comunicaciones posteriores para una interacción determinada.

Qué hace​

  • Determina el idioma de la interfaz de usuario de la experiencia de inicio de sesión alojada por Logto en tiempo de ejecución. Logto selecciona la primera etiqueta de idioma en ui_locales que sea compatible con la biblioteca de idiomas de tu inquilino.
  • Afecta la localización de los correos electrónicos para los mensajes activados por la interacción (por ejemplo, correos electrónicos de código de verificación). Consulta Localización de plantillas de correo electrónico.
  • Expone el valor original a las plantillas de correo electrónico como una variable uiLocales, lo que te permite incluirlo en el asunto/contenido del correo si es necesario.

Formato del parámetro​

  • Nombre: ui_locales
  • Tipo: string
  • Valor: Lista separada por espacios de etiquetas de idioma BCP 47, por ejemplo, fr-CA fr en.
  • Referencia: OpenID Connect Core - ui_locales

Orden y precedencia de resolución​

Al determinar el idioma de la interfaz de usuario para la experiencia de inicio de sesión y los correos electrónicos relacionados, Logto resuelve el idioma del usuario final en este orden:

  1. ui_locales de la solicitud de autenticación actual (gana la primera etiqueta compatible).
  2. De lo contrario, la cabecera Accept-Language (Experience APIs / User Account APIs) o messagePayload.locale (Management APIs como invitaciones de organización).
  3. De lo contrario, el idioma predeterminado del inquilino configurado en la Experiencia de inicio de sesión.

Este comportamiento no cambia permanentemente la configuración de idioma; solo se aplica a la interacción actual.

Uso en SDK​

Si utilizas un SDK de Logto, pasa ui_locales a través de extraParams en la llamada de inicio de sesión para que se reenvíe a la solicitud de autorización:

await logtoClient.signIn({
  redirectUri: 'https://your.app/callback',
  extraParams: {
    ui_locales: 'fr-CA fr en',
  },
});

Ejemplos​

  • ui_locales=fr-CA fr en → Si fr-CA existe en tu biblioteca de idiomas, la interfaz de inicio de sesión se muestra en francés (Canadá); de lo contrario, recurre a fr, luego a en.
  • ui_locales=ja pero el japonés no está habilitado → Recurre a Accept-Language o al idioma predeterminado del inquilino.