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

# Self-service credential reset

> Let employees verify themselves before a password or MFA reset, from the self-service portal or your own tools, and optionally issue a Temporary Access Pass or reset PingOne MFA automatically.

This page is for the administrator who wants employees to recover their own credentials without waiting for an agent. When you finish, an employee who has lost their MFA device or password can prove who they are on their phone and, if you choose, get back in automatically.

## How it works

1. The employee starts from the [self-service portal](#self-service-portal), by typing `verify me` to the [Microsoft Teams](https://docs.truu.ai/idv/connect/microsoft-teams.md) bot, from a [ServiceNow catalog item](https://docs.truu.ai/idv/connect/servicenow.md#self-service-with-flow-designer), or from your own tool through the API.
2. TruU sends a verification link to a contact already on file in your directory.
3. The employee completes the flow the **Credential reset** use case assigns them.
4. On success, TruU does what the use case says: records the result for your process to act on, issues a Windows Temporary Access Pass, or resets the employee's PingOne MFA devices.

## Before you start

* A connected directory with email addresses, and mobile numbers in E.164 format if you want text delivery. See [SMS](https://docs.truu.ai/idv/factors/sms.md).
* A flow suited to unattended recovery. Avoid a column that relies only on factors an attacker with the employee's email could pass; a Face or Proofing column first is a good default.
* For automatic recovery, a connector: [Windows TAP](https://docs.truu.ai/idv/connect/windows-tap.md) or [PingOne MFA](https://docs.truu.ai/idv/connect/pingone-mfa.md).

## Set it up

**1. Route the Credential reset use case**

In **Use Cases → Credential reset**, set the flow for **Everyone** and add rules for groups that need a different one. See [How use cases work](https://docs.truu.ai/idv/use-cases/overview.md).

**2. Choose what happens after**

Under **When it ends → Passed**:

* **Report only**: record the result; your own process does the reset.
* **Issue a Temporary Access Pass**: Entra ID issues a TAP so the employee can sign in and register a new method.
* **Ping re-enrollment**: TruU removes the employee's PingOne MFA devices so they can register again.

**3. Publish the portal**

Share the portal URL where employees look for IT help: the intranet, the ticket portal, or a QR code at the service desk. See below.

## Self-service portal

The portal is a public page unique to your workspace where an employee requests their own verification link. No agent is involved, and every guarantee of an agent-sent request still applies.

* **Address:** `https://verify.truu.ai/self-portal/<short code>`. Your workspace's short code is in **Settings → General**.
* **Identify:** the employee enters their work email or sign-in name. Only people in your connected directory can continue.
* **Deliver:** the employee picks **Email** or **Text message**, shown masked, from the contacts on file. The portal never accepts a typed-in destination and never shows a full address or number.
* **Verify:** the link opens the standard verification page, and the **Credential reset** use case decides the flow.

![Self-service portal on a phone titled Verify it is you, asking for a work email or UPN for Contoso, with a Continue button](https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/selfportal-phone-light.png?fit=max\&auto=format\&n=ggexkQvmOZdl3yHs\&q=85\&s=1d81bb9a9065052bcf7dd8cc6c483142)

The self-service portal on a phone.

The portal is hardened because it is public: requests are rate limited, links only go to contacts on file, a new request replaces the previous portal link, which stops working, and attempt limits apply as usual.

> [!NOTE]
>
> If many employees don't see **Text message**, their directory mobile numbers are missing or not in E.164 format. Expect most employees to use **Email** until that is fixed. See [SMS](https://docs.truu.ai/idv/factors/sms.md).

## From Teams or ServiceNow

* **Microsoft Teams:** turn on **Self-service** on the Teams connector and allow **Credential reset** for it. Employees type `verify me` to the bot and get their link in the chat. See [Microsoft Teams](https://docs.truu.ai/idv/connect/microsoft-teams.md#how-it-works-for-employees).
* **ServiceNow:** put **TruU: Verify Identity and Wait** in front of a catalog item with **Use Case** set to **Password reset**. See [Self-service with Flow Designer](https://docs.truu.ai/idv/connect/servicenow.md#self-service-with-flow-designer).

## From your own tools

To start a reset verification from your own portal or chatbot, create a link with the API and the use case key `reset`. See [API quickstart](https://docs.truu.ai/idv/api/quickstart.md).

## Test it

Open the portal, enter your own work email, choose a channel and complete the verification. Confirm the outcome you configured: the request shows **Verified** in **Activity**, and if you chose an automatic action, check that a TAP was issued or your PingOne MFA devices were removed.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| "No contact on file" | The address isn't the employee's sign-in name, they aren't in the connected directory, or there's no email or mobile number on file. The portal doesn't say which, so it can't be used to discover accounts. | Use the address they sign in with; check the directory sync and the contact attributes |
| No TAP was issued | Windows TAP isn't connected, or TAP is turned off in Entra ID | See [Windows TAP](https://docs.truu.ai/idv/connect/windows-tap.md) |
| MFA devices weren't removed | The PingOne worker app lacks the Identity Data Admin role, or the reset scope excludes the device type | See [PingOne MFA](https://docs.truu.ai/idv/connect/pingone-mfa.md) |

## Related

* [Help desk verification](https://docs.truu.ai/idv/use-cases/help-desk.md)
* [Windows TAP](https://docs.truu.ai/idv/connect/windows-tap.md)
* [PingOne MFA](https://docs.truu.ai/idv/connect/pingone-mfa.md)


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