Managed usuários de e-mail/senha - Node.js SDK

Conclua uma confirmação de usuário

Você precisa de um token e tokenId válidos para um usuário registrado para confirmá-lo e permitir que ele faça login. Esses valores estão disponíveis em locais diferentes, dependendo da configuração do provedor:

• Se o provedor estiver configurado para enviar um e-mail de confirmação, os valores token e tokenId serão incluídos como parâmetros de consulta no Email Confirmation URL.

• Se o provedor estiver configurado para executar uma função de confirmação, os valores token e tokenId serão passados para a função como argumentos.

Para confirmar um usuário registrado, passe um token e tokenId válidos para 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 um e-mail de confirmação

Se o provedor estiver configurado para enviar um e-mail de confirmação, o Atlas App Services enviará automaticamente um e-mail de confirmação quando um usuário se registrar. O e-mail contém um link para o Email Confirmation URL configurado com um token válido por 30 minutos. Se um usuário não seguir o link e confirmar dentro desse período, ele deverá solicitar um novo e-mail de confirmação.

Para enviar um novo e-mail de confirmação para um usuário, passe seu endereço de e-mail para EmailPasswordAuth.resendConfirmationEmail().

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

Tentar novamente uma função de confirmação do usuário

Para executar novamente sua função de confirmação personalizada, ligue para o método retryCustomConfirmation() com o endereço de e-mail do usuário:

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

Enviar um e-mail de redefinição de senha

Para enviar e-mails de redefinição de senha para confirmar a identidade do usuário, você deve configurar seu aplicativo para enviar um e-mail de redefinição de senha.

Para iniciar o processo de redefinição de senha, ligue para EmailPasswordAuth.sendResetPasswordEmail() com o e-mail do usuário. O e-mail contém um link para o Password Reset URL configurado. O usuário deve acessar esta URL dentro 30 minutos para confirmar a redefinição.

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

Depois que o usuário acessar o URL a partir do e-mail de redefinição de senha, chame EmailPasswordAuth.resetPassword() com o e-mail do usuário, a nova senha e os token e tokenId fornecidos no URL exclusivo.

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

Se o usuário não acessar a URL do e-mail de redefinição de senha dentro de 30 minutos, o token e o tokenId expirarão. Você deve iniciar o processo de redefinição de senha novamente.

Ligar para uma função de redefinição de senha

Ao configurar seu aplicativo para executar uma função de redefinição de senha, você define a função que deve ser executada quando chamar EmailPasswordAuth.callResetPasswordFunction().

Esta função pode receber um nome de usuário, uma senha e qualquer número de argumentos adicionais. Você pode usar esses argumentos para especificar detalhes como respostas a perguntas de segurança ou outros desafios que o usuário deve passar para concluir com êxito uma redefinição de senha.

Você pode preferir usar uma função personalizada de redefinição de senha quando quiser definir seus próprios fluxos de redefinição de senha. Por exemplo, você pode enviar um e-mail de redefinição de senha personalizado de um domínio específico. Ou você pode usar um serviço diferente do e-mail para confirmar a identidade do usuário.

No lado do App Services, você define a função personalizada de redefinição de senha que é executada quando você chama esse método. Essa função pode retornar um dos três status possíveis:

• fail

• pending

• success

Um status fail é tratado como um erro pelo SDK. O SDK callResetPasswordFunction() não recebe valores de retorno, portanto, não retorna um status pending ou success ao 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
);