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:

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