How it Works
Privacy-First Digital Identity

Biometric
encryption,
without compliance
issues.

Help your organisation authenticate users with face ID, without storing faces or creating biometric databases, eliminating privacy risk, and meeting your compliance obligations.

The problem

The hidden cost of
storing biometrics.

Traditional biometric systems give you strong authentication, but only by collecting and retaining data that can never be reset if it leaks. That trade-off creates three problems every security and compliance team eventually has to answer for.

/01

Security risk

Biometric databases become high-value breach targets. A leaked face can never be changed, the exposure is permanent.

/02

Compliance burden

Sensitive biometric records increase governance obligations under GDPR, BIPA, CCPA and similar frameworks, more to classify, secure, disclose and delete.

/03

User trust

People are increasingly uncomfortable with permanent biometric storage, and slower to adopt services that demand it.

Facenition removes all three.

The solution

What makes Facenition
different.

FaceID, Okta, Microsoft, Entrust and traditional biometric platforms all rely on collecting or storing biometric data somewhere. Facenition is the only approach that delivers biometric-grade encryption while holding no biometrics at all.

Verifies identity using face recognition

Stores no biometric or face, ever

User-controlled identity tokens

Revocable, rotatable and expirable

Portable across organisations and vendors

Dramatically reduced privacy exposure

Biometric-grade assurance, with nothing for an attacker to steal.

How it works

Verify people.
Not biometric
databases.

Facenition fits into your existing identity flow and feels familiar to your users, while removing the liability you'd normally carry. Four steps, no biometric database.

/01

Enrol once

The user creates a privacy-preserving identity token from a face snapshot. The biometric itself is never stored.

/02

Store token only

Your organisation keeps a revocable identity token instead of biometrics. There's no biometric database to secure, govern or worry about.

/03

Verify instantly

On return, a live reading regenerates the token on the user's device and matches it against the one on file, fast, strong authentication with no stored biometrics.

/04

Revoke anytime

Tokens can be rotated, expired or revoked instantly, something a leaked biometric can never be.

Use cases

Stronger identity.
Less liability.

Wherever an organisation needs to confirm who someone is, and would rather not hold their biometrics to do it, Facenition fits cleanly into the flow.

/01

Government

Citizen identity and digital services, verify people with confidence while collecting far less sensitive data to secure and answer for.

/02

Healthcare

Accurate patient verification without ever building a biometric database of the people you care for.

/03

Financial services

Customer onboarding and fraud prevention with strong identity assurance and far less privacy risk on your balance sheet.

/04

Workforce & access

Physical and digital access control without enrolling employees into a biometric record you then have to protect.

Other applications include SaaS platforms, digital identity ecosystems, compliance and audit workflows, and cross-organisation verification.

The comparison

Why not traditional
biometrics?

Passwords are weak and resettable. Traditional biometric systems are strong but store data that can never be reset. Here's how Facenition compares on the criteria buyers use to justify the decision internally.

PasswordsTraditional biometric systemsFacenition
Stores biometric datan/aYes, indefinitelyNever
Breach liabilityResettablePermanent & irreversibleNothing to expose
Right to deletionStraightforwardComplex, biometrics persistNo biometric to delete
Biometric lifecycle managementn/aRequired & ongoingNone needed
Compliance burdenModerateHeavyMinimised
Cross-platform portability
User ownership of identity
Revocation capabilityReset
Vendor independencePartial
Privacy-first design
Identity under user control

Give people control
over their identity.

Most identity systems put the platform, or the government, in charge of who you are. Facenition flips that. Because identity tokens are generated on demand and never tied to a stored biometric, the person decides how their identity is created, separated, shared and switched off. This is the difference between being verified and being owned.

/01

Multiple tokens

People can generate as many identity tokens as they need, one per service, or one per purpose, all from the same person, none linkable back to a biometric.

/02

Separate identities

Keep identities for different organisations cleanly separated, so a token used with one vendor reveals nothing about activity with another.

/03

Token expiration

Set tokens to expire after a defined period, so access naturally winds down instead of lingering indefinitely.

/04

Token revocation

Revoke a token instantly, anywhere it's been issued, cutting off access without re-enrolment or touching a biometric.

/05

Vendor independence

Identity isn't trapped inside one provider. Tokens work across vendors and systems, so users are never locked in.

/06

User-controlled privacy

The person, not the platform, decides what their identity is used for. Privacy becomes a default, not a setting buried in a policy.

Integrations

Fits your existing
identity infrastructure.

Facenition is designed to slot into the systems you already run, so you can add privacy-first verification without rebuilding your identity stack.

SSO
Layer biometric assurance onto your single sign-on flows.
IAM
Strengthen identity and access management without storing biometrics.
CIAM
Privacy-first customer identity for onboarding and login.
Access control systems
Authenticate for physical and system access with revocable tokens.
Government identity platforms
Add verification to citizen and digital-service workflows.
Healthcare systems
Match returning patients without a biometric database.

Connecting a system we don't list yet? Integrations can be built to fit your environment, talk to our team.

Frequently asked

Plain answers to
honest questions.

Facial recognition systems capture and store biometric templates to identify people, often without their control. Facenition uses a biometric reading only to generate a privacy-preserving token on the user's device, the biometric is never stored, and the token can be revoked. You get the assurance of biometrics without holding the biometric.
Only a revocable identity token. There is no face or biometric record on file. Tokens cannot be reversed into a biometric, and the user controls how they are issued, separated and switched off.
There is no biometric data to lose. A breached store contains only identity tokens, which cannot be reversed into a face or a person. Unlike a leaked biometric, which can never be reset, a compromised token is simply revoked and reissued.
Facenition is designed to fit into your existing identity infrastructure, SSO, IAM, CIAM, access control, and government or healthcare identity platforms. Verification layers onto your current flows, so you can add privacy-first authentication without rebuilding your stack. Integrations can be tailored to your environment.
Yes. Tokens can be rotated, set to expire automatically, or revoked instantly anywhere they've been issued, cutting off access without re-enrolment and without ever touching a biometric.
Yes. A person can generate as many tokens as they need and split them across organisations. Each token verifies the same person, but they cannot be linked together or traced back to a stored biometric, so activity in one place stays separate from another.
By holding far less sensitive data. With no biometric stored, you reduce exposure and governance scope under frameworks such as GDPR, CCPA/CPRA and BIPA. Facenition supports privacy objectives through data minimisation and privacy-by-design, making audits, retention and reporting simpler.
Pricing

Simple pricing,
privacy included.

Start building in minutes and scale from a single project to a fully on-premises deployment. Every tier keeps biometrics off your servers, Facenition stores identity tokens, never faces.

Developer
$29/month
Up to 1,000 API calls / month

For developers and agencies who want to experience Facenition and integrate it into client projects.

  • 1,000 API calls per month
  • All identity, matching & analysis endpoints
  • Sandbox and production tokens
  • Documentation & community support
Start Now
Enterprise
$5,000/month
On-premises server license

A license to operate a Facenition API server on your own infrastructure, full control, no per-call limits.

  • Self-hosted, on-premises deployment
  • Unlimited calls within your environment
  • Dedicated onboarding & SLA
  • Air-gapped / private network support
Contact sales

Need something in between? On-premises and high-volume plans can be tailored, just reach out.

Ready to eliminate
biometric storage?

Deploy Biometric encryption without maintaining a biometric database. See it working, or talk to our team about where Facenition fits in your organisation.

Facenition · Whitepaper

Privacy-first identity, secured by the face

A conceptual overview of how Facenition combines face biometrics with strong cryptography to authenticate people and protect data, without building a biometric database. Written for security, privacy and product leaders.

Version 1.0 · Public overview · Contains no confidential implementation details
Section 01

Executive summary

Facenition is a privacy-first identity platform that lets organisations verify a person by their face and protect data on that basis, without storing faces or operating a biometric database. A live face is processed in the moment and combined with secrets the user controls to produce a compact, revocable identity token. That token, not the face, is what an organisation keeps.

The problem it solves. Authentication today still leans on passwords and shared secrets that are routinely phished, reused and stolen, while the biometric systems meant to replace them create permanent databases of data that can never be reset if leaked. Organisations are forced to choose between weak credentials and heavy biometric liability.

Why biometrics and encryption belong together. A face proves who is present; cryptography proves integrity and confidentiality. Used alone, a biometric is a liability to store and a password is trivial to steal. Bound together, a live face cryptographically tied to keys and tokens, you get authentication that is both hard to forge and safe to hold, because what persists is protected, scoped and reversible.

Key differentiators

No biometric database

Faces are processed transiently and discarded. Only non-reversible tokens are stored.

User-controlled identity

Tokens depend on inputs the user holds, so identity is not centrally owned.

Scoped & revocable

A token works only in the context it was made for and can be re-issued at will.

Cryptography-native

Standard, well-understood cryptographic primitives bind identity to data protection.

Business benefits

  • Lower breach liability, no irreplaceable biometric asset to steal.
  • Reduced compliance scope, less sensitive data held means a smaller governance and audit surface.
  • Stronger authentication, phishing-resistant, possession-light verification of a real person.
  • Better user experience, fast, passwordless verification with nothing to remember.
  • Faster integration, a simple API that drops into existing identity stacks.
Section 02

The identity problem

Digital identity is still anchored to secrets, passwords, one-time codes, knowledge questions, that are easy to lose and easy to steal. The result is a threat landscape where the front door, not the firewall, is the weakest point.

80%+
of breaches involve stolen, weak or reused credentials, according to widely reported industry research.
#1
phishing remains a leading initial-access vector for attackers year after year.
Billions
of leaked credentials circulate in breach corpuses, fuelling credential-stuffing at scale.

Where it breaks down

  • Password weaknesses. Reuse across sites, predictable patterns and human memory limits make passwords inherently fragile.
  • Credential theft. Phishing, malware and breach dumps turn one leaked secret into access across many services.
  • Account takeover. Stolen credentials and intercepted one-time codes let attackers impersonate legitimate users.
  • Synthetic & duplicate identities. Fabricated or recycled identities slip through onboarding that only checks documents, not the person.
  • User friction. Password resets, code prompts and lockouts frustrate users and drive abandonment and support cost.

The market has responded with more factors and more friction, but the underlying issue is unchanged: secrets can be copied, and the data we collect to verify people often becomes the next thing worth stealing. A durable answer has to verify the person while holding less, not more, sensitive data.

Figures above reflect directional trends consistently reported across public industry research; they are indicative rather than a single cited source.

Section 03

Vision & principles

Facenition is built on a small set of principles that shape every design decision. They position the platform around outcomes, privacy, control, assurance, rather than any particular mechanism.

Privacy by design

The most private system is one that never collects what it doesn't need. Faces are processed, not stored.

User-controlled identity

People should hold the keys to their own identity. Verification depends on inputs the user controls.

Strong cryptography

Identity and data protection rest on standard, peer-reviewed cryptographic practice, no security through obscurity.

Regulatory alignment

Data minimisation and clear consent are first-class, making privacy obligations easier to meet.

Zero-trust posture

Every verification is evaluated on its own merits; no implicit trust is granted by network or prior state.

Interoperability

Facenition augments existing identity stacks rather than replacing them, via a simple, standards-friendly API.

Section 04

Solution overview

At a conceptual level, Facenition turns a live face into protected access through a short, one-directional pipeline. Each stage hands a safer artifact to the next, and the original biometric never leaves the moment of capture.

User face
A live capture from camera or upload
Biometric processing
The face is read and reduced to a compact representation
Cryptographic binding
The representation is bound to user-controlled secrets and scope
Secure authentication
A fresh capture is checked against the stored token
Protected data access
Verified identity gates sessions, decisions and keys

Lifecycle

Enrollment

A user presents a live face once. Facenition combines it with the user-controlled inputs and scope to produce an identity token, which the relying application stores against the account. The face is discarded.

Verification

When the user returns, a fresh live capture is processed with the same inputs and compared to the stored token. A genuine match confirms the same person is present; the system tolerates the natural variation between captures while rejecting different people.

Authentication

A successful verification becomes an authentication signal your systems can act on, issuing a session, satisfying a second factor, or unlocking a protected resource. Facenition returns a simple decision (and optionally a confidence score) that slots into existing logic.

Recovery

Because tokens are revocable, recovery is straightforward: a user re-enrolls to produce a fresh, unrelated token, and the old one is retired. There is no permanent biometric secret to reset, the reset that traditional biometrics never had.

This is a conceptual description. The internal processing and binding mechanisms are intentionally not disclosed; the platform's guarantees do not depend on keeping them secret, only its competitive edge.
Section 05

Privacy architecture

For most stakeholders, privacy, not cryptographic detail, is the deciding factor. Facenition's architecture is designed so that the privacy story is simple to state and easy to defend.

No raw biometric storage

Facenition does not retain raw faces or build a central gallery of users. Captures are processed transiently and discarded. What persists is a token that contains no image and no reusable biometric.

Template protection

The compact representation derived from a face is protected before it ever becomes a stored artifact, and is bound to user-controlled inputs. A stored token is non-reversible: it cannot be turned back into a face, and on its own reveals nothing about a person's appearance.

Encryption of biometric-derived data

Any biometric-derived material is protected in transit and, where retained, at rest using standard encryption. Identity-bound keys can be used to encrypt the data a verification unlocks, so confidentiality follows the verified identity.

Data minimisation

The platform collects the minimum needed to perform a verification and keeps the minimum needed afterward, typically just a token. Less data held means less to govern, secure and disclose.

Consent management

Enrollment is an explicit, user-initiated act. Because tokens are scoped and user-controlled, consent maps cleanly to purpose: a user can enroll for one context without that decision extending to another.

Data lifecycle management

Tokens have a clear lifecycle, created at enrollment, used at verification, expired or revoked on demand, and replaced by re-enrollment. Deletion is meaningful because there is no shadow biometric copy to leave behind.

Section 06

Security model

Facenition is designed against a practical threat model. The table below maps common threats to the protections the architecture provides. Specifics such as thresholds, matching logic and anti-spoofing techniques are deliberately omitted.

ThreatHow Facenition mitigates it
Database breachNo biometric is stored; tokens are non-reversible and scoped, so a stolen store yields nothing that can be replayed or turned back into a face.
Replay attacksVerification requires a fresh, live capture each time; a captured static artifact does not satisfy a live check.
Stolen devicesA token alone cannot impersonate a user, verification still requires a live face and the matching user-controlled inputs, and can be combined with additional factors.
Insider threatsLeast-privilege access controls and scoped tokens limit what any single actor can obtain or reuse; there is no central biometric trove to abuse.
Credential theftFace verification reduces reliance on shared secrets that can be phished, reused or dumped, removing the attacker's favourite entry point.
Synthetic / duplicate identityQuality and liveness screening, plus same-person consistency checks, raise the bar against fabricated or recycled identities at onboarding.

The model assumes a capable adversary with access to leaked data and stolen devices, and is built so that compromising any single artifact, a token, a device, a database, does not by itself grant access. Defence-in-depth, not a single secret, is the goal.

Section 07

Cryptographic foundation

Facenition relies on well-established, industry-standard cryptography rather than novel or unpublished primitives. The security of the platform rests on the strength of these standards and on sound key management, not on secrecy of the algorithms.

  • Industry-standard primitives. Facenition leverages widely vetted authenticated encryption and hashing standards for confidentiality and integrity.
  • Secure key management. Keys are generated, used and retired following standard key-management practice, with separation between identity material and the data it protects.
  • Cryptographic binding. Identity is bound to keys and tokens so that access to protected data follows a successful, live verification rather than possession of a static secret.
  • Hardware-backed security where applicable. Where the deployment environment provides secure elements or trusted hardware, Facenition can take advantage of them to strengthen key protection.
Facenition uses standard cryptographic building blocks and secure key-management practices. This document intentionally does not describe how keys are derived or how identity is bound, those details are not required to evaluate the platform's guarantees.
Section 08

Compliance & governance

By holding far less sensitive data, organisations using Facenition can reduce the scope and burden of their compliance programmes. Facenition is designed to align with the requirements below; alignment describes design intent and supports an organisation's own compliance, and is distinct from formal certification.

FrameworkHow Facenition helps
GDPRSupports data minimisation and privacy-by-design, simpler lawful-basis and consent handling, and easier data-subject requests because there is no stored biometric to disclose or erase.
SOC 2Architecture aligns with the security, availability and confidentiality trust-service criteria; reduced data holdings simplify controls and evidence.
ISO 27001Fits an information-security management system through clear data classification, minimisation and lifecycle controls.
Regional privacy lawsHelps address CCPA/CPRA, BIPA and similar biometric-privacy regimes by avoiding the collection and retention of identifiable biometric records.

Governance is strengthened by the same property that drives the privacy story: when the most sensitive data is never collected, retention, access and breach-notification obligations all shrink. This document describes alignment and design intent; specific certifications are pursued as part of the roadmap and stated explicitly only once achieved.

Section 09

Use cases

Facenition fits anywhere an organisation needs to prove a real person is present, and it does so while reducing, not increasing, the sensitive data held.

Enterprise login

Passwordless, phishing-resistant sign-in for web and internal applications, replacing or strengthening passwords with a live face check.

Workforce authentication

Strong second-factor or step-up verification for employees and contractors, and face-gated entry for physical access points.

Financial services

High-assurance verification for account access, payment approval and high-risk actions, with a confidence score for risk-tiering.

Healthcare access

Verify clinicians and patients at the point of care without building a biometric record of a sensitive population.

Customer onboarding

Match a live selfie to a document portrait during KYC, with quality and liveness screening to cut failed and fraudulent sign-ups.

Data protection

Bind decryption of sensitive files or records to a live, verified face so confidentiality follows identity.

Section 10

Roadmap

Facenition's direction is to broaden reach and deepen enterprise fit while holding the privacy-first line. The roadmap below is indicative and high-level.

  • Platform expansion

    Broader platform & regions

    Wider availability, additional language and SDK coverage, and expanded deployment options including on-premises.

  • Mobile

    Native mobile capabilities

    First-class mobile capture and on-device support to bring face verification natively into apps.

  • Authentication

    Additional factors

    Complementary factors and step-up options that combine cleanly with face verification for higher-assurance flows.

  • Enterprise

    Deeper integrations

    Turn-key connectors for major identity providers and enterprise directories, plus richer policy controls.

  • Assurance

    Certifications & audits

    Pursuit of formal third-party attestations to complement the platform's privacy-by-design foundation.

This whitepaper is a public overview intended for evaluation. It describes Facenition's properties, principles and intended compliance alignment at a conceptual level and deliberately omits proprietary implementation details. It is not legal advice; compliance outcomes depend on how the platform is deployed and operated.

Developers

Build with Facenition

Everything you need to integrate privacy-first face verification: the REST API reference, identity-provider integration guides, and reference architectures for the most common scenarios.

Overview

All requests are POST. The base URL is https://api.facenition.com; each endpoint is reached at https://api.facenition.com/<endpoint>.

Authentication

Every endpoint except /generateToken and /token requires a client token. Send it in the X-Auth-Token request header (it may also be supplied as an auth_token form field). Keep this token on your server, never ship it to a browser or mobile client.

Sending images

Image fields accept a file upload via multipart/form-data (recommended). To send several images, repeat the same field name once per image. Image fields also accept a base64-encoded string in an application/json body.

Accuracy

Several endpoints take an accuracy parameter, an integer from 1 to 8 (default 4) controlling matching tolerance. For verification, use the same accuracy at /generate and /authenticate.

Errors

On failure a response returns { "ok": false, "error": "<message>" } with an HTTP status, 400 bad request, 401 unauthorized, 404 not found, or 502 upstream error.

Integration model

Facenition is a server-to-server API. In every integration the pattern is the same: your client captures a face, your backend (or your identity provider's hook) forwards it to Facenition with your client token, and Facenition returns a token, a boolean, or a score. The client token never touches the browser.

Golden rule: capture on the client, call Facenition from the server. Store the returned identity token next to the user record in your own database; store no images.

The two calls you'll use most

# 1) Enrolment, create an identity token (store the token, discard the photo)
curl -X POST https://api.facenition.com/generate \
  -H "X-Auth-Token: $FACENITION_TOKEN" \
  -F "photo=@enroll.jpg" \
  -F "password=$USER_SECRET" \
  -F "scope=app:login" \
  -F "accuracy=4"
# -> { "ok": true, "token": "a1b2...", ... }

# 2) Verification, check a live face against the stored token
curl -X POST https://api.facenition.com/authenticate \
  -H "X-Auth-Token: $FACENITION_TOKEN" \
  -F "token=$STORED_TOKEN" \
  -F "photo=@probe.jpg" \
  -F "password=$USER_SECRET" \
  -F "scope=app:login" \
  -F "accuracy=4"
# -> { "ok": true, "authenticated": true }

Okta, face as a step-up factor

Use Okta to handle primary authentication and call Facenition as a custom step-up check during sign-in. The cleanest hook points are an Okta Inline Hook (token or registration) or an Okta Workflow.

1
Enrol at registration. When a user is created, capture a face in your enrolment UI, call /generate from your backend, and write the returned token to a custom Okta profile attribute (e.g. facenitionToken) via the Users API.
2
Add an Inline Hook. In Workflow → Inline Hooks, register a Token Inline Hook pointing at your HTTPS endpoint. Okta calls it during the sign-in pipeline.
3
Verify in the hook. Your endpoint receives the user context, reads facenitionToken, takes the live capture your front-end collected, and calls /authenticate. Return a command that allows or denies the transaction.
// Okta Inline Hook endpoint (Node/Express, server-side)
app.post("/okta/facenition-hook", async (req, res) => {
  const claims = req.body.data.context.user.profile;
  const form = new FormData();
  form.append("token",    claims.facenitionToken);
  form.append("photo",    req.liveCapture, "probe.jpg"); // collected by your UI
  form.append("password", await secretFor(claims.login));
  form.append("scope",    "okta:login");
  form.append("accuracy", "4");

  const r = await fetch("https://api.facenition.com/authenticate", {
    method: "POST",
    headers: { "X-Auth-Token": process.env.FACENITION_TOKEN },
    body: form
  }).then(x => x.json());

  res.json(r.authenticated
    ? { commands: [{ type: "com.okta.action.update", value: { credential: "VERIFIED" } }] }
    : { error: { errorSummary: "Face verification failed" } });
});

Microsoft Entra ID (Azure AD) & IAM

Entra ID exposes custom authentication extensions and Conditional Access. Register an HTTPS extension that fires at sign-in, perform the same /authenticate call from that endpoint, and return a continue/block decision. For AWS IAM environments using Amazon Cognito, wire Facenition into the custom-auth Lambda triggers:

# Cognito custom auth flow (IAM)
DefineAuthChallenge   -> issue a CUSTOM_CHALLENGE ("present your face")
CreateAuthChallenge   -> nothing secret needed; the token lives in your store
VerifyAuthChallenge   -> POST the live capture + stored token to
                         https://api.facenition.com/authenticate
                         set  answerCorrect = response.authenticated
The pattern generalises to any IdP that supports an outbound webhook or custom factor (ForgeRock auth trees, Ping DaVinci flows, Keycloak SPIs): the IdP owns the session, Facenition owns the face decision.

OneLogin

Use a OneLogin Smart Hook (pre-authentication or user-migration). The hook runs your JavaScript on OneLogin's side; have it call your thin verification service (which holds the client token) and resolve { success: true|false } based on the /authenticate result. Store the per-user token in a OneLogin custom user field at enrolment.

Generic OIDC / SAML

If you operate your own IdP, model Facenition as one node in the authentication journey: password → Facenition face check → issue assertion. The IdP collects the capture, your backend calls /authenticate, and the node passes or fails. Because Facenition returns a simple boolean (or a score via /authenticate-score), it slots into existing decision logic with minimal glue.

Reference architecture

Facenition sits behind your application as a stateless verification service. Your systems own identities, sessions and the token store; Facenition turns a face into a token or a yes/no. Nothing about a user's appearance is persisted by either side.

Client
Capture (camera / upload)
Your backend
Verification service
(holds client token)
Facenition
API · tokenise / match
Your DB
User record + identity token
Your backend
Decision & session
Never stored
Face image / template
Faces live only in transit · only tokens are persisted

Components

  • Capture client, web or mobile UI that records a frame. Sends it to your backend, not to Facenition directly.
  • Verification service, a thin server component that holds the client token and proxies calls to Facenition. The only place the token lives.
  • Token store, your existing user database, with one extra column for the Facenition identity token.
  • Facenition API, stateless endpoints for enrolment (/generate), verification (/authenticate, /authenticate-score), matching (/match, /match-bulk, /consistency-check) and screening (/quality, /detect, /liveness).

Scenario blueprints

Passwordless login

Enrol: capture → /generate (scope app:login) → store token on the user. Sign in: capture → /authenticate with the stored token → on true, issue a session.

Two-factor (2FA)

Run your existing password step first. Then capture a face and call /authenticate as the second factor. Only mint the session when both the password and the face check pass, face becomes a possession-free "something you are" factor.

Access control (1:N at a door)

Enrol each authorised person with /generate and keep their tokens in a roster. At the door, capture once and evaluate against the roster, call /authenticate per enrolled token (or use /match-bulk against reference captures). Grant on the first match; otherwise deny.

ID verification / KYC (1:1)

Enrol the document portrait with /generate, then verify the live selfie with /authenticate-score to obtain a match decision plus a similarity score and threshold, useful for risk-tiering onboarding decisions. Pre-screen the selfie with /quality and /liveness to cut failed onboardings.

Data encryption (face-sealed files)

Derive a content key in your client from the user's passphrase bound to their identity token, and encrypt locally (e.g. AES-GCM). To decrypt, require a fresh /authenticate pass before the key is reassembled, the face gates release of the key, and Facenition never sees the file.

Watchlist / directory identify

Hold one reference per known identity. Given a probe face, call /match-bulk against the set to flag matches, or /consistency-check to confirm a group of images is the same person (e.g. de-duplicating accounts).

Operational notes

  • Idempotent & stateless, calls carry everything they need; you can scale the verification service horizontally.
  • Keep the same inputs, the scope, expiry and accuracy used to verify must match those used to enrol.
  • Store tokens, not faces, your only new persisted field is the identity token. Treat it as you would any credential reference.
  • On-premises, the Enterprise license runs the same API inside your own network for air-gapped or data-residency requirements.