Skip to main content
This page is for the admin who wants a verified user to sign in to Windows or Entra without an agent reading a password over the phone. When you finish, verifications for the use cases you choose issue a Temporary Access Pass that only the verified user sees.

About Windows TAP

A Temporary Access Pass (TAP) is a time-limited code Entra ID accepts as a sign-in method, intended for onboarding and recovery. The Windows TAP connector issues one in your tenant when a verification passes for a use case set to issue one, and shows the code on the verification success screen. This connector acts after a verification. The user signs in with it and enrolls their permanent credentials. Typical uses: day-one onboarding, recovery when a user has lost every authenticator, and passwordless credential resets.

What the connection enables

The directory connection stays read-only; TAP issuance uses a separate app registration with one write permission. The setup script also turns on the Temporary Access Pass authentication method in your tenant (for all users, or for one group with -TargetGroupId) and sets its limits to TruU’s defaults: default and minimum lifetime 60 minutes, maximum 480, one-time use on. Review your existing TAP settings before running it.

Prerequisites

  • A connected Microsoft Entra ID directory. TAP issuance is Entra-only.
  • Entra ID P1 (or higher) licensing; the Temporary Access Pass authentication method requires it.
  • Temporary Access Pass enabled as an authentication method in your tenant for the users in scope (Entra admin center → Protection → Authentication methods → Temporary Access Pass).
  • A Global Administrator to run the PowerShell setup script. It signs in with Application.ReadWrite.All, AppRoleAssignment.ReadWrite.All and Policy.ReadWrite.AuthenticationMethod.
  • An IDV Console account with the Owner or Admin role.

Get your credentials

The setup script creates a dedicated TAP provisioner app registration and registers it with your workspace. Review the permission before running it. This is the only permission the app holds. It cannot read user attributes, groups, or other authentication methods.
1

Start setup in the IDV Console

Go to Settings → Connectors → Windows TAP and choose Get setup command. The console generates a short-lived setup token and shows a one-line PowerShell command that downloads the current script and runs it with that token.
2

Run the script as an Entra administrator

Paste the command into PowerShell signed in to the target tenant. The script creates the app registration, adds UserAuthMethod-TAP.ReadWrite.All, grants admin consent, enables the TAP method, and registers the credentials with your workspace. Nothing is copied by hand; the client secret is stored in a managed secrets service and never returned.
Entra can take a minute to propagate a new app registration. If the first health check fails right after the script finishes, wait and retry.
Register an app named, for example, “TruU TAP Provisioner” (separate from the directory reader app). Add the UserAuthMethod-TAP.ReadWrite.All application permission and grant admin consent, create a client secret, and turn on Temporary Access Pass under Protection → Authentication methods in the Entra admin center. Then choose Set up manually instead and enter the Client ID and Client secret.

Connect in TruU

Temporary Access Pass connector page with the setup command, manual Client ID and secret, and TAP lifetime and one-time use settingsTemporary Access Pass connector page with the setup command, manual Client ID and secret, and TAP lifetime and one-time use settings
After registration the connector page shows the app registration and its TAP settings: Then turn it on per use case: in Use Cases, open each use case that should issue a pass (for example Onboarding or Credential reset) and set When it ends → Passed to Issue a Temporary Access Pass. Only verifications for those use cases issue a pass. Integration enabled must also be on; when it’s off, TruU skips issuing passes everywhere. See How use cases work. Registration is one-time per workspace. To re-register with a different app, delete the configuration first. Validated at save: the app can obtain a token. Not validated at save: that the TAP authentication method is enabled for the users in scope; that failure shows at issuance time.

Verifying the connection

Checks run at registration, on demand from Credential health, and daily. Then run one end-to-end test: complete a verification as a test user for a use case set to issue a pass, confirm the code appears on the success screen, and sign in with it.

How it works

Issuance. On success, TruU creates a TAP on the user with the configured lifetime and one-time-use setting and shows the code to the user on the success screen with its expiry. The code is shown once, there, and nowhere else. Where the code is shown. Only on the verified user’s success screen (web verification page, or the phone if the verification was handed off by QR). The agent sees a TAP issued outcome on the request detail in the help desk app, never the code. The code is not stored by TruU and does not appear in audit records. Failure handling. If issuance fails (the user already has an active TAP, TAP is not enabled for the user, licensing, or Entra rejects the call), the verification result stands and the request detail shows TAP could not be issued so the agent can follow up. Revoking. To revoke a pass before it expires, delete it in the Entra admin center. Passes also expire on their own at the lifetime, and a single-use pass is consumed at first sign-in. Disconnecting the connector does not revoke passes already issued. Hosts. TruU only ever calls login.microsoftonline.com and graph.microsoft.com for this connector. Secrets. The provisioner client secret is held in a managed secrets service. Setup-token issuance, registration, setting changes, and issuance outcomes are recorded in the audit trail.

Gotchas and troubleshooting

  • Health check fails right after setup. Propagation delay or missing admin consent. Wait a minute, retry, then confirm consent on the app registration.
  • Issuance fails with a method-not-enabled error. The Temporary Access Pass method is not enabled in the tenant, or the user is outside its target group. Fix in Authentication methods.
  • Issuance fails with a licensing error. The user has no Entra ID P1 license.
  • User already has an active TAP. Entra allows one active pass per user. Revoke the existing one in the Entra admin center and resend the verification.
  • User is verifying on the Windows lock screen and cannot see the code. The lock screen has no camera, so the verification ran on the phone; the code is shown on the phone’s success screen. Tell users to keep the phone until they have signed in.
  • Agent asks for the code. By design the agent never sees it. If the user lost it, revoke and run a new verification.
  • Not validated at save. TAP method enablement, user licensing, and conditional access policies that may block TAP sign-in for the user.

How use cases work

Where the after-success action is set for each use case.

Microsoft Entra ID

The read-only directory connection TAP issuance builds on.

TruU Passwordless

Verify before enrollment instead of, or alongside, a TAP.

Credential health

Where the checks above appear.