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.
CharlesDeveloper
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.
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.
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:
Quando uma interação desencadeia um email (por exemplo, código de verificação), o Logto resolve o idioma por esta ordem:
ui_locales (primeira tag suportada)
Se não, deteta automaticamente via header HTTP Accept-Language
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.
