将一键式通行密钥创建和登录与生物识别提示集成

在 Android 15 上，Credential Manager 支持用于凭据创建和检索的单次点按流程。在此流程中，系统会在生物识别提示中直接显示正在创建或使用的凭据的信息，以及指向更多选项的入口点。这种简化的流程可创建更高效、更精简的凭据创建和检索流程。

要求：

• 用户的设备上已设置生物识别信息，并且用户允许使用生物识别信息来验证应用身份。
• 对于登录流程，即使该账号有多个凭据（例如通行密钥和密码），此功能也仅适用于单账号场景。

在通行密钥创建流程中启用单次点按

此方法的创建步骤与现有的凭据创建 流程一致。在 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
    ),
)

凭据提供方应在 BiometricPromptData 实例中明确设置 allowedAuthenticator 属性。如果未设置此属性，则该值默认设置为 DEVICE_WEAK。如果您的用例需要，请设置可选的 cryptoObject 属性。

注意： 如果设备配置为使用 DEVICE_CREDENTIALS 来要求使用 PIN 码 或密码进行身份验证（无论生物识别信息是否可用或 已启用），系统将使用标准凭据管理器流程，而不是 单次点按流程。这意味着，在这些场景中，提供方将始终收到 biometricPromptResult 的 null 值。

在登录通行密钥流程中启用单次点按

与通行密钥创建流程类似，此流程将遵循现有的用户登录处理设置，以便 处理用户登录。在 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.authenticationError
        // 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 还将包含与可在界面上显示的 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.authenticationError
    // Process the error
}

// Other logic...