メール/パスワードユーザー - Flutter SDK

カスタム確認機能

メールアドレス確認 にカスタム関数を使用するように Atlas App Services を構成する場合は、カスタム関数のフローのロジックでユーザー確認を取り扱います。 App Services バックエンドは、ユーザーの登録時にカスタム関数を呼び出します。

確認メールの送信

App Services がメールでユーザー確認を取り扱うように設定している場合は、確認メールを送信する必要があります。

新規作成したユーザーを確認するには、確認用の token と tokenId を EmailPasswordAuthProvider.confirmUser() に渡します。これらは、登録時にユーザーのメールアドレスに送信されるメールに含まれます。

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

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

App Services バックエンドをカスタム ユーザー確認機能を再試行するように構成した場合は、このユーザー確認メソッドを使用します。

確認機能を再試行するには、サインアップに使用したメールを EmailPasswordAuthProvider.retryCustomConfirmationFunction() に渡します。

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

ユーザー確認メールの再送信

App Services バックエンドを確認メールを再送信するように構成した場合は、このユーザー確認方法を使用します。 各 URL の確認トークンは30分後に期限切れになります。 ユーザーが期間内にリンクに従って確認しない場合は、新しい確認メールをリクエストする必要があります。

確認メールを再送信するには、サインアップに使用したメールをEmailPasswordAuthProvider.resendUserConfirmation(). に渡します。

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

リセット関数の呼び出し

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

独自のパスワード リセット フローを定義する場合は、カスタム パスワード リセット機能を使用することをお勧めします。 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ステータスを返すことはありません。

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

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

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

パスワード リセットメールを送信するには、サインアップに使用したメールを EmailPasswordAuthProvider.resetPassword() に渡します。

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

パスワード リセット メールには、token と tokenId の 2 つの値でエンコードされたURLが含まれています。パスワード リセット フローを完了するには、クライアント上で、またはバックエンドでカスタム関数を呼び出して、ユーザーのパスワードをリセットします。SDK を使用してパスワードのリセットを完了するには、これらの値を EmailPasswordAuthProvider.completeResetPassword() に渡します。

ユーザーが 30 分以内にパスワード リセット メールの URL にアクセスしない場合、 tokenとtokenIdは期限切れになります。 パスワードのリセット プロセスを再度開始する必要があります。

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