Warnings

Our biometric authentication process combines liveness detection and face matching. This page outlines the potential warnings and errors you might encounter during the biometric authentication process.

Verification Process

When performing biometric authentication, the system:

Captures a liveness session with one of our active liveness methods
Extracts a face image from the liveness session
Compares the face image to the portrait_image
Generates separate scores for liveness and face matching
Applies configured thresholds to determine the verification result

Automatic Decline Conditions

The following conditions will always result in an automatic decline regardless of application settings:

FACE_IN_BLOCKLIST - The face matches an entry in your face blocklist
NO_FACE_DETECTED - No face was detected during the liveness check
LIVENESS_FACE_ATTACK - The system detected a potential spoofing attempt
NO_REFERENCE_IMAGE - No reference image is available for comparison

Configurable Verification Settings

Applications can configure how the system handles various verification issues:

Low Liveness Score
- Risks: LOW_LIVENESS_SCORE
- Configurable thresholds:
  - Review threshold: Sessions with scores below this threshold are set to "In Review"
  - Decline threshold: Sessions with scores below this threshold are automatically declined
Low Face Match Score
- Risks: LOW_FACE_MATCH_SIMILARITY
- Configurable thresholds:
  - Review threshold: Sessions with scores below this threshold are set to "In Review"
  - Decline threshold: Sessions with scores below this threshold are automatically declined

Biometric Authentication Warnings

Tag	Description
`LOW_LIVENESS_SCORE`	The liveness check resulted in a low score, indicating potential use of non-live facial representations or poor-quality biometric data.
`NO_FACE_DETECTED`	The system couldn't identify a face during the liveness check, which may be due to poor image quality, improper positioning, or technical issues.
`LIVENESS_FACE_ATTACK`	The system detected a potential attempt to bypass the liveness check.
`LOW_FACE_MATCH_SIMILARITY`	The facial features of the provided image don't closely match the reference image, suggesting a potential identity mismatch.
`NO_REFERENCE_IMAGE`	A reference image for facial comparison is missing, preventing the system from completing the face matching process.
`FACE_IN_BLOCKLIST`	The face has been identified as matching an entry in your face blocklist. This occurs when the biometric data matches a previously blocklisted individual.

Warning Types

Each risk is assigned a warning type based on your application's configuration settings. Warnings fall into three severity categories:

Type	Description
ERROR	Critical issues that resulted in setting the session to 'Declined'
WARNING	Issues that require attention that resulted in setting the session to 'In Review'
INFORMATION	Informational messages that don't affect verification outcome