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

Completa 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 });

Retry a User Confirmation Function

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

Send a Password Reset Email

Para enviar correos de restablecimiento de contraseña y así confirmar la identidad del usuario, se debe configurar la aplicación para enviar un correo 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,
});

If the user does not visit the URL from the password reset email within 30 minutes, the token and tokenId expire. You must begin the password reset process again.

Call a Password Reset Function

When you configure your app to run a password reset function, you define the function that should run when you call EmailPasswordAuth.callResetPasswordFunction().

Esta función puede tomar un nombre de usuario, una contraseña y cualquier número de argumentos adicionales. Puedes utilizar estos argumentos para especificar detalles como las respuestas a las preguntas de seguridad u otros desafíos que el usuario debe superar para completar con éxito el restablecimiento de contraseña.

Es posible que prefieras usar una función personalizada de restablecimiento de contraseña cuando quieras definir tus propios flujos de restablecimiento de contraseña. Por ejemplo, puede que envíes un correo electrónico personalizado de restablecimiento de contraseña desde un dominio específico. O podría usar un servicio que no sea correo electrónico para confirmar la identidad del usuario.

On the App Services side, you define the custom password reset function that runs when you call this method. That function can return one of three possible statuses:

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