生体認証プロンプトにシングルタップ パスキーの作成とログインを統合

Android 15 の認証情報マネージャーが認証情報のシングルタップ フローをサポートしている 作成と取得が含まれます。このフローでは、作成または使用中の認証情報の情報が、その他のオプションへのエントリ ポイントとともに生体認証プロンプトに直接表示されます。この簡素化されたプロセスにより、認証情報の作成と取得プロセスがより効率的で合理化されます。

要件:

• ユーザーのデバイスで生体認証が設定されており、ユーザーがアプリへの認証に生体認証を許可している。
• ログインフローでは、この機能は単一アカウントのシナリオでのみ有効になります。 複数の認証情報（パスキーとパスワードなど）が 表示されます。

パスキー作成フローのシングルタップを有効にする

このメソッドの作成手順は、既存の認証情報の作成手順と一致します。 プロセスをご覧ください。BeginCreatePublicKeyCredentialRequest 内で以下を使用 パスキーのリクエストが handleCreatePasskeyQuery() で処理されます。

is BeginCreatePublicKeyCredentialRequest -> {
  Log.i(TAG, "Request is passkey type")
  return handleCreatePasskeyQuery(request, passwordCount, passkeyCount)
}

handleCreatePasskeyQuery() に BiometricPromptData を含めます。 CreateEntry クラス:

val createEntry = CreateEntry(
  // Additional properties...
  biometricPromptData = BiometricPromptData(
    allowedAuthenticators = allowedAuthenticator
  )
)

認証情報プロバイダは、allowedAuthenticator プロパティを明示的に設定する必要があります。 BiometricPromptData インスタンス内。このプロパティが設定されていない場合、 デフォルトは DEVICE_WEAK です。必要に応じて、オプションの cryptoObject プロパティを設定する 選択することもできます

注: DEVICE_CREDENTIALS を使用して PIN を要求するようにデバイスが構成されている場合 またはパスコードを認証に使用（生体認証システムの有無は問わない） または有効にすると、代わりに標準の認証情報マネージャー フローが できます。つまり、プロバイダは常に null 値を受け取ります。 これらのシナリオで biometricPromptResult に対して適用されます。

ログイン パスキー フローでのシングルタップを有効にする

パスキー作成フローと同様に、ユーザーのログインを処理するための既存の設定に従います。BeginGetPublicKeyCredentialOption で、次のコマンドを使用します。 populatePasskeyData() を使用して、 認証リクエスト:

is BeginGetPublicKeyCredentialOption -> {
  // ... other logic

  populatePasskeyData(
    origin,
    option,
    responseBuilder,
    autoSelectEnabled,
    allowedAuthenticator
  )

  // ... other logic as needed
}

CreateEntry と同様に、BiometricPromptData インスタンスは次のとおりに設定されます。 PublicKeyCredentialEntry インスタンス。明示的に設定しない場合は、 allowedAuthenticator のデフォルトは BIOMETRIC_WEAK です。

PublicKeyCredentialEntry(
  // other properties...

  biometricPromptData = BiometricPromptData(
    allowedAuthenticators = allowedAuthenticator
  )
)

注: 生体認証の選択肢は、 デバイスがサポートしており、その使用を許諾しています。コードは次のとおりです。 前の例と同様に、cryptoObject が追加されています。

認証情報のエントリの選択を処理する

パスキーの作成用の認証情報エントリ選択の処理中 ログイン時のパスキーの選択、PendingIntentHandler's retrieveProviderCreateCredentialRequest の呼び出し、または 必要に応じて retrieveProviderGetCredentialRequest。このメソッドは、 メタデータを格納するコンポーネントです。たとえば パスキー作成エントリの選択] に移動し、次のようにコードを更新します。

val createRequest = PendingIntentHandler.retrieveProviderCreateCredentialRequest(intent)
if (createRequest == null) {
  Log.i(TAG, "request is null")
  setUpFailureResponseAndFinish("Unable to extract request from intent")
  return
}
// Other logic...

val biometricPromptResult = createRequest.biometricPromptResult

// Add your logic based on what needs to be done
// after getting biometrics

if (createRequest.callingRequest is CreatePublicKeyCredentialRequest) {
  val publicKeyRequest: CreatePublicKeyCredentialRequest =
    createRequest.callingRequest as CreatePublicKeyCredentialRequest

  if (biometricPromptResult == null) {
    // Do your own authentication flow, if needed
  }
  else if (biometricPromptResult.isSuccessful) {
    createPasskey(
        publicKeyRequest.requestJson,
        createRequest.callingAppInfo,
        publicKeyRequest.clientDataHash,
        accountId
    )
  } else {
    val error = biometricPromptResult.authenitcationError
    // Process the error
}

  // Other logic...
}

この例には、生体認証フローの成功に関する情報が含まれています。また、認証情報に関するその他の情報も含まれています。フローが失敗した場合は、 biometricPromptResult.authenticationError の下に表示されるエラーコードを確認します。 イベントの一部として返されるエラーコード biometricPromptResult.authenticationError.errorCode は、同じエラーコードです。 androidx.biometric ライブラリの androidx.biometric.BiometricPrompt.NO_SPACE、 androidx.biometric.BiometricPrompt.UNABLE_TO_PROCESS androidx.biometric.BiometricPrompt.ERROR_TIMEOUT など「 authenticationError には、関連するエラー メッセージも記載されます。 UI に表示できる errorCode。

同様に、retrieveProviderGetCredentialRequest 中にメタデータを抽出します。生体認証フローが null かどうかを確認します。「はい」の場合は、独自の生体認証を設定して、 あります。これは、get オペレーションが計測される方法に似ています。

val getRequest =
    PendingIntentHandler.retrieveProviderGetCredentialRequest(intent)

if (getRequest == null) {
  Log.i(TAG, "request is null")
  setUpFailureResponseAndFinish("Unable to extract request from intent")
  return
}

// Other logic...

val biometricPromptResult = getRequest.biometricPromptResult

// Add your logic based on what needs to be done
// after getting biometrics

if (biometricPromptResult == null)
{
  // Do your own authentication flow, if necessary
} else if (biometricPromptResult.isSuccessful) {

Log.i(TAG, "The response from the biometricPromptResult was ${biometricPromptResult.authenticationResult.authenticationType}")

validatePasskey(
    publicKeyRequest.requestJson,
    origin,
    packageName,
    uid,
    passkey.username,
    credId,
    privateKey
)
  } else {
    val error = biometricPromptResult.authenitcationError
    // Process the error
}

  // Other logic...