Conteúdo

  1. Visão Geral

  2. Configuração

  3. Como enviar token de acesso para o usuário

  4. Como redefinir a senha

  5. Como modificar template do e-mail
  6. Como adicionar URL com código de acesso no e-mail


01. Visão geral

.......

02. Configuração

DATASUL

A recuperação de senha deve estar ativa por meio da propriedade enable.recover.password, mais informações Documentação "datasul_framework.properties". Caso a recuperação de senha não esteja ativa será retornada mensagem de erro ao tentar utilizar o serviço.


DATASUL FOR THF 

A recuperação de senha deve estar ativa nas Propriedades do Sistema, mais informações Segurança. Caso a recuperação de senha não esteja ativa será retornada mensagem de erro ao tentar utilizar o serviço.

03. Como enviar token de acesso para o usuário

Para realizar o envio do token utilize o serviço passwordReset existente no contexto totvs-login, seguindo as premissas: 

  • O método de requisição é do tipo POST 
  • Deve ser enviado o parâmetro email, contendo o e-mail do usuário do produto, que está solicitando o token de acesso.
  • O usuário relacionado ao e-mail:
    • Deve ser do tipo INTERNO.
    • O e-mail não pode estar associado a mais de um usuário válido.
    • Não pode estar bloqueado;
    • Não pode estar inativo;
    • Caso não atenda os requisitos acima será retornado erro.
      • Erros sem mensagens
        • Erro de sintaxe inválida. ao utilizar o serviço terá como retorno 400 Bad Request
          • Exemplo: o parâmetro email errado(emaill) ou sem valor.
      • Erros com mensagens, são retornadas no formato JSON;

Exemplo de URL:  http://<SERVIDOR>:<PORTA>/totvs-login/passwordReset?email=<E-MAIL_DO_USUÁRIO>


Ao executar o serviço com sucesso, o usuário receberá um e-mail contendo o código de acesso, para redefinição de senha. O código de acesso deve ser encaminhado para o serviço de redefinição de senha verificar o procedimento de utilização no conteúdo 03. Como redefinir a senha

Abaixo temos o exemplo de um e-mail padrão contendo o código de acesso:


O template de e-mail pode ser modificado, para mais informações verificar o conteúdo 05. Como modificar o template do e-mail

O código de acesso pode ser enviado juntamente com uma URL, para mais informações verificar o conteúdo 06. Como adicionar URL com o código de acesso no e-mail

04. Como redefinir a senha


05. Como modificar o template do e-mail


06. Como adicionar URL com o código de acesso no e-mail