Português (Portugal)
  • localização
  • internacionalização
  • i18n
  • l10n
  • ui_locales
  • locale

Localiza a tua experiência de início de sessão Logto com OIDC ui_locales

Torna a tua experiência de início de sessão nativa para cada utilizador. Neste tutorial, vais aprender a usar o parâmetro padrão do OIDC ui_locales para definir o idioma da interface de início de sessão da Logto, e dos emails relacionados, em tempo real.

Charles
Charles
Developer

Pare de perder semanas com autenticação de utilizadores
Lance aplicações seguras mais rapidamente com o Logto. Integre a autenticação de utilizadores em minutos e concentre-se no seu produto principal.
Começar
Product screenshot

Porque deves usar ui_locales?

A Logto já suporta conteúdos multilingues e deteção automática, mas há situações em que podes querer escolher explicitamente o idioma para uma interação específica:

  • Produtos multi-organização com preferências linguísticas diferentes por organização
  • Deep links vindos de campanhas num idioma específico
  • Páginas de produto com CTAs localizadas que iniciam o início de sessão no mesmo idioma
  • Testes A/B para onboarding localizado

Além disso, ui_locales é um parâmetro standard suportado por muitos fornecedores de identidade e SDKs.

O que faz o ui_locales

  • Define o idioma da interface de início de sessão para a interação atual (a primeira tag suportada é usada)
  • Influencia a localização dos emails para as mensagens desencadeadas por esta interação
  • Expõe o valor original para os templates de email como uma variável uiLocales (por exemplo: "Idiomas pedidos: {{uiLocales}}")

Sabe mais na referência: Documentação sobre UI locales.

Pré-requisitos

  • Um tenant Logto (Cloud ou OSS)
  • Uma aplicação integrada com o Logto (Guia rápido)
  • Pelo menos um idioma adicional ativado na Experiência de Início de Sessão (Idiomas localizados)

Opcional mas útil:

  • Templates de email personalizados ou templates geridos pelo fornecedor ativados, para veres a localização dos emails em ação (Templates de email)

Opção 1: Usar ui_locales via SDK extraParams

Os SDKs da Logto permitem-te passar parâmetros OIDC extra durante o início de sessão. Adiciona ui_locales em extraParams:

Notas:

  • Fornece uma lista de tags BCP 47 separadas por espaços. O Logto vai escolher a primeira tag que exista na biblioteca de idiomas do teu tenant (por exemplo, fr-CA, senão fr, senão en).
  • Funciona por interação—o idioma padrão do teu tenant não é alterado.
  • Podes combinar ui_locales com outros parâmetros standard/personalizados (por exemplo, login_hint, organization_id ou diretivas do ecrã inicial).

Opção 2: Adiciona ui_locales ao teu URL de autorização

Se estiveres a construir o pedido de autorização OIDC manualmente (ou via um cliente OIDC genérico), adiciona diretamente o ui_locales:

Como os emails são localizados

Quando uma interação desencadeia um email (por exemplo, código de verificação), o Logto resolve o idioma por esta ordem:

  1. ui_locales (primeira tag suportada)
  2. Se não, deteta automaticamente via header HTTP Accept-Language
  3. Se não, utiliza o idioma padrão do tenant

Depois, o Logto tenta encontrar um template de email personalizado que corresponda ao idioma resolvido e tipo de template; se não encontrar, recorre ao template padrão do conector.

Templates geridos por fornecedores (ex: Postmark, HTTP Email): o Logto envia tanto uiLocales como locale ao teu fornecedor. Se houver ui_locales, o locale utiliza a primeira tag suportada desse parâmetro.

Vê: Localização de templates de email.

Referências

Experimente o Logto Cloud gratuitamente