メール/パスワードユーザーの管理 - 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 はユーザーが登録すると確認メールを自動的に送信します。 メールには、 30分間有効なトークンを使用して構成されたEmail Confirmation URLへのリンクが含まれています。 ユーザーが期間内にリンクに従って確認しない場合は、新しい確認メールをリクエストする必要があります。

ユーザーに新しい確認メールを送信するには、ユーザーのメールアドレスをEmailPasswordAuth.resendConfirmationEmail() に渡します。

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

ユーザー確認機能の再試行

カスタム確認関数を再実行するには、ユーザーのメールアドレスを指定してretryCustomConfirmation()メソッドを呼び出します。

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

パスワード リセット メールの送信

ユーザーの ID を確認するためにパスワード リセット メールを送信するには、パスワード リセット メールを送信するようにアプリを設定する必要があります。

パスワード リセット プロセスを開始するには、ユーザーのメールを指定して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.colResetPasswordFunction() を呼び出すときに実行する関数を定義します。

この関数は、ユーザー名、パスワード、および任意の数の追加引数を指定できます。 これらの引数を使用して、セキュリティの質問の回答やその他のチャレンジにユーザーがパスワード リセットを正常に完了するために渡す必要があるものなどの詳細を指定できます。

独自のパスワード リセット フローを定義する場合は、カスタム パスワード リセット機能を使用することをお勧めします。 For example, you might send a custom password reset email from a specific domain. または、メール以外のサービスを使用してユーザーの ID を確認することもできます。

Atlas App Services 側では、このメソッドを呼び出すときに実行されるカスタム パスワード リセット機能を定義します。 この関数は、次の 3 つのステータスのいずれかを返すことができます。

• fail

• pending

• success

failステータスは SDK によってエラーとして扱われます。 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
);