Pular para o conteúdo principal

Redefinir senha

O Logto oferece uma funcionalidade abrangente de redefinição de senha que permite aos usuários recuperar com segurança o acesso às suas contas quando esquecem suas senhas ou desejam alterá-las. Este recurso suporta múltiplos métodos de verificação, incluindo email e SMS, garantindo que os usuários possam recuperar o acesso pelo canal de comunicação de sua preferência.

Esqueci a senha para recuperação de conta

Configuração

Para habilitar a funcionalidade de "esqueci a senha":

  1. Configurar conectores: Configure os conectores de Email ou SMS em Console > Conectores > Conectores de Email e SMS

  2. Coletar informações de contato do usuário: Certifique-se de que os usuários tenham email/telefone registrados durante o cadastro ou via configurações da conta

  3. Habilitar métodos de verificação:

  4. Salvar e testar: Salve as alterações e teste usando o Live Preview

Fluxo de experiência do usuário

Uma vez que o recurso de redefinição de senha esteja habilitado, um botão de link "Esqueci a senha" será exibido abaixo do formulário de login. Os usuários podem clicar no link "Esqueci a senha" para iniciar o processo de redefinição de senha.

  1. Visitar a página de login: O usuário acessa a página de login.
  2. Clicar no link Esqueci a senha: O usuário clica no link "Esqueci a senha".
  3. Inserir email/telefone: Após clicar no link "Esqueci a senha", o usuário será redirecionado para uma nova página onde poderá inserir seu endereço de email ou número de telefone registrado.
  4. Enviar código de verificação: O Logto enviará um código de verificação para o email ou telefone informado pelo usuário e redirecionará para a página de verificação do código.
  5. Inserir código de verificação: O usuário insere o código de verificação recebido em seu email ou telefone. O Logto verificará o código e a identidade do usuário associado ao endereço de email ou número de telefone.
  6. Inserir nova senha: O usuário será solicitado a inserir uma nova senha assim que o código de verificação for validado com sucesso.
  7. Redefinição de senha bem-sucedida: Se a senha fornecida atender aos requisitos da política de senha, a senha será atualizada com sucesso.
  8. Redirecionar para a página de login: O usuário será redirecionado para a página de login para acessar com a nova senha.
Fluxo de redefinição de senha

Atualizar senha após o login

Usuários autenticados podem alterar (ou definir inicialmente) sua senha através da experiência de configurações de conta dentro do seu aplicativo. Veja Configurações da conta para saber como construir isso com a Account API.

Verificar se o usuário possui uma senha

Os dados do usuário expõem um campo booleano hasPassword indicando se o usuário possui atualmente uma credencial de senha armazenada.

Você pode obter hasPassword por:

Depois, chame o endpoint da Account API para definir ou atualizar a senha (veja o guia de configurações da conta para detalhes da requisição). Para usuários que nunca tiveram uma senha, você NÃO precisa (e não deve exigir) o campo de senha antiga.

dica:

Mesmo que seus métodos de cadastro exijam "Definir uma senha" para registros por email / telefone / nome de usuário, usuários criados via login social puro pulam a criação de senha por padrão para reduzir atrito. Esses usuários terão hasPassword = false até que definam uma senha posteriormente. Evite forçar a configuração imediata de senha logo após o cadastro social, a menos que seja exigido pelo seu modelo de segurança — prompts contextuais e atrasados geralmente convertem melhor.

Política de senha personalizada

Personalize o comprimento da senha, requisitos de caracteres e restrições de palavras para atender às necessidades de segurança do seu negócio, proporcionando uma boa experiência ao usuário. Essas configurações podem ser ajustadas na seção Segurança > Política de senha. Consulte a documentação de política de senha para saber mais.

Perguntas frequentes

Como deslogar um usuário após uma redefinição de senha bem-sucedida?

Assine o evento de webhook PostResetPassword (webhook event) para receber uma notificação quando um usuário redefinir a senha com sucesso. Você pode então acionar uma ação de logout para invalidar a sessão atual do usuário e redirecioná-lo para a página de login.

Como implementar o fluxo de redefinição de senha na minha interface personalizada?

Você pode implementar seu próprio fluxo de redefinição de senha utilizando a Management API e a Account API do Logto. Confira configurações da conta para mais detalhes.

Você pode criar um endpoint de redefinição de senha auto-hospedado e utilizar o SDK do Logto para iniciar uma solicitação de login com first_screen definido como reset-password. Isso redirecionará o usuário de forma transparente para a página de redefinição de senha.