Skip to main content

FaceTec

FaceTec provides face enrollment and the 3D liveness checks used for face step-up authentication. Enrollment is required before saving a keyshare backup. A successful match scan is required for keyshare recovery and for registering a new device when the user already has a face enrolled.

Auth-svc uses the FaceTec v10 API. See the Biometrics API for the endpoints.

Get a device key

  1. Sign in at dev.facetec.com.
  2. On the Account page, copy your app's Device Key Identifier.
  3. Set it as FACETEC_DEVICE_KEY in your .env. The mobile app must use the same value.

Environment variables

VariableDescription
FACETEC_DEVICE_KEYDevice Key Identifier from the FaceTec dashboard
FACETEC_API_URLFaceTec API base URL. The Compose file uses the Test API.
FACETEC_SESSION_EXPIRY_SECONDSLifetime of an in-progress scan. A successful match receives a fresh validity window of the same length when it completes. Defaults to 300 seconds.