Saltar al contenido principal

Idiomas de la interfaz de usuario

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 tenant.
  • Afecta la localización de correos electrónicos para los mensajes desencadenados 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.
  • Establece el código de país predeterminado para el número de teléfono en la experiencia de inicio de sesión. Por ejemplo, si ui_locales=fr, el campo de entrada del número de teléfono tendrá por defecto Francia (+33). Esto es útil cuando deseas controlar el código de país predeterminado de forma programática para grupos de usuarios o regiones específicas.

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 de resolución y precedencia​

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 a organizaciones).
  3. De lo contrario, el idioma predeterminado del tenant configurado en la Experiencia de Inicio de Sesión.

Este comportamiento no cambia permanentemente tu 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, pasa a fr, luego a en.
  • ui_locales=ja pero el japonés no está habilitado → Pasa a Accept-Language o al idioma predeterminado del tenant.