Autenticación de correo electrónico/contraseña

Estado de la nueva cuenta de usuario

Una cuenta de usuario puede estar en uno de 2 estados: Pendiente y Confirmado.

Al iniciarse el proceso de confirmación, Atlas App Services crea una cuenta de usuario y establece el estado en Pending Confirmation. En este estado, el usuario no puede iniciar sesión. Dado que la dirección de correo electrónico ya está asociada a una cuenta de usuario, cualquier intento de volver a registrarla fallará.

Con la cuenta en estado pendiente, el usuario debe confirmar su cuenta antes de iniciar sesión. Cuando el usuario confirma su cuenta, Atlas App Services establece el estado en Confirmed y el usuario puede iniciar sesión.

Si confirma usuarios automáticamente, la cuenta se crea con el estado establecido en Confirmed y el usuario puede iniciar sesión inmediatamente después de registrarse.

Puede ver una lista de cuentas de usuario pendientes en la interfaz de usuario o a través de las API de App Services:

Enviar correo electrónico de confirmación

Con este método de confirmación, los usuarios deben responder a un correo electrónico al registrarse. El correo electrónico contiene un enlace a una URL de confirmación. El usuario debe visitar este enlace en un plazo de 30 minutos para confirmar que controla la dirección de correo electrónico.

Configure los siguientes ajustes para que App Services envíe automáticamente un correo electrónico de confirmación:

• Email Confirmation URL: la base de la URL incluida en cada correo electrónico de confirmación. App Services añade un token y un tokenId únicos a esta URL. Estos sirven como parámetros de consulta para crear un enlace único para cada confirmación. Para confirmar al usuario, primero extraiga estos parámetros de consulta de su URL única. Luego, pase los token y los tokenId a la función confirmUser del SDK del cliente.

  Las aplicaciones móviles pueden gestionar la confirmación de correo electrónico directamente en la aplicación. Para ello, configure los enlaces profundos.en Android o enlaces universales en iOS.

• Email Confirmation Subject: el asunto del correo electrónico que envía App Services. Este valor es opcional; si se omite, App Services utiliza un asunto predeterminado. Los asuntos de confirmación de correo electrónico personalizados pueden contener un máximo de 256 caracteres.

Ejecutar una función de confirmación

Puedes usar Run a Confirmation Function cuando se registra un nuevo usuario. App Services envía un token de confirmación, un ID de token y el correo electrónico del usuario a la función que creaste. Esta función ejecuta la lógica necesaria para confirmar al usuario y devuelve uno de los siguientes objetos de resultado, que se explican con más detalle a continuación:

• { status: 'success' }

• { status: 'fail' }

• { status: 'pending' }

Dentro de la función, se define una lógica personalizada para confirmar usuarios. Por ejemplo, la función podría:

• Envíe correos electrónicos de confirmación personalizados desde un dominio específico. Envíelos con una plantilla específica mediante un servicio externo.

• Leer los permisos del usuario de una colección en MongoDB Atlas o en un servicio externo REST.

• Envíe mensajes de confirmación a través de un servicio distinto al correo electrónico, como SMS.

La firma de la función de confirmación personalizada tiene un parámetro. Es un objeto que contiene datos de usuario y tokens de confirmación. Estos campos son:

La función de confirmación de usuario personalizada devuelve un objeto con un campo de estado. La siguiente tabla describe los posibles valores de este campo:

El siguiente es un ejemplo de una función de confirmación de usuario que:

1. Comprueba que el correo electrónico proporcionado sea un correo electrónico válido.

2. Confirma que la dirección de correo electrónico proporcionada tiene acceso a un servicio particular.

3. Envía un mensaje SMS al usuario.

4. Si el mensaje se envía correctamente, informa a Atlas App Services para crear una nueva cuenta con estado Pendiente.

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 la función personalizada confirme automáticamente al usuario, debe proporcionar un medio para que el usuario complete el proceso de confirmación después de que se active la función. Después de completar cualquier paso de confirmación adicional, llame al método "Confirmar usuario" del SDK para finalizar la creación de la cuenta de usuario en Atlas App Services.

Confirmar usuarios automáticamente

Puedes configurar el proveedor para Automatically Confirm Users. Cuando selecciona App Services confirma inmediatamente los nuevos usuarios de Email/Contraseña después del registro.

Enviar un correo electrónico de restablecimiento de contraseña

Puedes configurar el proveedor para que Send a Password Reset Email.. Cuando un usuario solicita un restablecimiento de contraseña, App Services envía una URL de restablecimiento de contraseña al correo electrónico del usuario. El usuario debe visitar este URL dentro de 30 minutos.

Al configurar correos electrónicos de restablecimiento de contraseña, puede configurar los siguientes ajustes:

• Password Reset URL: la base de la URL incluida en cada correo electrónico de restablecimiento de contraseña. App Services añade un token y un tokenId únicos a esta URL. Estos sirven como parámetros de consulta para crear un enlace único para cada restablecimiento de contraseña. Para restablecer la contraseña del usuario, extraiga estos parámetros de consulta de la URL única del usuario. Pase el token y el tokenId a la función resetPassword del SDK del cliente.

• Reset Password Email Subject: el asunto del correo electrónico que envía App Services. Este valor es opcional: si se omite, App Services usa un asunto predeterminado. Los asuntos personalizados para restablecer la contraseña pueden contener un máximo de 256 caracteres.

Las aplicaciones móviles pueden gestionar el restablecimiento de contraseñas directamente en la app. Configure enlaces profundos en Android o enlaces universales en iOS.

Ejecutar una función de restablecimiento de contraseña

Puedes configurar el proveedor Run a Password Reset Function como. Defines una función para que App Services se ejecute cuando callResetPasswordFunction() en el SDK. App Services pasa el correo electrónico del usuario, la nueva contraseña deseada, un token de confirmación y un ID de token a la función que creas. La función ejecuta la lógica necesaria para confirmar la identidad del usuario antes de restablecer la contraseña.

Los Servicios de la aplicación pueden restablecer inmediatamente la contraseña del usuario. También puede solicitar confirmación adicional de la aplicación cliente.

La función de App Services debe devolver un objeto que contenga una clave status. Esta clave se asigna a una cadena con uno de los siguientes valores, que se explican con más detalle a continuación:

• { status: 'success' }

• { status: 'fail' }

• { status: 'pending' }

Puede utilizar una función de restablecimiento de contraseña personalizada para definir sus propios flujos de restablecimiento de contraseña:

• Envíe correos electrónicos personalizados de restablecimiento de contraseña desde un dominio específico con una plantilla particular utilizando un servicio externo.

• Interfaz con una colección de MongoDB Atlas para implementar un periodo de recuperación para el restablecimiento de contraseña. Esto puede evitar demasiados intentos de restablecimiento de contraseña en una sola cuenta durante un período determinado.

• Envíe mensajes de restablecimiento de contraseña personalizados a través de un servicio que no sea el correo electrónico.

La firma de la función de restablecimiento de contraseña personalizada es variádica: acepta cualquier número de parámetros. El primero siempre es un objeto que contiene datos de usuario y tokens de confirmación. Todos los parámetros siguientes son personalizados y se pasan al SDK del cliente como una colección de argumentos. Por ejemplo, la llamada al SDK del cliente:

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

Se convierte en esta firma personalizada para la función de restablecimiento de contraseña:

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

En la función de restablecimiento de contraseña personalizada, se debe pasar un objeto como primer parámetro. La siguiente tabla describe los campos de este objeto:

La función de restablecimiento de contraseña personalizada debe devolver un objeto que contenga un campo status. El valor de este campo status puede ser uno de los siguientes:

Una función de restablecimiento de contraseña personalizada puede incluir elementos similares a este ejemplo:

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' };
   }
}