Objetivo

O objetivo desta funcionalidade é gerar uma senha temporária de acesso ao TOTVS Datasul 12 para o usuário em caso de esquecimento de senha.

Conceito

A funcionalidade "Esqueci Minha Senha" permite que um usuário do produto TOTVS Datasul 12, de maneira rápida e fácil, receba por e-mail uma senha temporária para acesso ao produto caso o mesmo esqueça sua senha atual.

Ao utilizar esta funcionalidade, o usuário pode recuperar seu acesso ao produto sem que tenha que solicitar ao administrador do sistema para que o mesmo restaure sua senha, o que torna o processo mais flexível e ágil e consequentemente, libera o administrador de realizar esta tarefa manualmente.

Configuração

Para ativar esta funcionalidade, as seguintes condições devem ser obedecidas:

1. Alterar o arquivo de propriedades do TOTVS Datasul 12 (datasul_framework.properties). Este arquivo está localizado no diretório do servidor JBoss, no qual deverá acrescentar (caso não exista) uma nova propriedade "enable.recover.password=true" e atribuir um valor logico indicando se a recuperação de senha está habilitada. Caso não exista esta propriedade, o sistema assumira o valor false como padrão:

   Bloco de código
   language ruby
   #+----------------------------------------------------------+ #| RECUPERAÇÃO DE SENHA | #+----------------------------------------------------------+ enable.recover.password=true

2. Conferir no arquivo datasul_framework.properties, a configuração para utilização de um APPServer, o mesmo deve estar ativo e disponível:

   Bloco de código
   language ruby
   #+-------------------------------------------+ #| CONFIGURACOES APPServer | #+-------------------------------------------+ progress.server.name=<SERVIDOR_APPSERVER> progress.server.port=<PORTA_APPSERVER> progress.server.application=<NOME_APPSERVER>

3. Conferir a configuração para utilização do RFI:

   1. [JBOSS] - DTS - RFI (Request for Information)

4. O produto não deve utilizar integração com o Fluig, ou seja, a propriedade fluig.integration (arquivo fluig.properties) deverá conter o valor false conforme exemplo abaixo. Este arquivo está localizado no mesmo diretório do datasul_framework.properties.

   Bloco de código
   language ruby
   fluig.integration=false

   
   

5. A opção "Utilizar domínio?" deve estar desmarcada na tela de login (A funcionalidade está disponível somente para usuários do tipo de acesso "Interno"):
   Image Modified
   
   
6. Configurar a opção “Altera Senha” na seção “Senha Expirada” do programa "Parâmetros de Segurança Avançada" (SEC000ZD), no qual deve estar selecionada:
   Image Modified
   
   
7. Configurar o serviço de envio de e-mail desejado no programa Parâmetros Email Foundation (BTB962ZB).
   
   

   1. Caso o "Servidor" de e-mail seja o "Datasul Mail Service", é necessário complementar a parametrizações abaixo no arquivo datasul_framework.properties com um usuário e senha de login no TOTVS Datasul 12:

      Bloco de código
      language ruby
      #+----------------------------------------------------------+ #| CONFIGURACOES SSO | #+----------------------------------------------------------+ sso.java.naming.security.principal=<USUARIO_LOGIN_DATASUL> sso.java.naming.security.credentials=<SENHA_USUARIO_LOGIN>

Utilização

Ao clicar no link "Esqueci minha senha", o usuário será direcionado para a tela abaixo, onde digitará o e-mail ao qual o usuário está associado:

Image Modified

Considerações

1. O e-mail deve estar associado a um usuário;
2. O e-mail não pode estar associado a mais de um usuário;
3. O usuário associado ao e-mail deve ser do tipo "Interno".

Validações Realizadas

As seguintes validações são consideradas para que o envio da senha por e-mail seja efetuado: 

• O e-mail informado deve pertencer a um e somente um usuário cadastrado no produto Datasul. Caso não seja encontrado nenhum usuário associado ao e-mail ou forem encontrados mais de um usuário associado, então será apresentada uma mensagem de erro.
• O tipo de acesso do usuário associado ao e-mail deve ser igual a "Interno". Caso o usuário não seja do tipo Interno então será mostrada uma mensagem de erro.
• O e-mail informado deve conter:
  • O caractere arroba (@);
  • Uma parte antes do caractere arroba (@);
  • Uma parte depois do caractere arroba (@).

Validações Não Realizadas

Não são realizadas validações quanto a existência do e-mail e também não será realizado validações quanto ao seu recebimento.
Sendo assim, caso exista um usuário cadastrado no produto com o e-mail informado, então uma senha provisória será enviada ao e-mail informado e cabe ao usuário informar um e-mail válido ao qual ele tenha acesso.

Após clicar no botão de "Enviar e-mail", um email é enviado para o usuário contendo um link com um período de expiração de 10 minutos.

Image Modified

O usuário receberá um e-mail com uma mensagem no seguinte padrão:

Assunto: Redefinir senha
Caro usuário <nome do usuário>.
Segue link para a redefinição da senha de acesso ao produto Datasul.
Link: http://<servidor>:<porta>/datasul-rfi/auth/?guid=<token-único-com-prazo-para-expiração>

Obrigado,
Equipe Totvs Tecnologia - Linha Datasul

Ao clicar no Link, o usuário será encaminhado para uma tela contendo um aviso informando que um email foi enviado para a caixa de email do usuário.

Image Modified

O usuário receberá um e-mail com uma mensagem no seguinte padrão:

Assunto: Redefinir senha
Caro usuário <nome do usuário>.
Segue abaixo senha temporária para acesso ao produto Datasul, sendo que a mesma deverá ser alterada logo no primeiro acesso ao produto.
Senha: <senha temporária>

Obrigado,
Equipe Totvs Tecnologia - Linha Datasul

Resolução de problemas

Para o caso onde o usuário recebe o e-mail contendo o link para realizar a troca da senha e uma mensagem de erro é mostrada informando Requisição de informação não encontrada ou inválida deve-se verificar as configurações de horário do servidor onde o servidor de aplicação está sendo executado de modo a verificar se o horário do servidor está correto. Além disso, é preciso verificar se o horário da JVM do servidor de aplicação está correto. Para tal, consulte o documento abaixo:

https://centraldeatendimento.totvs.com/hc/pt-br/articles/360018657791-DS-TEC-Java-com-hor%C3%A1rio-de-ver%C3%A3o-incorreto

Além disso, é preciso ajustar a configuração de timezone da JVM de acordo com a localização do servidor de aplicação. Por exemplo:

No Windows: set JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=America/Sao_Paulo
No Linux: JAVA_OPTS="$JAVA_OPTS -Duser.timezone=America/Sao_Paulo"

As configurações acima podem ser realizadas no script de carga do serviço de acordo com o sistema operacional.