托管电子邮件/密码用户 - Node.js SDK

完成用户确认

您需要注册用户的有效 token和tokenId ，以确认其身份并允许其登录。 这些值在不同位置可用，具体取决于提供商配置：

• 如果提供程序设置为发送确认电子邮件，则token和tokenId值将作为查询参数包含在 Email Confirmation URL中。

• 如果提供程序设置为运行确认函数，则token和tokenId值将作为参数传递给该函数。

要确认注册用户，请将有效的token和tokenId传递给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}`);
}

重新发送确认电子邮件

如果提供商配置为发送确认电子邮件，则 Atlas App Services 会在用户注册时自动发送确认电子邮件。该电子邮件包含已配置Email Confirmation URL的链接，该链接带有有效期为30分钟的令牌。如果用户没有在该期限内点击链接并确认，则必须请求新的确认电子邮件。

要向用户发送新的确认电子邮件，请将其电子邮件地址传递给EmailPasswordAuth.resendConfirmationEmail()。

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

重试用户确认函数

要重新运行自定义确认函数，请使用用户的电子邮件地址调用retryCustomConfirmation()方法：

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

发送密码重置电子邮件

要发送密码重置电子邮件以确认用户身份，您必须将应用配置为发送密码重置电子邮件。

要开始密码重置过程，请使用用户的电子邮件调用EmailPasswordAuth.sendResetPasswordEmail() 。该电子邮件包含已配置Password Reset URL的链接。用户必须在30分钟内访问此 URL 才能确认重置。

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

在用户访问密码重置电子邮件中的 URL 后，使用用户的电子邮件地址、新密码以及唯一 URL 中提供的token和tokenId调用EmailPasswordAuth.resetPassword() 。

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

如果用户在 30 分钟内没有访问密码重置电子邮件中的 URL， token和tokenId则会过期。 您必须再次开始密码重置过程。

调用密码重置函数

当您将应用程序配置为运行密码重置函数时，您可以定义在调用EmailPasswordAuth.callResetPasswordFunction() 时应运行的函数。

此函数可以接受用户名、密码和任意数量的其他参数。 您可以使用这些参数指定用户应传递以成功完成密码重置的详细信息，例如安全问题回答或其他挑战。

如果要定义自己的密码重置流程，您可能更愿意使用自定义密码重置函数。 例如，您可以从特定域发送自定义密码重置电子邮件。 或者，您可以使用电子邮件以外的服务来确认用户的身份。

在 App Services 端，您可以定义在调用此方法时运行的自定义密码重置函数。 该函数可以返回三种可能的状态之一：

• fail

• pending

• success

SDK 将fail状态视为错误。 SDK callResetPasswordFunction()不接受返回值，因此它不会向客户端返回pending或success状态。

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