Skip to main content

Liveness Verification

This process is used to verify both the image and the liveness of the user. It ensures that the user is physically present and not using a photo or video during the verification process, enhancing security by confirming the user's live presence.

How to Setup

1 Go to Workspace > Workflows, and click on the flow created for Liveness Verification. If you need understanding in creating a workflow, refer to the step-by-step guide here.

2 Hover over the plus (+) symbol and select Workflow. From the list, click Liveness Verification to add it.

Liveness Verification

3 Click on the newly added workflow, then select the General tab to customize your preferences.

General

Manage General

(*) Indicates an action to be mandatory.

NameDescription
*Display NameSet a name to the workflow for easy identification.
DescriptionSummarize the purpose and functionality of this workflow module.
EnableThis toggle is enabled by default. When enabled, the particular workflow module begins its execution. Conversely, if disabled, the workflow module remains inactive and won't proceed.
RuleThis determines the criteria for triggering the particular workflow module. When the selected rule is evaluated, and is satisfied, the workflow proceeds as provided. If not, the workflow will not be executed. Note: If no rules are set, the workflow defaults to its standard action without any rule. For more information about the rules, refer here.

4 Then, click on the Configs tab to set the necessary configurations.

Configs

Manage Configs

ConfigurationDescription
Face comparisonThis feature compares the user's image and video during the verification process to confirm their identity.
Blink verificationUsers are prompted to perform specific blinking actions for verification purposes.
Movement verificationThis involves assessing the user's movements to confirm their identity.
Fingers count verificationUsers are required to display their fingers to the camera as part of the verification process.
Speech verificationVerification necessitates users to recite a specific word in a video as a means of confirmation.

5 After you've configured everything needed, click on the SAVE button.

6 Proceed to attach the workflow to the relevant application for execution. Refer to instructions on how to attach a workflow to an application here.

Expected Result

Based on the provided configuration, the information that will be fetched for Liveness Verification includes the following parameters:

NameDescription
liveness_completedThis indicates whether the liveness verification has been completed. The value will be "True" if the verification is successfully completed and "False" if it is not.
liveness-fingercount-verifiedChecks whether the finger count during the liveness verification process has been verified ("True" if completed, "False" if not).
liveness-speech-verifiedIndicates whether the speech during the liveness verification process has been verified ("True" if completed, "False" if not).
liveness_videoURL to the video used for the liveness verification process.
liveness-blink-verifiedChecks whether the blinking during the liveness verification process has been verified ("True" if completed, "False" if not).
photo_urlURL to the photo used or captured during the liveness verification process.
liveness-movement-verifiedValidates the movement during the liveness verification ("True" if completed, "False" if not).

The response received will include the accurate information mentioned above. Note that, the response values can vary depending on the specific workflow modules.

How it Works

1 Launch Postman or your preferred API tool and execute the flow by configuring the suitable Method, URL, and Body settings. If you're seeking guidance on how to perform these actions, see here.

2 Upon initiating the API call, a verification request will be sent to your configured Verification Way settings.

3 Based on the request, execute the flow in an incognito browser and follow the prompts to complete the verification process.

4 Before proceeding, familiarize yourself with the Do's and Don'ts. Once you're aware, click on Capture Picture to begin.

  1. Before proceeding, familiarize yourself with the Do's and Don'ts. Once you're aware, click on Start to begin.

Liveness

5 Once you have taken the pictures, click on Submit.

6 The verification process will be completed only if the provided data is valid.

If "force onboarding" is enabled in the API request, all users, regardless of status, will be directed to the onboarding flow first, followed by the verification flow if configured.

Completed

7 The response can differ depending on the chosen Verification Way and Notification Way configurations. To know more, see here.

8 Here is a sample response for Liveness Verification:

{
"request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
"workflow": "verification",
"user_id": "mark@gmail.com",
"liveness_completed": "true/false",
"liveness-fingercount-verified": "true/false",
"liveness-speech-verified": "true/false",
"liveness_video": "https://minio-api.eztovrfy.com/xx-xx-xx",
"liveness-blink-verified": "true/false",
"photo_url": "https://minio-api.eztovrfy.com/xx-xx-xx",
"liveness-movement-verified": "true/false"
}