Usuários de e-mail/senha - Flutter SDK

Função de confirmação personalizada

Se você configurar o Atlas App Services para usar uma função personalizada para confirmação de endereço de e-mail, manipule a confirmação do usuário com a lógica do fluxo da sua função personalizada. O backend do Atlas App Services invoca a função personalizada quando o usuário se registra.

Enviar um e-mail de confirmação

Você só precisa enviar um e-mail de confirmação se configurar o Atlas App Services para lidar com a confirmação do usuário por e-mail.

Para confirmar um usuário recém-criado, passe uma confirmação token e tokenId para EmailPasswordAuthProvider.confirmUser(). Eles estão incluídos no e-mail enviado para o endereço de e-mail do usuário quando ele se registra.

EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.confirmUser(token, tokenId);

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

Use este método de confirmação do usuário se você tiver configurado o backend do Atlas App Services para tentar novamente uma função personalizada de confirmação do usuário.

Para tentar novamente uma função de confirmação, passe o e-mail usado na inscrição para EmailPasswordAuthProvider.retryCustomConfirmationFunction().

EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.retryCustomConfirmationFunction("lisa@example.com");

Reenviar um e-mail de confirmação do usuário

Use este método de confirmação do usuário se você tiver configurado o backend do Atlas App Services para reenviar um e-mail de confirmação. Os tokens de confirmação em cada URL expiram após 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 reenviar um e-mail de confirmação, passe o e-mail usado na inscrição para EmailPasswordAuthProvider.resendUserConfirmation().

EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.resendUserConfirmation("lisa@example.com");

Chamar uma função de redefinição

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 EmailPasswordAuthProvider.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.

// The password reset function takes any number of
// arguments.
final args = [];
EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.callResetPasswordFunction(
    "lisa@example.com", "n3wSt0ngP4ssw0rd!",
    functionArgs: args);
// ... Later...
// Token and tokenId are parameters you can access
// in the App Services function context. You could send
// this to the user via email, SMS, or some other method.
final token = "someToken";
final tokenId = "someTokenId";
await authProvider.completeResetPassword(
    "n3wSt0ngP4ssw0rd!", token, tokenId);

// The password reset function takes any number of
// arguments. You might ask the user to provide answers to
// security questions, for example, to verify the user
// should be able to complete the password reset.
final args = [
  "Snowball II",
  "Springfield Elementary School",
  "Bouvier"
];
EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.callResetPasswordFunction(
    "lisa@example.com", "n3wSt0ngP4ssw0rd!",
    functionArgs: args);

Enviar 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 enviar um e-mail de redefinição de senha, passe o e-mail usado na inscrição para EmailPasswordAuthProvider.resetPassword().

EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.resetPassword("lisa@example.com");

Os e-mails de redefinição de senha contêm uma URL codificada com dois valores, token e tokenId. Para concluir o fluxo de redefinição de senha, você pode redefinir a senha do usuário no cliente ou chamando uma função personalizada no backend. Para usar o SDK para concluir a redefinição de senha, passe esses valores para EmailPasswordAuthProvider.completeResetPassword().

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.

EmailPasswordAuthProvider authProvider = EmailPasswordAuthProvider(app);
await authProvider.completeResetPassword(
    "n3wSt0ngP4ssw0rd!", token, tokenId);