> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Verified device enrollment

> Verify that the person enrolling a Windows or Mac device with TruU Passwordless is the employee they claim to be, before any credential is created.

This page is for the identity admin or desktop engineer putting identity verification in front of TruU Passwordless enrollment, typically for new hires and device re-enrollment. When you finish, enrollment on Windows and macOS pauses for a verification, and no credential is created for someone who fails it.

## How it works

1. An employee starts TruU Passwordless enrollment on their Windows PC or Mac.
2. If the Passwordless registration policy requires identity verification, the enrollment agent shows the TruU IDV verification inside its own window, styled to match the operating system.
3. Steps that need a camera, such as a face match or an ID document check, hand off to the employee's phone with a QR code. The computer waits and continues on its own when the phone finishes.
4. When the verification passes, enrollment continues to credential creation. If it fails, the employee sees why and can try again; no credential is created.

## Before you start

* TruU Passwordless enrollment working on Windows or macOS without verification.
* A TruU IDV workspace connected to the same Entra ID directory. The [one-click setup from TruU Passwordless](https://docs.truu.ai/idv/connect/passwordless.md#one-click-setup-from-truu-passwordless) creates the workspace and shares the directory for you.
* Employees have a phone with a camera for the face and ID steps.
* Devices can reach `agent.truu.ai` on port 443, and phones can reach the hosts in [Network requirements](https://docs.truu.ai/idv/security/network.md).

## Set it up

**1. Connect TruU Passwordless**

Follow [TruU Passwordless](https://docs.truu.ai/idv/connect/passwordless.md). One-click setup also creates a flow named **Passwordless Enrollment**.

**2. Check the enrollment flow**

Open **Flows → Passwordless Enrollment**. Each column is tried in order, and an employee only gets a column whose factors work for them:

| Column | Factors | Who it serves |
| - | - | - |
| A | Face | Employees with a reference photo on file |
| B | ID + selfie (Proofing) | New hires with no photo yet. With face-on-file deposit turned on, the verified selfie becomes their reference photo for next time. |
| C | Knowledge + SMS | A last resort when no proofing vendor is connected |

Adjust it like any other flow. See [Flows and templates](https://docs.truu.ai/idv/build/flows.md).

**3. Require verification in TruU Passwordless**

In the TruU Passwordless admin console, open the registration policy that governs desktop enrollment and select the IDV flow (for example **Passwordless Enrollment**). Start with a registration policy scoped to a pilot group, then widen it.

## What the employee sees

### Windows

The verification appears inside the Windows enrollment agent.

![Windows-styled screen titled Verify your identity, explaining that Contoso requires verification to complete setup, with a Begin button](https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/enroll-win-intro-light.png?fit=max\&auto=format\&n=ggexkQvmOZdl3yHs\&q=85\&s=5f838c52c312216cdfeb4285c5918743)

The verification inside the Windows enrollment agent.

Camera steps hand off to the phone. The employee scans the code, completes the step on their phone, and leaves the window open; the computer continues by itself. **Try another way** moves to the next column of the flow when the phone step isn't possible.

![Windows-styled screen titled Verify your face on your phone, with Scan and Selfie steps, a QR code and Keep this window open](https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/enroll-win-face-handoff-light.png?fit=max\&auto=format\&n=ggexkQvmOZdl3yHs\&q=85\&s=b589a957bf01d0d30f50b4b0e034c42c)

The face step hands off to the employee's phone.

### macOS

The same verification appears inside the TruU app on the Mac, styled for macOS, with the same phone handoff for camera steps.

![macOS-styled screen titled Verify Your Identity with a Begin button](https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/enroll-mac-intro-light.png?fit=max\&auto=format\&n=ggexkQvmOZdl3yHs\&q=85\&s=fce12f89f4108188fef7f6bf97dde7b6)

The verification inside the macOS enrollment app.

On the phone, the employee sees the standard verification page. See [What to expect](https://docs.truu.ai/idv/end-users/what-to-expect.md).

## What to tell employees

* Have your phone unlocked and nearby before you start.
* When the computer shows a square code, point your phone camera at it and open the link.
* The page that opens shows your company's name and never asks for a password.
* Leave the computer window open. It continues by itself when your phone says you're verified.
* If you have no photo on file yet, have a government ID with you.

## Test it

Enroll a test device on each platform with a pilot user. Each enrollment should produce a verified request in **Activity**, showing the flow and column used. Also test a user with no reference photo, who should complete enrollment through the ID + selfie column.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| The phone shows success but the computer doesn't continue | The device can't reach `agent.truu.ai`, or the Passwordless connection is stale | Check the device's network egress; run **Test connection** on the [TruU Passwordless](https://docs.truu.ai/idv/connect/passwordless.md) connector |
| The QR code won't scan | Screen scaling or glare | Use the phone's built-in camera app and move closer |
| No face step for a new hire | No reference photo on file | Keep the ID + selfie column in the flow |
| Face match fails for a long-tenured employee | The directory photo is old or very small | Turn on face-on-file deposit from proofing, or refresh the directory photo. See [Face](https://docs.truu.ai/idv/factors/face.md). |
| Nobody can enroll after a change | The registration policy points at a flow that was deleted | Select an existing flow in the registration policy |
| New enrollments are blocked after disconnecting | Registration policies that require IDV fail closed without a connection | Reconnect TruU IDV, or remove identity verification from those registration policies |

## Related

* [TruU Passwordless connector](https://docs.truu.ai/idv/connect/passwordless.md)
* [Flows and templates](https://docs.truu.ai/idv/build/flows.md)
* [What to expect](https://docs.truu.ai/idv/end-users/what-to-expect.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.