Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

Informações
titleMatriz de evolução
Versão / ReleaseFuncionalidade
12.1.8Liberada funcionalidade "Esqueci minha senha"
12.1.20Compatibilização do envio de e-mail via "Datasul Mail Service"
12.1.22Esqueci minha senha utilizando RFI

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
    languageruby
    #+----------------------------------------------------------+
    #|				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
    languageruby
    #+-------------------------------------------+
    #|        CONFIGURACOES APPServer            |
    #+-------------------------------------------+
    progress.server.name=<SERVIDOR_APPSERVER>
    progress.server.port=<PORTA_APPSERVER>
    progress.server.application=<NOME_APPSERVER>
  3. Conferir no arquivo datasul_framework.properties, a configuração para utilização do RFI:

    Bloco de código
    languageruby
    #+----------------------------------------------------------+
    #|                CONFIGURACOES RFI                         |
    #+----------------------------------------------------------+
    rfi.server=<SERVIDOR>
    rfi.port=<PORTA>
    rfi.protocol=<http_ou_https>
  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
    languageruby
    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"):


  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:


  7. Configurar o serviço de envio de e-mail desejado no programa "Parametros 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
      languageruby
      #+----------------------------------------------------------+
      #|		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:

Aviso

Importante: O e-mail não tem relação com o usuário / senha informados na tela anterior.

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.

Nota

Importante: A senha provisória gerada não irá respeitar as regras da "Segurança Avançada" para criação de senha caso a mesma esteja habilitada. no qual a nova senha gerada poderá conter:

  • Tamanho de 8 caracteres;
  • Letras: a – z e A – Z;
  • Números de 0 a 9;
  • Caracteres especiais: ! # $ % & ? @

Somente quando o usuário efetuar o acesso no produto TOTVS Datasul 12 com a senha provisória, será solicitado a alteração da senha e então, caso as regras de "Segurança Avançada" estejam habilitadas, as mesmas são aplicadas.


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.


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

Bloco de código
languagetext
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
Nota

Importante:

  • O link que se encontra dentro do email enviado para o usuário pode ser utilizado uma única vez. Um novo acesso ao mesmo resultará em "Acesso Negado" à rotina de troca de senha.

O link também possui um prazo de expiração de 10 minutos.

  • No programa btb946aa, na aba "servidor" contexto correto para a arquitetura JBoss deve ser "menu-html".


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.

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

Bloco de código
languagetext
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
Nota

Importante:

Após o primeiro login com a senha temporária, será solicitado sua troca.