Autenticação por e-mail/senha

Status da nova conta de usuário

Uma conta de usuário pode estar em um dos 2 estados: pendente e confirmado.

Quando o processo de confirmação é iniciado, o Atlas App Services cria uma conta de usuário e define o status como Pending Confirmation. Nesse estado, o usuário não pode fazer login. Como o endereço de e-mail agora está associado a uma conta de usuário, qualquer tentativa de registrar novamente o mesmo e-mail não terá sucesso.

Com a conta no estado pendente, o usuário deve confirmar sua conta antes de fazer login. Quando o usuário confirmar sua conta, o Atlas App Services define o status para Confirmed e o usuário pode registrar.

Se você estiver confirmando usuários automaticamente, a conta será criada com o status definido como Confirmed e o usuário poderá fazer login imediatamente após o registro.

Você pode visualizar uma lista de contas de usuário pendentes na UI ou por meio das APIs do App Services:

Enviar um e-mail de confirmação

Com esse método de confirmação, os usuários deverão responder a um e-mail no momento do cadastro. O e-mail contém um link para uma URL de confirmação. O usuário deve visitar este link dentro de 30 minutos para confirmar que ele controla o endereço de e-mail.

Configure as seguintes configurações para que o App Services envie automaticamente um e-mail de confirmação:

• Email Confirmation URL: a base da URL incluída em cada e-mail de confirmação. O App Services acrescenta um token e tokenId exclusivos a essa URL. Isso serve como parâmetros de query para criar um link exclusivo para cada confirmação. Para confirmar o usuário, primeiro extraia esses parâmetros de query da URL exclusiva do usuário. Em seguida, passe o token e o tokenId para a função confirmUser do SDK do cliente.

  Os aplicativos móveis podem lidar com a confirmação por e-mail diretamente na aplicação. Para fazer isso, configure links detalhados em links Android ou universais no iOS.

• Email Confirmation Subject: a linha de assunto do e-mail que o App Services envia. Esse valor é opcional. Se omitido, o App Services usa uma linha de assunto padrão. Os assuntos de confirmação do e-mail personalizados podem conter no máximo 256 caracteres.

Executar uma função de confirmação

Você pode Run a Confirmation Function quando um novo usuário se registrar. O App Services passa um token de confirmação, um ID de token e o e-mail do usuário para a função que você cria. Sua função, em seguida, executa a lógica que você precisa para confirmar o usuário e, em seguida, retorna um dos seguintes objetos de resultado, que são explicados em mais detalhes abaixo:

• { status: 'success' }

• { status: 'fail' }

• { status: 'pending' }

Na função, você define lógica personalizada para confirmar os usuários. Por exemplo, sua função pode:

• Envie e-mails de confirmação personalizados de um domínio específico. Envie-os com um modelo específico usando um serviço externo.

• Ler permissões de usuário de uma coleção no MongoDB Atlas ou em um serviço REST externo.

• Envie mensagens de confirmação por um serviço que não seja e-mail, como SMS.

A assinatura da função de confirmação personalizada tem um parâmetro. É um objeto que contém dados de usuário e tokens de confirmação. Esses campos são:

A função personalizada de confirmação do usuário retorna um objeto com um campo de status. A tabela a seguir descreve os valores em potencial deste campo:

Veja a seguir um exemplo de uma função de confirmação do usuário que:

1. Verifica se o e-mail fornecido é um e-mail válido.

2. Confirma se o endereço de e-mail fornecido tem acesso a um serviço específico.

3. Envia uma mensagem SMS ao usuário.

4. Se a mensagem for enviada com sucesso, informa ao Atlas App Services para criar uma nova conta com um status pendente.

exports = ({ token, tokenId, username }) => {
   // Validate the username
   const isValidEmail = myCustomValidatorService.validate(username);
   // Check if the user has access to this service
   const isPrivileged =
      myCustomAuthorizationService.hasAccess(username)
   // Send a message to the user so that they can confirm themselves
   const msgSendSuccessful = isValidEmail && isPrivileged
      && mySmsService.send(username, token, tokenId)
   if ( msgSendSuccessful ) {
      return { status: 'pending' };
   } else {
      return { status: 'fail' };
   }
}

A menos que a função personalizada confirme automaticamente o usuário, é necessário fornecer um meio para que o usuário conclua o processo de confirmação após a ativação da função. Depois de concluir as etapas adicionais de confirmação, chame o método Confirmar Usuário do SDK para finalizar a criação da conta de usuário no Atlas App Services.

Confirmar usuários automaticamente

Você pode configurar o provedor para Automatically Confirm Users. Quando selecionado, o App Services confirma imediatamente novos usuários de e-mail/senha após o registro.

Enviar um e-mail de redefinição de senha

Você pode configurar o provedor para Send a Password Reset Email. Quando um usuário solicita uma redefinição de senha, o App Services envia um URL de redefinição de senha para o endereço de e-mail do usuário. O usuário deve acessar esta URL dentro de 30 minutos.

Ao configurar e-mails de redefinição de senha, você pode definir as seguintes configurações:

• Password Reset URL: a base da URL incluída em cada e-mail de redefinição de senha. O App Services acrescenta um token e tokenId exclusivos a essa URL. Isso serve como parâmetros de query para criar um link exclusivo para cada redefinição de senha. Para redefinir a senha do usuário, extraia esses parâmetros de query da URL exclusiva do usuário. Passe o token e tokenId para a função resetPassword do SDK do cliente.

• Reset Password Email Subject: a linha de assunto do e-mail que o App Services envia. Este valor é opcional: se omitido, o App Services usa uma linha de assunto padrão. Os assuntos personalizados de redefinição de senha podem conter no máximo 256 caracteres.

Os aplicativos móveis podem lidar com redefinições de senha diretamente no aplicativo. Configure links profundos no Android ou links universais no iOS.

Executar uma função de redefinição de senha

Você pode configurar o provedor para Run a Password Reset Function. Você define uma função para que os App Services sejam executados quando você usa callResetPasswordFunction() no SDK. O App Services transmite o e-mail do usuário, a nova senha desejada, um token de confirmação e um ID de token para a função que você cria. Em seguida, sua função executa a lógica necessária para confirmar a identidade do usuário antes de redefinir a senha.

O App Services pode redefinir imediatamente a senha do usuário. Ou você pode exigir confirmação adicional do aplicativo do cliente.

A função do App Services deve retornar um objeto contendo uma chave status. Os principais mapas para uma string com um dos seguintes valores, que são explicados em mais detalhes abaixo:

• { status: 'success' }

• { status: 'fail' }

• { status: 'pending' }

Você pode usar uma função de redefinição de senha personalizada para definir seus próprios fluxos de redefinição de senha:

• Envie e-mails de redefinição de senha personalizados de um domínio específico com um modelo determinado usando um serviço externo.

• Conecte-se com uma collection do MongoDB Atlas para implementar um "período de bloqueio" de redefinição de senha. Isso pode evitar muitas tentativas de redefinição de senha em uma única conta em determinada faixa de tempo.

• Envie mensagens de redefinição de senha personalizadas por um serviço diferente do e-mail.

A assinatura da função de redefinição de senha personalizada é variada: ela aceita qualquer número de parâmetros. O primeiro é sempre um objeto que contém dados de usuário e tokens de confirmação. Todos os parâmetros a seguir são parâmetros personalizados. Eles são passados para o SDK do cliente como uma coleção de argumentos. Por exemplo, a chamada do SDK do cliente:

callResetPasswordFunction("myUsername", "newPassword", ["Security Question Answer 1", "Security Question Answer 2", "securityCode:0510"])

Torna-se esta assinatura personalizada para a função de redefinição de senha:

resetFunc({username, password, token, tokenId, currentPasswordValid}, securityAnswer1, securityAnswer2, securitySMSCode)

Na função de redefinição de senha personalizada, um objeto deve ser passado como o primeiro parâmetro. A tabela a seguir descreve os campos encontrados neste objeto:

A função de redefinição de senha personalizada deve retornar um objeto que contém um campo status. O valor deste campo status pode ser um dos seguintes:

Uma função de redefinição de senha personalizada pode incluir elementos semelhantes a este exemplo:

exports = ({ token, tokenId, username, password, currentPasswordValid }) => {
   // check if the username corresponds to a real user
   const isUser = myCustomValidator.validate(username);
   // check if the user is attempting to reset their password to their current password
   if (currentPasswordValid) {
     myCustomNotifier.sendMessage(username, "Cannot reset password to current password.");
     return { status: 'fail' };
   }
   // check if the user has requested a password reset too often recently
   const isNotCoolingDown = myCustomCooldownService.canReset(username, 'myCustomService')
   // send a message to the user in some way so that the user can confirm themselves
   const msgSendSuccessful = isUser && isNotCoolingDown && myCustomMsgr.send(username, token, tokenId)
   if ( msgSendSuccessful ) {
      return { status: 'pending' };
   } else {
      return { status: 'fail' };
   }
}