@hedsdesign/loopback-recuperacao-senha-mixin v1.0.0

Loopback Recuperação de Senha Mixin

Este módulo foi projetado para o framework Strongloop Loopback. Ele fornece funcionalidade de recuperação de senha com métodos mas fácil para integração com angular2+. De um modo geral ele gera uma chave com seis números que é enviada para o email do usuário que ele pode usála pra recuperar o token de curta duração para enfim alterar a senha. Ele cria duas propriedades na tabela para armazenamento da chave e o token temporário e um método api/model/reset-token e já dá a permissão da ACL para o acesso a esse método, porque por padrão no model baseado no User possui todos os metódos bloqueados excetos alguns como o de login, logout, etc.

INSTALAÇÃO

  npm install --save @hedsdesign/loopback-recuperacao-senha-mixin

ADICIONANDO MIXIN

Com loopback-boot@v2.8.0 mixinSources foram implementado de forma que permita carregar este mixin sem alterações no arquivo server.js previamente requerido.

Adicione as propriedade e mixins e a tabela de log no arquivo server/model-config.json como a seguir:

{
  "_meta": {
    "sources": [
     ...
    ],
    "mixins": [
     ...
      "../node_modules/@hedsdesign/loopback-recuperacao-senha-mixin/dist/mixins"      
    ]
  },
  ...
  "Email": {
    "dataSource": "emailDs"
  }
}

E configure com os dados do seu servidor de email SMTP no arquivo datasources.json como no exemplo

{
  "emailDs": {
    "name": "emailDs",
    "connector": "mail",
    "transports": [
      {
        "type": "smtp",
        "host": "smtp.gmail.com",
        "secure": true,
        "port": 465,
        "tls": {
          "rejectUnauthorized": false
        },
        "auth": {
          "user": "naoresponda@gmail.com",
          "pass": "suasenha"
        }
      }
    ]
  }
}

IMPORTANDO O MIXIN

Você apenas deverá adicionar o mixin a sua tabela (model) como o exemplo:

"mixins": {
    "RecuperacaoSenha": true   
  }

ou ajustando apenas propriedades principais:

"mixins": {
   "RecuperacaoSenha": {       
        "senderAddress": "naoresponda@seusite.com.br",
        "subject": "Seu Aplicativo - Chave de alteração da senha",
        "html": "Sua chave para resetar a senha é: <b>{chave}</b>. Use essa chave para resetar a sua senha."
    }
  }

ou ajustando com as opções disponíveis como no exemplo:

"mixins": {
   "RecuperacaoSenha": {
        "ChaveSenha": "ChaveSenha",
        "ChaveSenhaToken": "ChaveSenhaToken",
        "emailModel": "Email",
        "senderAddress": "naoresponda@seusite.com.br",
        "subject": "Seu Aplicativo - Chave de alteração da senha",
        "html": "Sua chave para resetar a senha é: <b>{chave}</b>. Use essa chave para resetar a sua senha."
    }
  }

LÓGICA DE IMPLEMENTAÇÃO

Você solicitaria a recuperação de senha usando o método padrão do loopback api/model/reset que ele enviará o email para o usuário com uma chave que ele gerou.

Depois com a chave em mãos você precisa recuperar o token de curta duração para então gerar a nova senha. Então você faz uma solicitação POST para api/model/reset-token com o email e a chave e ele retornará o seguinte:

{
  "ChaveSenhaToken": "4o7Z0b5IWeCVncfJBU31sh80PdG8yoocd57EjUSZyGpVKrMVhswFtFXvsBoYfvkx"
}

Com esse token você cria uma nova senha usando o método padrão POST api/model/reset-password?access_token=4o7Z0b5IWeCVncfJBU31sh80PdG8yoocd57EjUSZyGpVKrMVhswFtFXvsBoYfvkx e a nova senha "newPassword"

LICENÇA

MTI