Android Secure Components v3.9.0

Improves the public interface of the biometrics enrollment flow and minor fixes.

Added

• Added startEnrollment(activity, certificates, completion) to improve the result reporting of enrollment flow via WeavrEnrollmentResult.

Changed

• Improved SDK initialization performance-internal security token generation is now deferred until first use, reducing startup latency.

Fixed

• Fixed 401 responses during enrollment not dismissing the flow correctly.

Deprecated

• Deprecated startPSAEnrollment(activity, firebaseToken, authToken, certificates, listener) in favor of startEnrollment(activity, certificates, completion).

---

Migration guide

To adopt the new startEnrollment method you need to take the following actions:

Ensure you have called the following prerequisites in order:

1. UXComponents.initialize(context, env, uiKey)-at app startup
2. UXComponents.psa.initialize(context, psaENV, logger)-at app startup
3. UXComponents.setUserToken(context, token, listener)-after user login
4. UXComponents.psa.updateDeviceToken(fcmToken, listener)-after user login

Update your calling site to a snippet similar to the following:

UXComponents.psa.startEnrollment(
    activity = this,
    certificates = R.array.com_google_android_gms_fonts_certs,
    completion = { result ->
        when (result) {
            is WeavrEnrollmentResult.Completed ->
                println("The enrollment was completed successfully")
            is WeavrEnrollmentResult.InitialisationError ->
                println("There was an error while initialising the enrollment flow: ${result.error}")
            is WeavrEnrollmentResult.CryptographyError ->
                println("There was an error in the cryptography operations: ${result.error}")
            is WeavrEnrollmentResult.FailedBiometricsChallenge ->
                println("The user failed the biometrics challenge")
            is WeavrEnrollmentResult.Unauthorized ->
                println("The token present in the SDK is not valid")
            is WeavrEnrollmentResult.UserDoesNotConsent ->
                println("The user cancelled the flow")
            is WeavrEnrollmentResult.FailedToLoadBrand ->
                println("Failed to load the brand configuration")
            is WeavrEnrollmentResult.NoPhoneNumberAvailable ->
                println("No phone number available to perform the SMS OTP flow")
            is WeavrEnrollmentResult.NoBiometricsAvailable ->
                println("No biometrics available. Availability: ${result.availability}")
            is WeavrEnrollmentResult.ChallengeFailed ->
                println("The challenge failed due to ${result.cause}")
        }
    }
)

Result reference

Result	Description
Completed	Enrollment finished successfully.
InitialisationError	The enrollment flow could not be initialised.
CryptographyError	A cryptography operation failed.
FailedBiometricsChallenge	The user failed the biometric prompt.
Unauthorized	The user token stored in the SDK is invalid or expired.
UserDoesNotConsent	The user cancelled or dismissed the flow.
FailedToLoadBrand	Brand configuration could not be loaded.
NoPhoneNumberAvailable	No phone number is available for the SMS OTP step.
NoBiometricsAvailable	The device has no usable biometrics enrolled.
ChallengeFailed	The challenge failed; inspect result.cause for details.