Test a passkey in Duo

Use a passkey for the second verification step on a Duo-protected test app. Check the policy, enroll the passkey and match the test attempt to the Duo log.

Before you start

  • Use one Active test user, a protected test app, and a Duo administrator who can review policy and authentication logs. Keep the test user’s current Duo method available.
  • Choose a passkey and browser supported by Duo and allowed by your organization. Use a separate browser profile for the test and preserve the original administrator session.
  • Check Duo availability

Data and access

Shared or checked
Duo checks the passkey response and records the authentication result and method.
Check separately
Check the test user’s application assignment and destination permissions separately. Administrator access can follow a separate policy.
  1. Check the test user’s policy

    Review the authentication methods for the test app and the user’s groups. Duo lists passkey options under Platform authenticators and Roaming authenticators. Match the kind you intend to enroll to the effective policy. If a change is needed, scope it to the pilot.

    Check. The effective app and group policy permits the passkey type you plan to test.

  2. Add the passkey for the test user

    At Duo Universal Prompt, choose Other options → Manage devices, then verify with the current method. If the application allows self-service enrollment, choose Add a device and select the passkey option available for your device or browser. In the Duo Admin Panel, check Devices → Passkeys for the test user’s new entry.

    Check. Duo shows the new passkey for the intended test user and the original verification method remains available.

  3. Try the app in a fresh session

    Open the test app in a separate browser profile with no remembered Duo session. Complete the first verification step. At the Duo prompt, choose Other options if needed, select the new passkey and finish the prompt. Confirm you reached the expected page in the app.

    Check. The chosen passkey completes the Duo prompt and the user reaches the test app.

  4. Match the app result to the Duo log

    Open Reports → Authentication Log. Filter by the test user, application and time of the attempt. Record the result and method shown. In a separate fresh session, confirm the original method still works for the test user.

    Check. The Duo log matches the test account, app and method. The original method also works in a fresh session.

Check your result

Keep the test app name, applied policy, passkey type, and the time and outcome of each attempt. This walkthrough covers Duo’s own enrollment flow. Verify the exact credential provider you intend to roll out in your Duo environment.

How to verify your setup

If you get stuck

The passkey option is missing or Duo skips the prompt

Check which platform and roaming methods the effective policy allows and whether the app permits self-service device enrollment. If Duo skips the prompt, check remembered-device rules and policy exceptions before retrying in a fresh browser profile.

Report a problem with this guide

Explore all setup guides →