Gestiona usuarios con correo electrónico/contraseña - SDK de Node.js

Completar una Confirmación de Usuario

Necesitas una válida token y tokenId para un usuario registrado para confirmarlo y permitirle iniciar sesión. Estos valores están disponibles en diferentes lugares según la configuración del proveedor:

• Si el proveedor está configurado para enviar un correo electrónico de confirmación, los token tokenId valores y se incluyen como parámetros de consulta en el Email Confirmation URL.

• Si el proveedor está configurado para ejecutar una función de confirmación, los token tokenId valores y se pasan a la función como argumentos.

Para confirmar un usuario registrado, pase un token y un válidos tokenId a EmailPasswordAuth.confirmUser().

const token = "someToken";
const tokenId = "someTokenId";
try {
  await app.emailPasswordAuth.confirmUser({ token, tokenId });
  // User email address confirmed.
  console.log("Successfully confirmed user.");
} catch (err) {
  console.log(`User confirmation failed: ${err}`);
}

Reenviar un correo electrónico de confirmación

Si el proveedor está configurado para enviar un correo electrónico de confirmación, Atlas App Services enviará automáticamente un correo electrónico de confirmación cuando un usuario se registre. El correo electrónico contiene un enlace a la configuración Email Confirmation URL con un token válido durante 30 minutos. Si un usuario no sigue el enlace y lo confirma dentro de ese periodo, debe solicitar un nuevo correo electrónico de confirmación.

Para enviar un nuevo correo electrónico de confirmación a un usuario, pase su dirección de correo electrónico a EmailPasswordAuth.resendConfirmationEmail().

const email = "someone@example.com";
await app.emailPasswordAuth.resendConfirmation({ email });

Reintentar una función de confirmación de usuario

Para volver a ejecutar su función de confirmación personalizada, llame al retryCustomConfirmation() método con la dirección de correo electrónico del usuario:

const email = "someone@example.com";
await app.emailPasswordAuth.retryCustomConfirmation({ email });

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

Para enviar correos electrónicos de restablecimiento de contraseña para confirmar la identidad del usuario, debe configurar su aplicación para enviar un correo electrónico de restablecimiento de contraseña.

Para iniciar el proceso de restablecimiento de contraseña, ejecute EmailPasswordAuth.sendResetPasswordEmail() con el correo electrónico del usuario. El correo electrónico contiene un enlace a la Password Reset URL URL configurada. El usuario debe visitar esta URL en un 30 plazo de minutos para confirmar el restablecimiento.

const email = "someone@example.com";
await app.emailPasswordAuth.sendResetPasswordEmail({ email });

Después de que el usuario haya visitado la URL del correo electrónico de restablecimiento de contraseña, llame a EmailPasswordAuth.resetPassword() con el correo electrónico del usuario, la nueva contraseña y los token y tokenId proporcionados en la URL única.

await app.emailPasswordAuth.resetPassword({
  password: "newPassw0rd",
  token,
  tokenId,
});

Si el usuario no visita la URL del correo electrónico de restablecimiento de contraseña en 30 minutos, los token y tokenId caducarán. Debe reiniciar el proceso de restablecimiento de contraseña.

Llamar a una función de restablecimiento de contraseña

Cuando configura su aplicación para ejecutar una función de restablecimiento de contraseña, define la función que debe ejecutarse cuando llama a EmailPasswordAuth.callResetPasswordFunction().

Esta función puede aceptar un nombre de usuario, una contraseña y cualquier número de argumentos adicionales. Puede usar estos argumentos para especificar detalles como las respuestas a preguntas de seguridad u otros desafíos que el usuario debe superar para restablecer su contraseña.

Quizás prefiera usar una función de restablecimiento de contraseña personalizada si desea definir sus propios flujos de restablecimiento de contraseña. Por ejemplo, podría enviar un correo electrónico de restablecimiento de contraseña personalizado desde un dominio específico. O podría usar un servicio distinto del correo electrónico para confirmar la identidad del usuario.

En App Services, define la función de restablecimiento de contraseña personalizada que se ejecuta al llamar a este método. Esta función puede devolver uno de tres estados posibles:

• fail

• pending

• success

Un estado fail se considera un error por el SDK. El SDK callResetPasswordFunction() no toma valores de retorno, por lo que no devuelve un estado pending o success al cliente.

const email = "someone@example.com";
// The new password to use
const password = "newPassw0rd";
// Additional arguments for the reset function
const args = [];
await app.emailPasswordAuth.callResetPasswordFunction(
  { email, password },
  args
);

await app.emailPasswordAuth.resetPassword({
  password: "newPassw0rd",
  token,
  tokenId,
});

const email = "someone@example.com";
// The new password to use
const password = "newPassw0rd";
// Additional arguments for the reset function
const args = [];
await app.emailPasswordAuth.callResetPasswordFunction(
  { email, password },
  args
);