Citrix Virtual Apps and Desktops

FIDO2 diagnostics tool

CtxFido2Diagnostics.exe is a command-line tool on the VDA that helps Citrix administrators and support engineers diagnose and resolve FIDO2 redirection configuration issues in HDX sessions. The tool collects and displays key configuration data in JSON format, enabling rapid identification of policy misconfigurations, missing application hookings, and version mismatches.

The tool is located at: C:\Program Files\Citrix\HDX\bin\CtxFido2Diagnostics.exe

The tool’s path is included in the system environment variables during VDA installation, so you can run it from any directory by typing CtxFido2Diagnostics.exe.

Requirements

Session host

  • Operating system: Windows 10 1809 or later, Windows 11 21H2 or later, Windows Server 2019 or later

Client device

  • Operating system: Windows 10 1809 or later

Information displayed

When you run CtxFido2Diagnostics.exe from within an HDX session, the tool outputs a JSON object containing the following diagnostic information:

CVAD Version

Displays the version of Citrix Virtual Apps and Desktops installed on the session host. Use this to verify that the VDA version supports FIDO2 redirection and the specific WebAuthn features required by your deployment.

Example:

"CVAD Version": "2607.0.100.407"
<!--NeedCopy-->

CWA Version

Displays the version of Citrix Workspace app installed on the client device. Both the VDA and Citrix Workspace app must meet minimum version requirements for FIDO2 redirection to function correctly.

Example:

"CWA Version": "CWA for Windows, 26.3.10.69"
<!--NeedCopy-->

Fido2PolicyEnabled

Indicates whether the FIDO2 redirection policy is enabled (true) or disabled (false) for the current session. When this value is false, FIDO2 redirection does not function regardless of other configuration settings.

Administrators configure this policy through Citrix Studio or Citrix Group Policy under ICA > FIDO2.

Example:

"Fido2PolicyEnabled": true
<!--NeedCopy-->

Session ID

Displays the ID of the current HDX session. This value is useful for correlating the diagnostic output with session logs in Director or event viewer entries during troubleshooting.

Example:

"Session ID": 2
<!--NeedCopy-->

WebAuthn API Version

Displays the WebAuthn API version supported by the current CVAD and CWA combination. The API version determines which FIDO2/WebAuthn capabilities are available for redirection.

Example:

"WebAuthn API Version": 7
<!--NeedCopy-->

FIDO2 Allowed Processes Registry setting

Lists the application process paths configured through the registry on the session host that are permitted to use FIDO2 redirection. These paths correspond to the registry value at:

HKLM\SOFTWARE\Citrix\CtxHook\AppInit_DLLs\CtxWebAuthnHook\

This list typically includes supported browsers (Chrome, Edge, Firefox, Brave), the Azure AD Broker Plugin, and the Citrix ICA client itself. The FIDO2 diagnostics tool executable is also included so it can perform diagnostic calls.

FIDO2 Allowed Processes Studio Policy setting

Lists additional application process paths configured by administrators through Citrix Studio policy setting that are allowed to use FIDO2 redirection. These entries supplement the registry-based list and allow administrators to add custom applications (such as third-party authenticator utilities) without modifying the registry directly.

FIDO2 Redirection Hookable Applications

Lists the application executable names that the FIDO2 hooking module has successfully identified and can intercept for WebAuthn API redirection. Only applications appearing in this list will have their FIDO2 authentication requests redirected to the client device.

If an application appears in the allowed processes list but does not appear here, the hooking module was unable to attach to it. This can indicate a compatibility issue, an application that is not currently running, or a configuration problem.

For detailed guidance on resolving FIDO2 redirection issues identified by this tool, see Troubleshoot FIDO2 redirection.

FIDO2 diagnostics tool