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.
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ãofr
, senãoen
). - 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:
ui_locales
(primeiro tag suportado)- Caso contrário, detecta automaticamente pelo header HTTP
Accept-Language
- 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.