The Face Authentication module enables an automated selfie capture experience to identify if a user has an existing Identity in your Incode organization.

Face authentication provide an added level of security for organizations, applications, or even higher-level sections of application. For example, you could grant access to specific functionality within your application using face authentication. This would ensure the person requesting access has a valid, registered Incode Identity.

Add Face Authentication to Workflows or Flows

In Dashboard, use the left navigation to select Workflows.
Click New, or open an existing Workflow.
From the Modules list, drag and drop the Face Authentications module into the builder.
On the module node, you can click the three dots > Edit to change specific settings for the module, like using 1:N, setting image quality, or setting a different number of allowed capture attempts. The Configuration Options section below describes all of these settings. The default settings work as designed, so no changes are needed.
Add a Condition after the Face Authentications module and configure it:
1. IF Face authentication result STATUS == OK
2. Select Yes path for Configure what happens with existing steps after condition.
Click Save Condition.
Click Save & Publish.

Configuration Options

After adding the Face Authentication module to your Workflow or Flow, there are several settings you can configure based on your needs.

Refer to the table below for details about each setting.

Setting	Description
Mode	Determines the mode of comparison. Select one: 1:1: compares the authentication selfie against a specific existing user 1:N: compares the authentication selfie against all the faces in the customer organization and finds the closest match Default value: 1:1
Number of attempts	The maximum number of auto capture attempts Incode will make. As soon as there is a successful attempt, the module ends. Enter a number. Default value: 3
Auto capture timout (secs)	The maximum number of seconds Incode will attempt to auto capture the selfie. After which time, manual capture is required. Enter a number of seconds. Default value: 25
Show face capture tutorial	Controls whether the user sees a tutorial on how to capture the best possible selfie. Selected by default.
Face Match Threshold	Controls the severity on the model that does the face matching process. A high threshold is better for security, but a low threshold is better for conversions. Select one: Lo Me Hi Default value: Me Note that this setting cannot be deselected as it is a crucial part of the authentication process.
Liveness Threshold	Controls the severity on the model that performs liveness checks. A high threshold is better for security, but a low threshold is better for conversions. There are three separate Liveness checks: Physical attack: Selected by default. Default value: Me Digital attack: Deselected by default. Default value: Lo Evasion attack: Deselected by default. Default value: Me
Image Quality Threshold	Checks for the quality of the captured selfie. A high threshold is better for security, but a low threshold is better for conversions. Select one: Lo Me Hi Default value: Me
Lenses validation	In the Face Attributes section. Controls whether the system checks if the user is wearing lenses or sunglasses in the selfie. Selected by default.
Mask validation	In the Face Attributes section. Controls whether the system checks if the user is wearing a mask in the selfie. Selected by default.
Hat validation	In the Face Attributes section. Controls whether the system checks if the user is wearing a hat in the selfie. Selected by default.
Closed eyes validation	In the Face Attributes section. Controls whether the system checks if the user's eyes are closed in the selfie. Selected by default.
Brightness validation	In the Face Attributes section. Controls whether the system checks for minimum necessary brightness of the image. Selected by default.

Scoring

Every authentication attempt gets its own score.

When Liveness is OFF

The numerical score represents the face recognition/match score.
The face attributes have binary impact on the scoring - if any fail, the attempt fails

When Liveness is ON

The numerical score represents combination face recognition/match score and Liveness score.
The face attributes have binary impact on the scoring - if any fail, the attempt fails

How to integrate Face Authentications in your applications

Platform
Incode Web SDK
Incode Mobile SDK
Webflows (Oauth 2.0)