Pular para o conteúdo principal

Parâmetros de autenticação

Em um fluxo padrão de login OIDC, aplicativos clientes iniciam uma solicitação de autenticação que redireciona o usuário para a página web da experiência universal de login hospedada pelo Logto. Com base nas configurações da sua experiência de login, os usuários podem fazer login ou cadastro usando vários identificadores, métodos de verificação e conectores sociais ou SSO corporativos de terceiros.

O Logto também suporta parâmetros opcionais padrão do OIDC, como:

  • login_hint: Fornece uma dica para o identificador do usuário, por exemplo, preencher previamente o email / nome de usuário
  • ui_locales: Controla o idioma em tempo de execução para a interação atual, incluindo a interface de login e emails relacionados.
  • acr_values e max_age: Solicita autenticação step-up com um nível específico de garantia (urn:logto:acr:1fa ou urn:logto:acr:mfa) ou idade máxima da autenticação.

Além dos parâmetros de autenticação OIDC padrão, nosso produto introduz vários parâmetros de autenticação personalizados que permitem adaptar a experiência de login desejada para os usuários finais.

Isso é particularmente útil quando você deseja impor fluxos de login específicos para diferentes segmentos de usuários. Incluindo, mas não se limitando aos seguintes cenários:

Cadastro direto para novos usuários​

Para uma campanha de registro direcionada, você pode querer direcionar novos usuários diretamente para a página de cadastro, ignorando o formulário de login padrão, para garantir uma experiência de onboarding sem atritos.

Uso: Parâmetro Primeira tela → first_screen=register

Cadastro com email preenchido a partir da homepage​

Você frequentemente vê um campo de cadastro de email em destaque na seção principal da homepage, incentivando o registro rápido do usuário. Após os usuários inserirem seu email e clicarem no botão "Comece agora", esses parâmetros permitem redirecioná-los para a página de cadastro com o campo de email pré-preenchido, agilizando o processo de registro.

Essa abordagem também é útil para formulários de assinatura ou outros cenários de coleta de email em que você deseja reduzir a fricção no fluxo de cadastro.

Uso: Parâmetro Primeira tela → first_screen=identifier:sign_up&identifier=email&login_hint=foo@gmail.com

Campo de cadastro de email embutido na homepage

Para novos usuários que precisam configurar sua nova senha, envie um link direto e redirecione-os para a página de redefinição de senha com o campo de email pré-preenchido.

Uso: Parâmetro Primeira tela → first_screen=reset_password

Login social instantâneo​

Se você oferece botões de login social diretamente em seu site, pode usar esses parâmetros para pular o formulário de login padrão e permitir que os usuários se autentiquem diretamente com o provedor social escolhido.

Uso: Parâmetro Login direto → direct_sign_in=social:google

Login SSO direto para clientes corporativos​

Para produtos que atendem múltiplos clientes corporativos, esses parâmetros permitem exibir um botão SSO dedicado que autentica usuários com seu provedor SSO específico, pulando o formulário universal de login e proporcionando uma experiência fluida para cada organização.

Uso: Parâmetro Login direto → direct_sign_in=sso:1234567890

Formulário de cadastro embutido no site ou em um diálogo​

Para uma experiência de usuário fluida, você pode embutir um formulário completo de autenticação diretamente em seu site ou em um diálogo modal, guiando naturalmente os usuários para se cadastrar ou fazer login no momento certo.

  • Quando os usuários clicam em um botão de login social (por exemplo, "Continuar com Google"), use o parâmetro login direto para redirecioná-los imediatamente ao provedor social.
  • Quando os usuários inserem seu email e clicam no botão de cadastro, use o parâmetro primeira tela para redirecioná-los para a página de cadastro com o email pré-preenchido.

Combinando os parâmetros de autenticação mencionados acima, você pode manter o contexto e a identidade visual do seu site enquanto aproveita a infraestrutura segura de autenticação do Logto, criando uma experiência de usuário suave e profissional.

Formulário de cadastro embutido no site ou em um diálogo

Métodos de login personalizados exibidos para diferentes sites​

Se seu produto atende tanto equipes internas quanto consumidores, ou diferentes organizações, você pode adaptar a experiência de login conforme necessário. Por exemplo:

  • Para ferramentas internas, exiba apenas login por email / nome de usuário e senha.
  • Para páginas voltadas ao consumidor, ofereça todas as opções de login disponíveis, incluindo login com Google.

Uso: Diferentes configurações de primeira tela ou login direto com base no tipo de site.

Manter o prompt "Salvar senha" do iOS​

No iOS, o ASWebAuthenticationSession é fechado assim que vê o redirect URI, então o prompt do sistema "Salvar senha" é dispensado logo após o usuário fazer login com senha. Passe confirm_redirect_policy=password para que o Logto exiba uma página de continuação após o usuário inserir a senha, retornando ao app assim que o usuário continuar.

Essa página não é exibida para aplicativos de terceiros, pois sua página de consentimento já mantém a sessão aberta.

Uso: confirm_redirect_policy=password

Continue lendo para saber mais sobre os parâmetros de autenticação para personalizar a primeira tela ou habilitar uma experiência de login direto para seus usuários.

Incorpore formulários de login ou cadastro com segurança em seu site

Pequenos truques para melhorar a experiência de onboarding do seu cliente