Conteúdo

1. Visão Geral

2. Configuração

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

4. Como redefinir a senha

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 tokenutilize 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.

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

Respostas de erros

• Erros sem mensagens
  • Erro de sintaxe inválida. ao utilizar o serviço terá como retorno 400 Bad Request
    • Parâmetro email errado(emaill) ou sem valor.
• Erros com mensagens:
  • As mensagens de erros são retornadas no formato JSON;

  • { "detailedMessage": "Usuário bloqueado ou não existe registro de usuário com o e-mail [email protected]", "code": "56575", "message": "Registro não encontrado ou bloqueado" }

    
    

    
    

03. Como redefinir a senha