> ## 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.

# Entrust (Onfido)

> Run TruU IDV document and selfie proofing under your own Entrust (Onfido) account: API token, region (US, EU, CA), workflow ID, the health check, and what Entrust holds under your contract.

This page is for the admin who already has an Entrust (Onfido) identity verification contract and wants proofing to run under it. When you finish, the Proofing factor runs on your Entrust workflow and Entrust is your processor, not TruU's.

## About Entrust (Onfido)

Entrust Identity Verification (the former Onfido platform) performs document authenticity, facial similarity, and liveness checks through configurable workflows in Onfido Studio. Connecting your account lets TruU IDV start a workflow run for each proofing attempt and collect the result, while document images, selfies, and the applicant record stay in your Entrust account.

## What the connection enables

| Capability | What TruU reads | What TruU writes |
| - | - | - |
| Document and selfie proofing | Workflow run outcome, per-check results, extracted document fields, selfie | An applicant with the expected name, a workflow run on your workflow ID |
| Credential validation | Account reachability | Nothing |

TruU never reads other applicants or reports in your account, and never changes your workflows.

## Prerequisites

* An Entrust (Onfido) account with API access in one region and a published workflow in Onfido Studio that includes document and facial similarity (and liveness if you require it).
* Someone who can create an API token on the Entrust side.
* An IDV Console account with the Owner or Admin role.
* Outbound HTTPS from TruU to Entrust's API host for your region (TruU's side).

## Get your credentials

**1. Create an API token**

In the Entrust (Onfido) dashboard, go to **Settings → Developers → Tokens** and create a live token. Copy it; it is shown once. Use a dedicated token for TruU so it can be revoked independently.

**2. Note your region**

The region your account was created in: **US**, **EU**, or **CA**. A token works only against its region's API host.

**3. Copy the workflow ID**

In **Onfido Studio**, open the workflow you want TruU to run and copy its ID. The workflow must be published; drafts cannot be run.

Allow the workflow's input to be an applicant with first and last name only; TruU does not supply other applicant fields. If the workflow has a document country or type restriction, keep it consistent with your allowlists in TruU.

## Connect in TruU

Open **Factors → Proofing**, select **Entrust** as the provider, and enter:

| Field | Format | Notes |
| - | - | - |
| **API Token** | String beginning `api_live_` or `api_sandbox_` | Shown once by Entrust. Stored in a managed secrets service, never returned. A token only works in its own region (US, EU or CA), which TruU checks against the token |
| **Workflow ID** | UUID | The published Studio workflow |
| **Applicant retention** | **Leave to Entrust retention (recommended)** or **Delete after each verification** | Deleting the applicant also deletes that verification's documents and selfie in Entrust, which Entrust's Known Faces and Repeat Attempts checks rely on |
| **Verification link lifetime (minutes)** | Number | How long the Entrust capture link stays valid. Default 60; it can't be left blank |

Then set the common proofing settings described on [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md).

**Validated at save:** the token authenticates in the selected region and the workflow ID exists. **Not validated at save:** that the workflow's outputs include the checks you expect, or that your Entrust account has volume remaining.

## Verifying the connection

| Check | What it proves |
| - | - |
| Credential check | The token authenticates against the regional API host (daily, and on demand from Credential health) |

Results show on the factor configuration and in **Credential health**, at save, on demand, and in a daily sweep. Then run one test verification on your phone and confirm the run appears in your Entrust dashboard under the applicant with your name.

## How it works

**Session.** For each proofing attempt TruU creates an applicant (first and last name from your directory), starts a workflow run on your workflow ID, and embeds Entrust's capture UI in the verification page or hands it to the phone by QR. On completion TruU reads the run's outcome and the report outputs.

**What Entrust holds.** The applicant, the workflow run, the document images, the selfie or video, and the reports, all in your account under your contract and retention settings. TruU does not delete them; use Entrust's retention controls.

**What TruU holds.** The decision record (outcome, check results, extracted fields, raw response) in your write store or TruU managed storage, and the selfie as a face reference when **Proofing photo** is on. See [Data handling](https://docs.truu.ai/idv/security/data-handling.md).

**Certifications.** For Entrust's own security and compliance attestations, see Entrust's trust documentation. TruU does not restate them.

**Hosts.** TruU only ever calls Entrust's API host for your selected region. The user's browser loads the capture UI from Entrust's hosts.

**Secrets.** The API token is held in a managed secrets service. Rotate it by pasting a new token on the factor configuration; the superseded value is deleted. Changes are audited.

## Gotchas and troubleshooting

* **Credential check fails with an authentication error.** The token belongs to a different region than the one selected, or it is a sandbox token. Match the region to where the account lives.
* **Verifications fail to start.** The workflow is a draft, or the ID was copied from a different environment. Publish it in Studio and copy the ID from the published version.
* **Runs start but every one fails before capture.** The workflow's document restrictions exclude what users hold, or the workflow expects applicant fields TruU does not send (for example date of birth as a required input). Relax the workflow input requirements.
* **Desktop capture fails.** Use the phone handoff; see [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md).
* **Results are "needs review" more often than with the integrated provider.** Your workflow's thresholds decide this, not TruU. Tune them in Studio.
* **Token rotated in Entrust, not in TruU.** Proofing fails at session creation until the new token is pasted in. Credential health shows the failing check.
* **Not validated at save.** Workflow outputs, account volume, and retention settings in your Entrust account.

## Related pages

> [card] [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md)
>
> Common settings, name matching, and the decision record.

> [card] [Credential health](https://docs.truu.ai/idv/admin/credential-health.md)
>
> Where the checks above appear.

> [card] [Data handling](https://docs.truu.ai/idv/security/data-handling.md)
>
> What TruU stores versus what stays with your vendor.


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