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

Estado de la nueva cuenta de usuario

A user account can be in one of 2 states: Pending and Confirmed.

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á.

With the account in the pending state, the user must confirm their account before logging in. When the user confirms their account, Atlas App Services sets the status to Confirmed and the user can log in.

Si está confirmando a los 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 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 the following settings to have App Services automatically send a confirmation email:

• Email Confirmation URL: the base of the URL included in every confirmation email. App Services appends a unique token and tokenId to this URL. These serve as query parameters to create a unique link for every confirmation. To confirm the user, first extract these query parameters from the user's unique URL. Then, pass the token and tokenId to the Client SDK's confirmUser function.

  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: la línea de asunto del correo electrónico que Servicios de aplicación envía. Este valor es opcional, si se omite, App Services utiliza una línea de asunto por defecto en su lugar. Los asuntos personalizados de confirmación por correo electrónico 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' }

Within the function, you define custom logic to confirm users. For example, your function might:

• 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ía mensajes de confirmación a través de un servicio que no sea el 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 personalizada del usuario devuelve un objeto con un campo de estado. La siguiente tabla describe los valores potenciales de este campo:

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

1. Verifica que el correo electrónico proporcionado sea 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.

Automatically Confirm Users

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.

Send a Password Reset Email

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. Aplicación Services añade un token y un tokenId únicos a esta URL. Estos sirven como parámetros de query para crear un enlace único para cada restablecimiento de contraseña. Para restablecer la contraseña del usuario, extrae estos parámetros de query de la URL única del usuario. Pasar el token y 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. La 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:

• Send custom password reset emails from a specific domain with a particular template using an external service.

• 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)

In the custom password reset function, an object must be passed as the first parameter. The following table describes the fields found in this object:

The custom password reset function must return an object that contains a status field. The value of this status field may be one of:

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