チュートリアル: セルフサービスパスワードリセットを追加する

適用対象: 次の内容が外部テナントに適用されることを示す白いチェックマーク記号が付いた緑の円。外部テナント (詳細)

このチュートリアルでは、管理者やヘルプデスクの関与なしで、ユーザーが自分のパスワードを変更またはリセットできるようにする方法について説明します。

このチュートリアルでは、次の操作を行います。

セルフサービスパスワードリセット (SSPR) フローを追加します。
SSPR に必要なユーザーインターフェイス (UI) をアプリに追加します。
エラーを処理します。

前提条件

「ネイティブ Android モバイルアプリケーションのサンプルでユーザーをサインインする」の手順を完了します。この記事では、テナント設定を使用して構成するサンプル Android を実行する方法について説明します。
セルフサービスパスワードリセットを有効にします。この記事では、SSPR の要件であるテナント内のすべてのユーザーに対して電子メールワンタイムパスコード認証方法を有効にすることができます。
チュートリアル: ネイティブ認証用に Android アプリを準備します。

セルフサービスパスワードリセットフローを追加する

Android アプリケーションに SSPR フローを追加するには、パスワードリセットユーザーインターフェイスが必要です。

ユーザーのメールアドレス (ユーザー名) を収集するための入力テキストフィールド。
ワンタイムパスコードを収集する入力テキストフィールド。
新しいパスワードを収集するための入力テキストフィールド。

ユーザーがパスワードを忘れた場合、パスワードリセットフローを開始するためにユーザー名 (電子メールアドレス) を入力するフォームが必要です。ユーザーが [パスワードを忘れた場合] ボタンまたはリンクを選択します。

パスワードリセットフローを開始する

ユーザーが [パスワードを忘れる] ボタンまたはリンク 選択したときに要求を処理するには、次のコードスニペットに示すように Android SDK の resetPassword(parameters) メソッドを使用します。

 private fun forgetPassword() { 
     CoroutineScope(Dispatchers.Main).launch { 
         val parameter = NativeAuthResetPasswordParameters(username = email)
         val actionResult = authClient.resetPassword(parameter)

         when (resetPasswordResult) { 
             is ResetPasswordStartResult.CodeRequired -> { 
                 // The implementation of submitCode() please see below. 
                 submitCode(resetPasswordResult.nextState) 
             } 
             is ResetPasswordError -> {
                 // Handle errors
                 handleResetPasswordError(resetPasswordResult)
             }
         }
     } 
 }

resetPassword(parameters) メソッドはパスワードリセットフローを開始し、電子メールワンタイムパスコードがユーザーのメールアドレスに送信されて検証されます。
resetPassword(parameters) の戻り値は、ResetPasswordStartResult.CodeRequired または ResetPasswordErrorです。
resetPasswordResult is ResetPasswordStartResult.CodeRequired場合、アプリはユーザーから電子メールワンタイムパスコードを収集し、電子メールワンタイムパスコードに示すように送信する必要があります。
resetPasswordResult is ResetPasswordError場合、Android SDK には、特定のエラーをさらに分析するためのユーティリティメソッドが用意されています。 - isUserNotFound() - isBrowserRequired()
これらのエラーは、前の操作が失敗したことを示しているため、新しい状態への参照を使用できません。「エラー処理する」セクション示されているように、これらのエラーを処理します。

電子メールワンタイムパスコードを送信する

アプリは、ユーザーから電子メールワンタイムパスコードを収集します。電子メールワンタイムパスコードを送信するには、次のコードスニペットを使用します。

private suspend fun submitCode(currentState: ResetPasswordCodeRequiredState) { 
    val code = binding.codeText.text.toString() 
    val submitCodeResult = currentState.submitCode(code) 

    when (submitCodeResult) { 
        is ResetPasswordSubmitCodeResult.PasswordRequired -> { 
            // Handle success
            resetPassword(submitCodeResult.nextState) 
        } 
         is SubmitCodeError -> {
             // Handle errors
             handleSubmitCodeError(actionResult)
         }
    } 
}

submitCode() アクションの戻り値は、ResetPasswordSubmitCodeResult.PasswordRequired または SubmitCodeErrorです。
submitCodeResult is ResetPasswordSubmitCodeResult.PasswordRequired 場合、アプリはユーザーから新しいパスワードを収集し、「新しいパスワードを送信する」に示すように送信する必要があります。
ユーザーが電子メールのワンタイムパスコードを受信しない場合、アプリは電子メールワンタイムパスコードを再送信できます。新しいメールワンタイムパスコードを再送信するには、次のコードスニペットを使用します。
```
private fun resendCode() { 
     clearCode() 

     val currentState = ResetPasswordCodeRequiredState 

     CoroutineScope(Dispatchers.Main).launch { 
         val resendCodeResult = currentState.resendCode() 

         when (resendCodeResult) { 
             is ResetPasswordResendCodeResult.Success -> { 
                 // Handle code resent success
             } 
             is ResendCodeError -> {
                  // Handle ResendCodeError errors
              }
         } 
     } 
} 
```
- resendCode() アクションの戻り値は、ResetPasswordResendCodeResult.Success または ResendCodeErrorです。
- ResendCodeError SDK の予期しないエラーです。このエラーは、前の操作が失敗したので、新しい状態への参照を使用できないことを示します。
submitCodeResult is SubmitCodeError場合、Android SDK には、特定のエラーをさらに分析するためのユーティリティメソッドが用意されています。
- isInvalidCode()
- isBrowserRequired()
これらのエラーは、前の操作が失敗したことを示しているため、新しい状態への参照を使用できません。「エラー処理する」セクション示されているように、これらのエラーを処理します。

新しいパスワードを送信する

ユーザーの電子メールを確認したら、ユーザーから新しいパスワードを収集して送信する必要があります。ユーザーからアプリが収集するパスワードは、Microsoft Entra のパスワードポリシー満たす必要があります。次のコードスニペットを使用します。

private suspend fun resetPassword(currentState: ResetPasswordPasswordRequiredState) { 
    val password = binding.passwordText.text.toString() 

    val submitPasswordResult = currentState.submitPassword(password) 

    when (submitPasswordResult) { 
        is ResetPasswordResult.Complete -> { 
            // Handle reset password complete. 
        } 
        is ResetPasswordSubmitPasswordError -> {
            // Handle errors
            handleSubmitPasswordError(actionResult)
        }
    } 
}

submitPassword() アクションの戻り値は、ResetPasswordResult.Complete または ResetPasswordSubmitPasswordErrorです。
ResetPasswordResult.Complete は、成功したパスワードリセットフローを示します。
submitPasswordResult is ResetPasswordSubmitPasswordError場合、SDK には、返される特定の種類のエラーをさらに分析するためのユーティリティメソッドが用意されています: - isInvalidPassword() - isPasswordResetFailed()

これらのエラーは、前の操作が失敗したことを示しているため、新しい状態への参照を使用できません。「エラー処理する」セクション示されているように、これらのエラーを処理します。

パスワードリセットフローが正常に完了したら、新しいサインインフローを開始せずにユーザーを自動的にサインインできます。

ResetPasswordResult.Complete はオブジェクト SignInContinuationState 返します。 SignInContinuationState は、signIn(parameters) メソッドへのアクセスを提供します。

パスワードのリセット後にユーザーを自動的にサインインさせるには、次のコードスニペットを使用します。

 private suspend fun resetPassword(currentState: ResetPasswordPasswordRequiredState) { 
     val submitPasswordResult = currentState.submitPassword(password) 
 
     when (submitPasswordResult) { 
         is ResetPasswordResult.Complete -> { 
             signInAfterPasswordReset(nextState = actionResult.nextState)
         } 
     } 
 } 
 
 private suspend fun signInAfterPasswordReset(nextState: SignInContinuationState) {
     val signInContinuationState = nextState

     val parameters = NativeAuthSignInContinuationParameters()
     val signInActionResult = signInContinuationState.signIn(parameters)

     when (actionResult) {
         is SignInResult.Complete -> {
             fetchTokens(accountState = actionResult.resultValue)
         }
         else {
             // Handle unexpected error
         }
     }
  }
 
 private suspend fun fetchTokens(accountState: AccountState) {
     val getAccessTokenParameters = NativeAuthGetAccessTokenParameters()
     val accessTokenResult = accountState.getAccessToken(getAccessTokenParameters)

     if (accessTokenResult is GetAccessTokenResult.Complete) {
         val accessToken =  accessTokenResult.resultValue.accessToken
         val idToken = accountState.getIdToken()
     }
 }

サインイン後に ID トークン要求を取得するには、「id トークン要求の読み取りの手順を使用します。

パスワードリセットエラーの処理

予期されるエラーがいくつか発生する可能性があります。たとえば、ユーザーが存在しないメールでパスワードをリセットしようとしたり、パスワードの要件を満たしていないパスワードを指定しようとしたりすることがあります。

エラーが発生した場合は、ユーザーにエラーのヒントを提供します。

これらのエラーは、パスワードリセットフローの開始時、または電子メールのワンタイムパスコードの送信時、またはパスワードの送信時に発生する可能性があります。

パスワードリセットの開始エラーを処理する

パスワードリセットの開始に起因するエラーを処理するには、次のコードスニペットを使用します。

private fun handleResetPasswordError(error: ResetPasswordError) {
    when {
        error.isUserNotFound() -> {
            // Display error
        }
        else -> {
            // Unexpected error
        }
    }
}

メールのワンタイムパスコード送信で発生したエラーを処理する

電子メールのワンタイムパスコードの送信によって発生するエラーを処理するには、次のコードスニペットを使用します。

private fun handleSubmitCodeError(error: SubmitCodeError) {
    when {
        error.isInvalidCode() -> {
            // Display error
        }
        else -> {
            // Unexpected error
        }
    }
}

パスワード送信エラーの処理

パスワードの送信によって発生するエラーを処理するには、次のコードスニペットを使用します。

private fun handleSubmitPasswordError(error: ResetPasswordSubmitPasswordError) {
    when {
        error.isInvalidPassword() || error.isPasswordResetFailed()
        -> {
            // Display error
        }
        else -> {
            // Unexpected error
        }
    }
}

次のステップ

チュートリアル: Android アプリのでの Web フォールバックのサポート

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-04-16

次の方法で共有

チュートリアル: セルフサービス パスワード リセットを追加する

前提条件

セルフサービス パスワード リセット フローを追加する

パスワード リセット フローを開始する

電子メールワンタイム パスコードを送信する