managed 이메일/비밀번호 사용자 - 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 });

비밀번호 재설정 이메일 보내기

사용자의 신원을 확인하기 위해 비밀번호 재설정 이메일을 보내려면 비밀번호 재설정 이메일을 보내도록 앱을 구성해야 합니다.

비밀번호 재설정 프로세스를 시작하려면 사용자의 이메일로 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
);