Authentication (v1)
BIOMETRIC_VERIFICATION:v2 introduces a unified Verification datablock but its implementation is not yet finalized. Use BIOMETRIC_VERIFICATION:v1 for all production flows.
Authenticates identity using facial recognition
Used when strong, real‑time identity confirmation is required. The user completes a quick face scan, and the system ensures they are a real person and match the enrolled face, helping prevent impersonation, spoofing, and deepfakes.
Key features
- Liveness detection: Confirms the user is physically present and not a spoof or replay attack.
- Face comparison: Matches the live capture against the enrolled biometric template.
- Evidence preservation: On success, the Keyless transaction JWT is stored in the vault and referenced in the
AuthenticationResultdatablock for audit purposes.
This step requires previous enrollment via the Biometric Enrollment step and uses the captured biometric data to authenticate the user.
Configuration
This step requires no configuration options. It uses the Third Party configuration parameters defined on the infrastructure level.
Input data blocks
| Data block | Mandatory | Description |
|---|---|---|
UserReference | Yes | Contains the unique subject identifier (subjectId) necessary to identify the user in the Keyless system. |
Routes
| Route | Description |
|---|---|
authenticated | Biometric authentication succeeded. The user has been successfully authenticated. |
failed | Biometric authentication failed. This can be due to biometric mismatch, capture error, or technical issue. |
Output data blocks
| Route | Data blocks produced | Description |
|---|---|---|
| authenticated | AuthenticationResult | Biometric authentication succeeded. The user has been successfully authenticated. |
| failed | AuthenticationResult | Biometric authentication failed. This can be due to biometric mismatch, capture error, or technical issue. |
The AuthenticationResult datablock is a discriminated union with a result field containing either success or failure details. Refer to the datablocks reference for the full structure.