Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.
This page is for the admin or help desk lead with a stuck verification in front of them. When you finish, you have the likely cause and the fix, or the request ID and event IDs support will ask for.Most problems trace back to a small set of causes: directory data quality, link delivery, camera access on desktops, or use case rule order.
Directory connection
Symptom
Likely cause
Fix
Validation fails right after running the setup script
The app registration is still propagating, or admin consent has not been granted yet
Wait a minute and retry validation; it succeeds once propagation completes. Confirm consent was granted in the correct tenant and that tenant ID, client ID, and client secret were copied exactly.
Admin consent button is greyed out or fails
The person running setup is not a Global, Application, or Cloud Application Administrator
Have a second person with one of those roles grant consent. The connection can be saved first and validated after.
Connection worked, then stopped
Expired or rotated client secret
Create a new secret on the app registration and update it under Settings → Directory. Watch Settings → Credential health for expiry warnings.
Groups missing from the rule picker
The group catalog refreshes on a schedule; a group created minutes ago may not be listed yet
Wait and reopen the picker, or search by name. Membership itself is looked up live at verification time, so a user added to an existing group is matched immediately.
Links are short-lived by design: 30 minutes for Helpdesk, 1 hour for Credential reset, 7 days for Onboarding. Have the agent send a fresh link from the help desk app; requesting a link for the same person and use case while one is still active reuses it and resets its expiry rather than creating a duplicate. If links routinely expire before users open them, check the delivery channel and whether the agent is sending the link before the caller is ready to act on it.
User sees 'Already open on another device or browser'
Where exclusive sessions are enabled for your workspace, each link is held by the first browser that opens it. This blocks link forwarding, but it also fires when a user opens the link on a laptop and then switches to a phone. Have the user close the page on the first device, wait about a minute, and reload the link. If the first device is unavailable, send a new link. The QR handoff on the verification page moves to a phone without triggering this, so prefer it over opening the link twice.
Link never arrives
Check the request’s timeline for a link delivered event versus a delivery failed event. For SMS, the most common cause is a directory phone number that is not in E.164 format. For email, check the recipient’s spam folder and confirm your email security gateway is not quarantining the message. Email delivery is occasionally delayed by a minute or two; the resend works and refreshes the same link.
User opened the link but the request shows as not started
The user may have opened the link in an in-app browser or a preview pane that pre-fetched the page. Ask them to open the link directly in the device’s browser. Confirm on the request timeline whether a started event exists.
Camera: desktop webcams and phone handoff
This is the most common source of failed Face and Proofing steps. Desktop webcams frequently fail capture: the page loops on “move closer” and “move further”, or the camera never starts because the browser window is narrow enough to render the mobile layout. Phone QR handoff succeeds where the webcam does not.
Recommend the phone by default. Brief agents to tell callers “scan the QR code with your phone” rather than “use your laptop camera”. The handoff keeps the same request and link.
Symptom
Likely cause
Fix
”Move closer” and “move further” loop on a laptop
Low-resolution or wide-angle webcam, poor lighting, or the user is too far from the screen
Hand off to the phone with the QR code. If the desktop is the only option, bring the face to about arm’s length in even front light.
Camera never starts on desktop
The browser window is narrow and the page rendered as mobile, or camera permission was denied earlier
Maximize the window and reload, or allow camera access in site settings. Or hand off to the phone.
Camera prompt never appears
Camera permission previously denied for the site, or an endpoint management setting blocks it
Allow camera access for verify.truu.ai in browser site settings and reload. On managed devices where MDM blocks the camera, use the phone handoff.
Nothing happens on the Windows lock screen
Camera permission is not available on the lock screen
Phone handoff is the path there; the QR code is shown on the lock screen page. See Windows agent enrollment.
Black screen where the preview should be
Another app holds the camera, or an in-app browser without camera support
Close other camera apps; open the link in Safari on iOS or Chrome on Android rather than an embedded webview.
Camera starts, then the Face or Proofing step fails before capture on a corporate laptop
SSL inspection on the corporate proxy is breaking the liveness stream or the vendor SDK
Allowlist the hosts on Network requirements, or hand off to a phone off the corporate network.
Document capture repeatedly rejected
Glare, poor lighting, or the document outside the frame guide
Place the document on a dark non-reflective surface in even light and align it with the guide.
Factor failures
SMS codes fail or never arrive for many users
Phone number formatting and coverage. SMS delivery requires E.164 (+15551234567); values like 555-123-4567 are rejected. SMS coverage is often far lower than email coverage, and many organizations restrict SMS. Check coverage of the mobile attribute in Settings → Directory before relying on the SMS factor, normalize numbers in the directory, and prefer Email in the primary column.
Email codes delayed or in spam
Email codes are occasionally delayed; the resend works. If delivery problems are widespread, confirm your email security gateway allows the sending domain and check quarantine. Contact support to confirm sender authentication for your workspace.
User cannot resend a one-time code
Resends are limited and a cooldown is shown on the button. This is expected, not a delivery fault. Have the user wait out the countdown; if they exhaust the resend budget, the flow falls back to the next column or the agent sends a fresh link.
Face is unavailable or fails for specific users
The Face factor needs a reference photo. Users with none are routed to a fallback column. Two data-quality problems are common: directory photos are often stale (years old) or tiny (thumbnailPhoto at roughly 96 pixels), and both lower match scores. A photo deposited from a passed Proofing check matches far better. Configure the Face factor’s reference sources so proofing-derived photos take precedence, and put Proofing in a fallback column so users without a usable photo create one. Check photo coverage under Settings → Directory.
Knowledge questions fail for legitimate users
The attribute behind the question is empty or inconsistent. department in particular is often blank or formatted differently across business units, and many organizations keep the real org data in extension attributes. Check coverage and sample values in attribute mapping before enabling an attribute as a question source, map the extension attribute that actually holds the data, and disable attributes with poor coverage. See Attribute mapping and coverage.
Document proofing fails repeatedly
Read the factor outcome reason on the request timeline. Common causes are capture quality, an unsupported or damaged document, a name that does not match the directory record, or a liveness failure. Have the user retry on a phone in better light. If failures persist for a legitimate user, follow your escalation procedure rather than creating repeated new links.
ServiceNow connector
Symptom
Likely cause
Fix
Verify Identity stopped working after an app upgrade
Upgrading the app clears its stored credentials
Generate a new connect link in Settings → Connectors → ServiceNow and connect again.
Test connection fails
Your instance is unreachable, the app is disabled, its credentials were cleared, or the app’s OAuth client or integration user was deactivated
Confirm the instance is up and the app is enabled, then reconnect.
Connect says the instance refused an OAuth client-credentials token
ServiceNow turns the client-credentials grant off by default
Turn it on from the Connect page (one time per instance), then select Connect again. See ServiceNow.
Work notes stop appearing
Your instance was unreachable when the event was sent
Events are still on the request timeline and in the audit trail. Run Test connection, check instance availability, and re-run the verification if needed.
Cannot add a store because your cloud team will not issue a bucket or credentials
Common; cloud teams often restrict new accounts
Use TruU managed storage for now. You can connect your own store later. See Storage.
Store shows Idle
No writes have reached it yet
Run a Proofing check end to end. The badge turns Live on the first write.
Test connection fails
Wrong region or bucket name, or a credential without the access you selected
Check the credential’s permissions on the bucket, then run Test connection again before Connect.
Wrong flow for someone
Symptom
Likely cause
Fix
A person gets the wrong flow
Rules are checked top to bottom and the first match wins; a broader rule above the intended one matches first
In Use Cases, move the more specific rule above the general one.
A group rule never matches
The person isn’t in the group, or the rule targets a similarly named group
Confirm membership in your directory; lookup is live, so there’s no sync to wait for. Re-select the group in the rule.
The Catch All Flow runs instead of the flow you expected
The request was for a different use case, or no rule above Everyone else matches the person
Check which use case the request used in Activity, then that use case’s rules.
Flow changes don’t take effect
The flow wasn’t saved
Open the flow and choose Save flow.
Still stuck?
Activity in the IDV Console is the fastest diagnostic tool: filter to the affected request or user and read the reason codes. See Audit events. When you contact support, include the request ID and the relevant event IDs.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TruU Docs","colors":{"primary":"#101010","light":"#faa536","dark":"#faa536"},"logo":{"light":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a","dark":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229931.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=0bfe1c1c8b293387d07ea4145aa57b74"},"favicon":"https://mintcdn.com/truu-2/29VTyTZfF-4PId_r/d332cdf-learn-more.svg?fit=max\u0026auto=format\u0026n=29VTyTZfF-4PId_r\u0026q=85\u0026s=24c4a71a0ed524868233103635f73373","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://www.truu.ai/","label":"TruU Website"},{"href":"https://www.truu.ai/contact","label":"Support"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/truu-security","website":"https://www.truu.ai/"}},"fonts":{"family":"Inter"},"interaction":{"drilldown":true},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"truu-2","hasAudioNarration":false,"actualSubdomain":"truu-2","customDomains":["docs.truu.ai"],"gitSource":{"type":"github","owner":"truudocs","repo":"mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b008a37dfdc371b948ae3fc","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Passwordless","count":302},{"language":"default","tag":"Setup","count":132},{"language":"default","tag":"Release Notes","count":93},{"language":"default","tag":"User Guides","count":74},{"language":"default","tag":"Platform","count":70},{"language":"default","tag":"TOTAL","count":69},{"language":"default","tag":"Identity Verification","count":63},{"language":"default","tag":"Guides","count":52},{"language":"default","tag":"FAQ","count":40},{"language":"default","tag":"FAQ: Knowledge Base","count":40}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"sa@truu.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"idv/resources/troubleshooting","slug":"/idv/resources/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.","icon":"wrench","href":"/idv/resources/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Heading,Table,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This page is for the admin or help desk lead with a stuck verification in front of them. When you finish, you have the likely cause and the fix, or the request ID and event IDs support will ask for.`}),`\n`,_jsx(_components.p,{children:`Most problems trace back to a small set of causes: directory data quality, link delivery, camera access on desktops, or use case rule order.`}),`\n`,_jsx(Heading,{level:`2`,id:`directory-connection`,children:`Directory connection`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Validation fails right after running the setup script`}),_jsx(_components.td,{children:`The app registration is still propagating, or admin consent has not been granted yet`}),_jsx(_components.td,{children:`Wait a minute and retry validation; it succeeds once propagation completes. Confirm consent was granted in the correct tenant and that tenant ID, client ID, and client secret were copied exactly.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Admin consent button is greyed out or fails`}),_jsx(_components.td,{children:`The person running setup is not a Global, Application, or Cloud Application Administrator`}),_jsx(_components.td,{children:`Have a second person with one of those roles grant consent. The connection can be saved first and validated after.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Connection worked, then stopped`}),_jsx(_components.td,{children:`Expired or rotated client secret`}),_jsxs(_components.td,{children:[`Create a new secret on the app registration and update it under `,_jsx(_components.strong,{children:`Settings → Directory`}),`. Watch `,_jsx(_components.strong,{children:`Settings → Credential health`}),` for expiry warnings.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Groups missing from the rule picker`}),_jsx(_components.td,{children:`The group catalog refreshes on a schedule; a group created minutes ago may not be listed yet`}),_jsx(_components.td,{children:`Wait and reopen the picker, or search by name. Membership itself is looked up live at verification time, so a user added to an existing group is matched immediately.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/idv/connect/directory/entra-id`,children:`Microsoft Entra ID`}),` for the full setup.`]}),`\n`,_jsx(Heading,{level:`2`,id:`verification-links`,children:`Verification links`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`User reports the verification link is expired`,id:`user-reports-the-verification-link-is-expired`,children:_jsx(_components.p,{children:`Links are short-lived by design: 30 minutes for Helpdesk, 1 hour for Credential reset, 7 days for Onboarding. Have the agent send a fresh link from the help desk app; requesting a link for the same person and use case while one is still active reuses it and resets its expiry rather than creating a duplicate. If links routinely expire before users open them, check the delivery channel and whether the agent is sending the link before the caller is ready to act on it.`})}),_jsx(Accordion,{title:`User sees 'Already open on another device or browser'`,id:`user-sees-already-open-on-another-device-or-browser`,children:_jsx(_components.p,{children:`Where exclusive sessions are enabled for your workspace, each link is held by the first browser that opens it. This blocks link forwarding, but it also fires when a user opens the link on a laptop and then switches to a phone. Have the user close the page on the first device, wait about a minute, and reload the link. If the first device is unavailable, send a new link. The QR handoff on the verification page moves to a phone without triggering this, so prefer it over opening the link twice.`})}),_jsx(Accordion,{title:`Link never arrives`,id:`link-never-arrives`,children:_jsx(_components.p,{children:`Check the request’s timeline for a link delivered event versus a delivery failed event. For SMS, the most common cause is a directory phone number that is not in E.164 format. For email, check the recipient’s spam folder and confirm your email security gateway is not quarantining the message. Email delivery is occasionally delayed by a minute or two; the resend works and refreshes the same link.`})}),_jsx(Accordion,{title:`User opened the link but the request shows as not started`,id:`user-opened-the-link-but-the-request-shows-as-not-started`,children:_jsx(_components.p,{children:`The user may have opened the link in an in-app browser or a preview pane that pre-fetched the page. Ask them to open the link directly in the device’s browser. Confirm on the request timeline whether a started event exists.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`camera-desktop-webcams-and-phone-handoff`,children:`Camera: desktop webcams and phone handoff`}),`\n`,_jsx(_components.p,{children:`This is the most common source of failed Face and Proofing steps. Desktop webcams frequently fail capture: the page loops on “move closer” and “move further”, or the camera never starts because the browser window is narrow enough to render the mobile layout. Phone QR handoff succeeds where the webcam does not.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Recommend the phone by default. Brief agents to tell callers “scan the QR code with your phone” rather than “use your laptop camera”. The handoff keeps the same request and link.`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`”Move closer” and “move further” loop on a laptop`}),_jsx(_components.td,{children:`Low-resolution or wide-angle webcam, poor lighting, or the user is too far from the screen`}),_jsx(_components.td,{children:`Hand off to the phone with the QR code. If the desktop is the only option, bring the face to about arm’s length in even front light.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Camera never starts on desktop`}),_jsx(_components.td,{children:`The browser window is narrow and the page rendered as mobile, or camera permission was denied earlier`}),_jsx(_components.td,{children:`Maximize the window and reload, or allow camera access in site settings. Or hand off to the phone.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Camera prompt never appears`}),_jsx(_components.td,{children:`Camera permission previously denied for the site, or an endpoint management setting blocks it`}),_jsxs(_components.td,{children:[`Allow camera access for `,_jsx(_components.code,{children:`verify.truu.ai`}),` in browser site settings and reload. On managed devices where MDM blocks the camera, use the phone handoff.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Nothing happens on the Windows lock screen`}),_jsx(_components.td,{children:`Camera permission is not available on the lock screen`}),_jsxs(_components.td,{children:[`Phone handoff is the path there; the QR code is shown on the lock screen page. See `,_jsx(_components.a,{href:`/idv/use-cases/device-enrollment`,children:`Windows agent enrollment`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Black screen where the preview should be`}),_jsx(_components.td,{children:`Another app holds the camera, or an in-app browser without camera support`}),_jsx(_components.td,{children:`Close other camera apps; open the link in Safari on iOS or Chrome on Android rather than an embedded webview.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Camera starts, then the Face or Proofing step fails before capture on a corporate laptop`}),_jsx(_components.td,{children:`SSL inspection on the corporate proxy is breaking the liveness stream or the vendor SDK`}),_jsxs(_components.td,{children:[`Allowlist the hosts on `,_jsx(_components.a,{href:`/idv/security/network`,children:`Network requirements`}),`, or hand off to a phone off the corporate network.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Document capture repeatedly rejected`}),_jsx(_components.td,{children:`Glare, poor lighting, or the document outside the frame guide`}),_jsx(_components.td,{children:`Place the document on a dark non-reflective surface in even light and align it with the guide.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`factor-failures`,children:`Factor failures`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`SMS codes fail or never arrive for many users`,id:`sms-codes-fail-or-never-arrive-for-many-users`,children:_jsxs(_components.p,{children:[`Phone number formatting and coverage. SMS delivery requires E.164 (`,_jsx(_components.code,{children:`+15551234567`}),`); values like `,_jsx(_components.code,{children:`555-123-4567`}),` are rejected. SMS coverage is often far lower than email coverage, and many organizations restrict SMS. Check coverage of the mobile attribute in `,_jsx(_components.strong,{children:`Settings → Directory`}),` before relying on the SMS factor, normalize numbers in the directory, and prefer Email in the primary column.`]})}),_jsx(Accordion,{title:`Email codes delayed or in spam`,id:`email-codes-delayed-or-in-spam`,children:_jsx(_components.p,{children:`Email codes are occasionally delayed; the resend works. If delivery problems are widespread, confirm your email security gateway allows the sending domain and check quarantine. Contact support to confirm sender authentication for your workspace.`})}),_jsx(Accordion,{title:`User cannot resend a one-time code`,id:`user-cannot-resend-a-one-time-code`,children:_jsx(_components.p,{children:`Resends are limited and a cooldown is shown on the button. This is expected, not a delivery fault. Have the user wait out the countdown; if they exhaust the resend budget, the flow falls back to the next column or the agent sends a fresh link.`})}),_jsx(Accordion,{title:`Face is unavailable or fails for specific users`,id:`face-is-unavailable-or-fails-for-specific-users`,children:_jsxs(_components.p,{children:[`The Face factor needs a reference photo. Users with none are routed to a fallback column. Two data-quality problems are common: directory photos are often stale (years old) or tiny (`,_jsx(_components.code,{children:`thumbnailPhoto`}),` at roughly 96 pixels), and both lower match scores. A photo deposited from a passed Proofing check matches far better. Configure the Face factor’s reference sources so proofing-derived photos take precedence, and put Proofing in a fallback column so users without a usable photo create one. Check photo coverage under `,_jsx(_components.strong,{children:`Settings → Directory`}),`.`]})}),_jsx(Accordion,{title:`Knowledge questions fail for legitimate users`,id:`knowledge-questions-fail-for-legitimate-users`,children:_jsxs(_components.p,{children:[`The attribute behind the question is empty or inconsistent. `,_jsx(_components.code,{children:`department`}),` in particular is often blank or formatted differently across business units, and many organizations keep the real org data in extension attributes. Check coverage and sample values in attribute mapping before enabling an attribute as a question source, map the extension attribute that actually holds the data, and disable attributes with poor coverage. See `,_jsx(_components.a,{href:`/idv/connect/directory/overview#attribute-mapping-and-coverage`,children:`Attribute mapping and coverage`}),`.`]})}),_jsx(Accordion,{title:`Document proofing fails repeatedly`,id:`document-proofing-fails-repeatedly`,children:_jsx(_components.p,{children:`Read the factor outcome reason on the request timeline. Common causes are capture quality, an unsupported or damaged document, a name that does not match the directory record, or a liveness failure. Have the user retry on a phone in better light. If failures persist for a legitimate user, follow your escalation procedure rather than creating repeated new links.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`servicenow-connector`,children:`ServiceNow connector`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Verify Identity stopped working after an app upgrade`}),_jsx(_components.td,{children:`Upgrading the app clears its stored credentials`}),_jsxs(_components.td,{children:[`Generate a new connect link in `,_jsx(_components.strong,{children:`Settings → Connectors → ServiceNow`}),` and connect again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Test connection fails`}),_jsx(_components.td,{children:`Your instance is unreachable, the app is disabled, its credentials were cleared, or the app’s OAuth client or integration user was deactivated`}),_jsx(_components.td,{children:`Confirm the instance is up and the app is enabled, then reconnect.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Connect says the instance refused an OAuth client-credentials token`}),_jsx(_components.td,{children:`ServiceNow turns the client-credentials grant off by default`}),_jsxs(_components.td,{children:[`Turn it on from the Connect page (one time per instance), then select `,_jsx(_components.strong,{children:`Connect`}),` again. See `,_jsx(_components.a,{href:`/idv/connect/servicenow#connect-to-truu`,children:`ServiceNow`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Work notes stop appearing`}),_jsx(_components.td,{children:`Your instance was unreachable when the event was sent`}),_jsx(_components.td,{children:`Events are still on the request timeline and in the audit trail. Run Test connection, check instance availability, and re-run the verification if needed.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/idv/connect/servicenow`,children:`ServiceNow`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`storage`,children:`Storage`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cannot add a store because your cloud team will not issue a bucket or credentials`}),_jsx(_components.td,{children:`Common; cloud teams often restrict new accounts`}),_jsxs(_components.td,{children:[`Use `,_jsx(_components.strong,{children:`TruU managed`}),` storage for now. You can connect your own store later. See `,_jsx(_components.a,{href:`/idv/connect/storage`,children:`Storage`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Store shows `,_jsx(_components.strong,{children:`Idle`})]}),_jsx(_components.td,{children:`No writes have reached it yet`}),_jsxs(_components.td,{children:[`Run a Proofing check end to end. The badge turns `,_jsx(_components.strong,{children:`Live`}),` on the first write.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Test connection fails`}),_jsx(_components.td,{children:`Wrong region or bucket name, or a credential without the access you selected`}),_jsxs(_components.td,{children:[`Check the credential’s permissions on the bucket, then run `,_jsx(_components.strong,{children:`Test connection`}),` again before `,_jsx(_components.strong,{children:`Connect`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`wrong-flow-for-someone`,children:`Wrong flow for someone`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Likely cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A person gets the wrong flow`}),_jsx(_components.td,{children:`Rules are checked top to bottom and the first match wins; a broader rule above the intended one matches first`}),_jsxs(_components.td,{children:[`In `,_jsx(_components.strong,{children:`Use Cases`}),`, move the more specific rule above the general one.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A group rule never matches`}),_jsx(_components.td,{children:`The person isn’t in the group, or the rule targets a similarly named group`}),_jsx(_components.td,{children:`Confirm membership in your directory; lookup is live, so there’s no sync to wait for. Re-select the group in the rule.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The Catch All Flow runs instead of the flow you expected`}),_jsxs(_components.td,{children:[`The request was for a different use case, or no rule above `,_jsx(_components.strong,{children:`Everyone else`}),` matches the person`]}),_jsxs(_components.td,{children:[`Check which use case the request used in `,_jsx(_components.strong,{children:`Activity`}),`, then that use case’s rules.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Flow changes don’t take effect`}),_jsx(_components.td,{children:`The flow wasn’t saved`}),_jsxs(_components.td,{children:[`Open the flow and choose `,_jsx(_components.strong,{children:`Save flow`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`still-stuck`,children:`Still stuck?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Activity`}),` in the IDV Console is the fastest diagnostic tool: filter to the affected request or user and read the reason codes. See `,_jsx(_components.a,{href:`/idv/security/audit-events`,children:`Audit events`}),`. When you contact `,_jsx(_components.a,{href:`/idv/resources/support`,children:`support`}),`, include the request ID and the relevant event IDs.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.","icon":"wrench","href":"/idv/resources/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Directory connection","slug":"directory-connection","depth":2,"children":[]},{"title":"Verification links","slug":"verification-links","depth":2,"children":[]},{"title":"Camera: desktop webcams and phone handoff","slug":"camera-desktop-webcams-and-phone-handoff","depth":2,"children":[]},{"title":"Factor failures","slug":"factor-failures","depth":2,"children":[]},{"title":"ServiceNow connector","slug":"servicenow-connector","depth":2,"children":[]},{"title":"Storage","slug":"storage","depth":2,"children":[]},{"title":"Wrong flow for someone","slug":"wrong-flow-for-someone","depth":2,"children":[]},{"title":"Still stuck?","slug":"still-stuck","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"truu-2","siteName":"TruU Docs","title":"Troubleshooting - TruU Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T23:42:32.602Z","originalFileLocation":"idv/resources/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - TruU Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TruU Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truu.ai/idv/resources/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://truu-2.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Troubleshooting\u0026amp;description=Symptom%2C+cause%2C+and+fix+for+the+common+TruU+IDV+problems%3A+directory+connection%2C+link+delivery%2C+desktop+webcams+and+phone+handoff%2C+SMS+and+email+codes%2C+knowledge\u0026amp;theme=0d751508c8c1a0d592616b7c\u0026amp;signature=6db799492e9ff1abb1555d540dcdb60cdd61c0a884d930deb8b2edd06cd1a36d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - TruU Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://truu-2.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Troubleshooting\u0026amp;description=Symptom%2C+cause%2C+and+fix+for+the+common+TruU+IDV+problems%3A+directory+connection%2C+link+delivery%2C+desktop+webcams+and+phone+handoff%2C+SMS+and+email+codes%2C+knowledge\u0026amp;theme=0d751508c8c1a0d592616b7c\u0026amp;signature=6db799492e9ff1abb1555d540dcdb60cdd61c0a884d930deb8b2edd06cd1a36d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#101010\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truu.ai/idv/resources/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/idv/resources/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truu.ai/#organization\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truu.ai#website\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truu.ai/idv/resources/troubleshooting#webpage\",\"url\":\"https://docs.truu.ai/idv/resources/troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\",\"dateModified\":\"2026-11-06T23:42:32.602Z\",\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truu.ai/idv/resources/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truu.ai/idv/resources/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"TruU Docs\",\"item\":\"https://docs.truu.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshooting\",\"item\":\"https://docs.truu.ai/idv/resources/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.truu.ai/idv/resources/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Symptom, cause, and fix for the common TruU IDV problems: directory connection, link delivery, desktop webcams and phone handoff, SMS and email codes, knowledge questions, face references, ServiceNow event push, storage, and use case routing.\",\"url\":\"https://docs.truu.ai/idv/resources/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truu.ai/idv/resources/troubleshooting#webpage\"},\"dateModified\":\"2026-11-06T23:42:32.602Z\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TruU Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TruU Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/idv/resources/troubleshooting.md","siteName":"TruU Docs","nav":{"global":null,"products":[{"product":"Passwordless","color":{"light":"#c86c0e","dark":"#c86c0e"},"pages":[{"title":"Passwordless","href":"/docs/welcome-to-truu"}]},{"product":"TOTAL","color":{"light":"#c6c6c6","dark":"#c6c6c6"},"pages":[{"title":"TOTAL","href":"/quickstart"}]},{"product":"Identity Verification","tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Welcome to TruU IDV","icon":"hand-wave","href":"/idv/introduction"},{"title":"Quickstart","icon":"rocket","href":"/idv/getting-started/quickstart"},{"title":"Go live","icon":"flag-checkered","href":"/idv/getting-started/go-live"}]},{"group":"Use cases","pages":[{"title":"How use cases work","icon":"route","href":"/idv/use-cases/overview"},{"title":"Help desk verification","icon":"headset","href":"/idv/use-cases/help-desk"},{"title":"Self-service credential reset","icon":"key","href":"/idv/use-cases/credential-reset"},{"title":"Verified device enrollment","icon":"laptop","href":"/idv/use-cases/device-enrollment"},{"title":"Shared devices","icon":"users-viewfinder","href":"/idv/use-cases/shared-devices"}]},{"group":"Factors","pages":[{"title":"How factors work","icon":"fingerprint","href":"/idv/factors/overview"},{"title":"Face","icon":"face-viewfinder","href":"/idv/factors/face"},{"group":"Proofing","expanded":true,"pages":[{"title":"Proofing","icon":"id-card","href":"/idv/factors/proofing/overview"},{"title":"Didit","icon":"passport","href":"/idv/factors/proofing/didit"},{"title":"PingOne Verify","icon":"circle-check","href":"/idv/factors/proofing/pingone-verify"},{"title":"Persona","icon":"address-card","href":"/idv/factors/proofing/persona"},{"title":"Entrust (Onfido)","icon":"shield-check","href":"/idv/factors/proofing/entrust"}]},{"title":"SMS","icon":"message-sms","href":"/idv/factors/sms"},{"title":"Email","icon":"envelope","href":"/idv/factors/email"},{"title":"Knowledge","icon":"brain","href":"/idv/factors/knowledge"},{"title":"Badge","icon":"id-badge","href":"/idv/factors/badge"}]},{"group":"Build","pages":[{"title":"Flows and templates","icon":"diagram-project","href":"/idv/build/flows"},{"title":"Verification requests and links","icon":"link","href":"/idv/build/verification-requests"},{"title":"Branding","icon":"palette","href":"/idv/build/branding"}]},{"group":"Connect","pages":[{"title":"How integrations fit together","icon":"plug","href":"/idv/connect/overview"},{"group":"Directory","expanded":true,"pages":[{"title":"Connect your directory","icon":"building","href":"/idv/connect/directory/overview"},{"title":"Connect Microsoft Entra ID","icon":"microsoft","href":"/idv/connect/directory/entra-id"},{"title":"Connect Okta","icon":"circle-nodes","href":"/idv/connect/directory/okta"}]},{"group":"HR system","expanded":true,"pages":[{"title":"Connect your HR system","icon":"id-card","href":"/idv/connect/hr/overview"},{"title":"Connect BambooHR","icon":"id-card","href":"/idv/connect/hr/bamboohr"},{"title":"Connect Workday","icon":"id-card","href":"/idv/connect/hr/workday"},{"title":"Connect UKG Pro","icon":"id-card","href":"/idv/connect/hr/ukg-pro"}]},{"title":"Storage","icon":"database","href":"/idv/connect/storage"}]},{"group":"Connectors","pages":[{"title":"ServiceNow","icon":"ticket","href":"/idv/connect/servicenow"},{"title":"Microsoft Teams","icon":"comments","href":"/idv/connect/microsoft-teams"},{"title":"TruU Passwordless","icon":"fingerprint","href":"/idv/connect/passwordless"},{"title":"Windows TAP","icon":"key","href":"/idv/connect/windows-tap"},{"title":"PingOne MFA","icon":"rotate","href":"/idv/connect/pingone-mfa"}]},{"group":"Administer","pages":[{"title":"Console tour","icon":"map","href":"/idv/admin/console-tour"},{"title":"Sign-in, SSO and passkeys","icon":"right-to-bracket","href":"/idv/admin/sign-in"},{"title":"Team and roles","icon":"users","href":"/idv/admin/team-and-roles"},{"title":"Activity and export","icon":"list-check","href":"/idv/admin/activity"},{"title":"Insights","icon":"chart-line","href":"/idv/admin/insights"},{"title":"Credential health","icon":"heart-pulse","href":"/idv/admin/credential-health"}]},{"group":"For help desk agents","pages":[{"title":"Agent guide","icon":"headset","href":"/idv/help-desk/agent-guide"}]},{"group":"For employees","pages":[{"title":"What to expect during verification","icon":"user-check","href":"/idv/end-users/what-to-expect"},{"title":"Your privacy and your data","description":"For employees verifying with TruU: TruU processes your data for your organization and keeps your personal details in your organization's own storage. What is captured, where it goes, what is kept, how consent works, and how to request deletion at biometricdeletionrequest@truu.ai.","icon":"shield-halved","href":"/idv/end-users/your-privacy"}]},{"group":"Resources","pages":[{"title":"Troubleshooting","icon":"wrench","href":"/idv/resources/troubleshooting"},{"title":"Frequently asked questions","description":"Quick answers for IT administrators and security evaluators: what TruU IDV is, directory access, what is stored from face and document checks, certifications, SIEM export, agent visibility, proofing vendors, and testing.","icon":"circle-question","href":"/idv/resources/faq"},{"title":"Glossary","icon":"book","href":"/idv/resources/glossary"},{"title":"Release notes","icon":"sparkles","href":"/idv/resources/release-notes"},{"title":"Status labels","icon":"tag","href":"/idv/resources/status-labels"},{"title":"Support","icon":"life-ring","href":"/idv/resources/support"},{"title":"SMS verification messages","href":"/idv/resources/sms-opt-in"}]}]},{"tab":"Security \u0026 compliance","pages":[{"title":"Security \u0026 compliance","href":"/idv/security/overview"}]},{"tab":"API","pages":[{"title":"API","href":"/idv/api/quickstart"}]}]}]},"basePath":"","title":"Troubleshooting - TruU Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}