To perform a face authentication it is required to have already an "Identification" and its verification ID. The process consist in a liveness check of the user and a final check to verify the match with the identification.
Implementation
Create a FaceAuthenticationParams object with authentication information and the verification id you want to verify
Start the verification with FaceAuthenticationActivity.startForResult
Handle result in onActivityResult method
Example to Start a Face Authentication
Please update the below code with your Client ID and Client Secret from your Customer Dashboard.
We suggest to use the token authentication in production environment.
void faceAuthentication(String verificationId) {
FaceAuthenticationParams faceAuthenticationParams = new FaceAuthenticationParamsWithClientSecret(
"< client id >",
"< client secret >",
verificationId
R.style.AuthenteqThemeBase // optional
);
FaceAuthenticationActivity.startForResult(
activity,
MY_REQUEST_FACEAUTH_CODE,
faceAuthenticationParams
);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
if (requestCode == MY_REQUEST_FACEAUTH_CODE) {
if (resultCode == RESULT_OK) {
String code = FaceAuthenticationActivity.getResult(data);
// Check face authentication result with the CODE provided
} else {
Throwable throwable = FaceAuthenticationActivity.getError(data);
// Handle error
} else {
super.onActivityResult(requestCode, resultCode, data);
}
}
}
fun faceAuthentication(verificationId: String) {
val faceAuthenticationParams = FaceAuthenticationParamsWithClientSecret(
"< client id >",
"< client secret >",
verificationId
)
FaceAuthenticationActivity.startForResult(
this,
MY_REQUEST_FACEAUTH_CODE,
faceAuthenticationParams
)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
if (requestCode == MY_REQUEST_FACEAUTH_CODE) {
if (resultCode == Activity.RESULT_OK) {
FaceAuthenticationActivity.getResult(data)?.let { code ->
// Check face authentication result with the CODE provided
}
} else {
FaceAuthenticationActivity.getError(data)?.let { error ->
// Handle error
}
}
} else {
super.onActivityResult(requestCode, resultCode, data)
}
}
Authentication Token can be obtained with face authentication API and then specified with the FaceAuthenticationParams as the following code:
{
"errorCode": "API_KEYS_MISSING",
"errorMessage": "No API Keys in the Authorization header"
{
"errorCode": "ACCOUNT_DEACTIVATED",
"errorMessage": "Account deactivated. Please contact your Authenteq Sales Representative in order to keep using this service"
}huiHjio
When successful the response will contain a single boolean property named success: