Português (Brasil)
  • localization
  • internationalization
  • i18n
  • l10n
  • ui_locales
  • locale

Localize sua experiência de login do Logto com OIDC ui_locales

Faça com que sua experiência de login pareça nativa para cada usuário. Neste tutorial, você vai aprender como usar o parâmetro padrão OIDC ui_locales para definir o idioma em tempo de execução da interface de login do Logto e dos e-mails relacionados.

Charles
Charles
Developer

Pare de perder semanas com autenticação de usuários
Lance aplicativos seguros mais rapidamente com o Logto. Integre a autenticação de usuários em minutos e concentre-se no seu produto principal.
Começar
Product screenshot

Por que usar ui_locales?

O Logto já oferece suporte a conteúdo multilíngue e detecção automática, mas há situações em que você quer escolher explicitamente o idioma para uma interação específica:

  • Produtos multi-organizacionais com preferências de idioma diferentes por organização
  • Links diretos de campanhas em um idioma específico
  • Páginas de produto com CTAs localizados que iniciam o login no mesmo idioma
  • Testes A/B para onboarding localizado

Além disso, ui_locales é um parâmetro padrão suportado por muitos provedores de identidade e SDKs.

O que ui_locales faz

  • Define o idioma da interface de login para a interação atual (o primeiro tag suportado é utilizado)
  • Influencia a localização de e-mails disparados devido a essa interação
  • Expõe o valor original para templates de e-mail como variável uiLocales (exemplo: "Idiomas solicitados: {{uiLocales}}")

Saiba mais na referência: Documentação de UI locales.

Pré-requisitos

  • Um tenant Logto (Cloud ou OSS)
  • Um aplicativo integrado ao Logto (Comece rápido)
  • Pelo menos um idioma adicional habilitado na Experiência de Login (Idiomas localizados)

Opcional, mas útil:

  • Templates de e-mail customizados ou templates gerenciados pelo provedor ativados, para ver a localização do e-mail em ação (Templates de e-mail)

Opção 1: Use ui_locales via extraParams do SDK

Os SDKs do Logto permitem passar parâmetros OIDC extras durante o login. Adicione ui_locales em extraParams:

Observações:

  • Forneça uma lista separada por espaços de tags BCP 47. O Logto irá escolher o primeiro tag que existe na biblioteca de idiomas do seu tenant (ex.: fr-CA, senão fr, senão en).
  • Funciona por interação—o idioma padrão do seu tenant não é alterado.
  • Você pode combinar ui_locales com outros parâmetros padrão/personalizados (ex.: login_hint, organization_id ou instruções para a primeira tela).

Opção 2: Adicione ui_locales à sua URL de autorização

Se você estiver montando a requisição de autorização OIDC manualmente (ou via cliente OIDC genérico), adicione ui_locales diretamente:

Como os e-mails são localizados

Quando uma interação dispara um e-mail (ex.: código de verificação), o Logto resolve o idioma nessa ordem:

  1. ui_locales (primeiro tag suportado)
  2. Caso contrário, detecta automaticamente pelo header HTTP Accept-Language
  3. Caso contrário, idioma padrão do tenant

Depois, o Logto tenta encontrar um template de e-mail personalizado que corresponda ao idioma resolvido e tipo de template; se não encontrar, faz fallback para o padrão do conector.

Templates gerenciados por provedor (ex.: Postmark, HTTP Email): O Logto envia uiLocales e locale para seu provedor. Se ui_locales estiver presente, locale utiliza o primeiro tag suportado de ui_locales.

Veja: Localização de templates de e-mail.

Referência