1. Fingerprint Authentication

Huawei provides the secure fingerprint authentication capability. If the system is insecure, the callback method BioAuthnCallback.onAuthError() returns the error code BioAuthnPrompt.ERROR_SYS_INTEGRITY_FAILED. If the system is secure, fingerprint authentication is performed. For details about the fingerprint authentication error codes, please refer to the API Reference.

The following is the sample code for using the fingerprint authentication capability:

import android.view.View; 
import androidx.appcompat.app.AppCompatActivity; 
import androidx.core.content.ContextCompat; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnCallback; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnManager; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnPrompt; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnResult; 
public class MainActivity extends AppCompatActivity { 
    public void btnFingerAuthenticateWithoutCryptoObjectClicked(View view) { 
        // Whether fingerprint authentication is supported. 
        BioAuthnManager bioAuthnManager = new BioAuthnManager(this); 
        int errorCode = bioAuthnManager.canAuth(); 
        if (errorCode != 0) { 
            // Fingerprint authentication is not supported. 
            return; 
        } 
        // Callback. 
        BioAuthnCallback callback = new BioAuthnCallback() { 
            @Override 
            public void onAuthError(int errMsgId, CharSequence errString) { 
                // Authentication error. 
            } 
            @Override 
            public void onAuthSucceeded(BioAuthnResult result) { 
                // Authentication successful. 
            } 
            @Override 
            public void onAuthFailed() { 
                // Authentication failed. 
            } 
        }; 
        BioAuthnPrompt bioAuthnPrompt = new BioAuthnPrompt(this, ContextCompat.getMainExecutor(this), callback); 
        // Construct the prompt information.  
        BioAuthnPrompt.PromptInfo.Builder builder = 
            new BioAuthnPrompt.PromptInfo.Builder().setTitle("This is the title.") 
                .setSubtitle("This is the subtitle") 
                .setDescription("This is the description"); 
        // Prompt the user to use the fingerprint for authentication, and also provide options for the user to use the PIN, lock screen pattern, or lock screen password for authentication.  
        // If the parameter is set to true here, setNegativeButtonText(CharSequence) is not supported.  
        builder.setDeviceCredentialAllowed(true); 
        // Set the cancellation button title. If a title is set, setDeviceCredentialAllowed(true) is not supported. 
        // builder.setNegativeButtonText("This is the 'Cancel' button."); 
        BioAuthnPrompt.PromptInfo info = builder.build(); 
        bioAuthnPrompt.auth(info); 
    } 
}

2. 3D Facial Authentication

Huawei provides the secure 3D facial authentication capability. If the system is insecure, the callback method BioAuthnCallback.onAuthError returns the error code FaceManager.FACE_ERROR_SYS_INTEGRITY_FAILED. If the system is secure, 3D facial authentication is performed. For details about the 3D facial authentication error codes, please refer to the API Reference.

The following is the sample code for using the 3D facial authentication capability:

import android.os.CancellationSignal; 
import android.os.Handler; 
import android.view.View; 
import androidx.appcompat.app.AppCompatActivity; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnCallback; 
import com.huawei.hms.support.api.fido.bioauthn.BioAuthnResult; 
import com.huawei.hms.support.api.fido.bioauthn.CryptoObject; 
import com.huawei.hms.support.api.fido.bioauthn.FaceManager; 
public class MainActivity extends AppCompatActivity { 
    public void btnFaceAuthenticateWithoutCryptoObjectClicked(View view) { 
        // Callback. 
        BioAuthnCallback callback = new BioAuthnCallback() { 
            @Override 
            public void onAuthError(int errMsgId, CharSequence errString) { 
                // Authentication error. 
            } 
            @Override 
            public void onAuthHelp(int helpMsgId, CharSequence helpString) { 
                // Help. 
            } 
            @Override 
            public void onAuthSucceeded(BioAuthnResult result) { 
                // Authentication successful. 
            } 
            @Override 
            public void onAuthFailed() { 
                // Authentication failed. 
            } 
        }; 
        // Cancellation signal. 
        CancellationSignal cancellationSignal = new CancellationSignal(); 
        FaceManager faceManager = new FaceManager(this); 
        int errorCode = faceManager.canAuth(); 
        if (errorCode != 0) { 
            // Authentication is not supported. 
            return; 
        } 
        // Flags. 
        int flags = 0; 
        // Authentication message handler. 
        Handler handler = null; 
        // It is recommended that CryptoObject be set to null. In this version, KeyStore is not associated with facial authentication.  
        // The value false must be passed to KeyGenParameterSpec.Builder.setUserAuthenticationRequired(). 
        CryptoObject crypto = null; 
        faceManager.auth(crypto, cancellationSignal, flags, callback, handler); 
    } 
}