Configure FaceLock Elevated MFA in Microsoft Entra ID
Add FaceLock as an External Authentication Method, target the right users with Conditional Access, and validate phishing-resistant sign-in with live 3D face binding.
Who this guide is for
This guide is for Entra ID administrators (Global Administrator, Security Administrator, or Conditional Access Administrator) onboarding a client or reseller tenant to FaceLock Elevated MFA. Developers integrating ad-hoc verification APIs should use the Partner Portal developer docs instead.
Who configures what
Microsoft Entra External Authentication Methods use FaceLock as a shared OIDC MFA provider. Customer IT admins do not create a new Entra app registration, redirect URIs, or Certificates & secrets for this integration.
Your organization (Entra IT administrator)
- Add FaceLock via the OIDC discovery URL under External authentication methods.
- Enable the method for pilot users or groups and require it with Conditional Access.
- Optionally scope verified domains when Entra prompts during method setup.
- Do not create an app registration or client secret for External MFA — Microsoft federates to FaceLock's platform OIDC provider.
Your FaceLock partner (Admin Portal — Tenant MFA integration)
- Map your Entra directory GUID (tid) to your FaceLock tenant before go-live.
- Record the FaceLock External MFA client ID and issuer for support (values below).
- Mirror your verified-domain list when one Entra tenant serves multiple email domains.
- Provision enrollment codes or communicate Authenticator install steps before cutover.
FaceLock platform (not customer-facing)
- Operates the multitenant External MFA OIDC app registration, redirect URIs on mfa.facelock.live, and OIDC signing certificate in Azure Key Vault.
- Hosts discovery, /connect/authorize, and id_token signing for all federated Entra directories.
- Maintains a separate Entra Graph app registration (client ID + secret) only for internal self-serve enrollment tooling — not required for your External MFA rollout.
Prerequisites
- Microsoft Entra ID P1 or P2 (Conditional Access requires Entra ID P1 or Microsoft 365 Business Premium / E3 or higher).
- Entra admin role with permission to manage External authentication methods and Conditional Access policies.
- FaceLock tenant provisioned by your authorized partner (Reseller or platform onboarding complete).
- Users can install the FaceLock Authenticator mobile app (iOS / Android) for push-based enrollment and verification.
- Outbound HTTPS from user devices and from Microsoft federation endpoints to the FaceLock MFA service.
Step 1 — Confirm FaceLock MFA service availability
Before registering the method in Entra, confirm your environment's FaceLock MFA endpoint is reachable. The canonical FaceLock External MFA discovery URL (public OIDC metadata) is:
https://mfa.facelock.live/.well-known/openid-configuration
- Open https://mfa.facelock.live/.well-known/openid-configuration and verify issuer, authorization_endpoint, and jwks_uri are returned.
- Check https://mfa.facelock.live/health returns HTTP 200.
- Confirm your partner has mapped your Entra tenant ID (directory GUID) in the FaceLock Admin Portal MFA configuration.
Step 2 — Add FaceLock as an External Authentication Method
In the Microsoft Entra admin center, register FaceLock using OpenID Connect discovery (External Authentication Methods).
- Sign in to Microsoft Entra admin center → Protection → Authentication methods → Policies → Add external method (or External authentication methods).
- Choose Add method → External authentication method (OIDC-based).
- Display name: FaceLock Elevated MFA (or your organization's preferred label).
- Discovery URL: paste the FaceLock OIDC discovery URL provided by your partner (production example below).
- Save and enable the method for the target users or groups.
You only paste the discovery URL — Entra discovers authorization_endpoint, token behavior, and JWKS automatically. Redirect URIs and OIDC signing are configured on FaceLock's platform External MFA app registration, not in your tenant.
Step 3 — Scope the method to verified domains (if prompted)
When Entra asks which domains should use the external method, limit scope to the domains where you will roll out FaceLock (for example contoso.com). This is especially important for organizations with multiple verified domains. Your FaceLock partner can record the same domain list in the tenant MFA integration settings for routing and support.
Step 4 — Create or update a Conditional Access policy
External MFA methods only take effect when required by Conditional Access. Create a staged policy before broad rollout.
- Entra admin center → Protection → Conditional Access → New policy.
- Name: Require FaceLock Elevated MFA (pilot).
- Users: start with a pilot security group; exclude break-glass emergency accounts.
- Cloud apps: Microsoft Entra ID (or specific apps such as Office 365).
- Grant: Require authentication → select FaceLock / External authentication method (or add to an authentication strength that includes phishing-resistant methods).
- Enable policy: Report-only for initial validation, then On.
For regulated environments, align the policy with your authentication strength requirements (phishing-resistant MFA) and document break-glass account exclusions.
Step 5 — User enrollment and first sign-in
On first sign-in after the policy applies, Entra redirects the user to FaceLock for biometric enrollment (if not yet enrolled) or verification (if already enrolled).
- User signs in to Entra and is prompted for additional authentication.
- Entra federates to FaceLock; the user completes 3D liveness in the FaceLock Authenticator app (push) or browser flow as configured.
- FaceLock returns a signed id_token with amr:["face"] to Entra; sign-in completes if Conditional Access is satisfied.
- Verify the sign-in log shows the external method and MFA satisfaction.
Resellers can pre-provision users via the FaceLock Admin Portal (provision enrollment codes) so the first Entra sign-in routes directly to verification instead of enrollment.
Step 6 — Partner portal tenant mapping (your FaceLock partner)
Before production sign-in, your FaceLock partner saves a Tenant MFA integration in Admin Portal → Tenant → MFA Configuration. This links your Entra directory GUID to the correct FaceLock tenant for routing, billing, and support:
- Vendor: Microsoft Entra ID
- External directory ID: your Entra tenant GUID (tid) — required
- OIDC client ID: FaceLock External MFA application ID (6ec30e4d-87de-4bdd-bd6c-ecd3133ad1c8) — reference only; you do not register this app in your tenant
- Issuer URL: optional metadata (e.g. https://login.microsoftonline.com/{your-tid}/v2.0)
- Verified domains: one domain per line when one Entra tenant serves multiple domains
The Certificates & secrets entry used for self-serve ZeroProof enrollment tooling is a separate FaceLock-operated Graph app (User.Read.All) and is not part of your External MFA method setup.
Test and rollout checklist
- Pilot group: 5–10 users including one help-desk tester.
- Report-only Conditional Access: confirm sign-ins would have required FaceLock before enforcing.
- Enrollment path: confirm first-time users complete FaceLock Authenticator enrollment.
- Verification path: confirm returning users receive push and complete liveness.
- Sign-in logs: confirm MFA satisfied and method = FaceLock / external.
- Break-glass: confirm emergency accounts remain excluded and documented.
- Communications: send users install link for FaceLock Authenticator before cutover.
Troubleshooting
Method not offered at sign-in
Policy not targeting the user, method disabled, or user not in scope. Check Conditional Access report-only results and External authentication method enablement.
AADSTS5001256 (subject identifier mismatch)
Entra rejected the returned id_token subject. Contact FaceLock support with sign-in correlation ID; ensure tenant mapping uses the correct Entra tenant GUID.
User stuck on enrollment
Confirm Authenticator app installed, push notifications allowed, and user has network access to FaceLock MFA endpoints.
Discovery URL unreachable from Entra
Verify firewall/proxy allows Microsoft federation to FaceLock; confirm TLS certificate on mfa.facelock.live.
Reference values
OIDC discovery documents are public metadata by design (required for Entra External Authentication Methods). No secrets are published—only issuer, endpoints, and JWKS location. Your FaceLock partner confirms tenant mapping before go-live.
| Discovery URL | https://mfa.facelock.live/.well-known/openid-configuration |
|---|---|
| Health check | https://mfa.facelock.live/health |
| FaceLock MFA OIDC issuer | https://mfa.facelock.live |
| FaceLock External MFA client ID | 6ec30e4d-87de-4bdd-bd6c-ecd3133ad1c8 |
| Token claims | amr: ["face"], acr: inherence |
| Verified publisher | Envoc ✓ (blue verified badge on Entra consent screen) |
FaceLock Elevated MFA is published by Envoc, a Microsoft verified publisher. Customers will see the blue verified badge next to "Envoc" on the Entra consent screen.
Related documentation
Need help with your rollout?
Contact your FaceLock partner or request a security review for a tailored Entra implementation plan.