FIDO2 诊断工具
CtxFido2Diagnostics.exe 是 VDA 上的一个命令行工具，可帮助 Citrix 管理员和支持工程师诊断和解决 HDX 会话中的 FIDO2 重定向配置问题。该工具以 JSON 格式收集并显示关键配置数据，从而能够快速识别策略配置错误、缺少应用程序挂钩和版本不匹配等问题。
该工具位于：
C:\Program Files\Citrix\HDX\bin\CtxFido2Diagnostics.exe
该工具的路径在 VDA 安装期间已包含在系统环境变量中，因此您可以通过键入
CtxFido2Diagnostics.exe 从任何目录运行它。
要求
会话主机
-
操作系统： Windows 10 1809 或更高版本、Windows 11 21H2 或更高版本、Windows Server 2019 或更高版本
客户端设备
-
操作系统： Windows 10 1809 或更高版本
显示的信息
当您在 HDX 会话中运行
CtxFido2Diagnostics.exe 时，该工具会输出一个包含以下诊断信息的 JSON 对象：
CVAD 版本
显示会话主机上安装的 Citrix Virtual Apps and Desktops 版本。使用此信息可验证 VDA 版本是否支持 FIDO2 重定向以及您的部署所需的特定 WebAuthn 功能。
示例：
"CVAD Version": "2607.0.100.407"
CWA 版本
显示客户端设备上安装的 Citrix Workspace 应用程序版本。VDA 和 Citrix Workspace 应用程序都必须满足最低版本要求，FIDO2 重定向才能正常运行。
示例：
"CWA Version": "CWA for Windows, 26.3.10.69"
Fido2策略已启用
指示当前会话的 FIDO2 重定向策略是已启用 (
true) 还是已禁用 (false)。当此值为 false 时，无论其他配置设置如何，FIDO2 重定向都无法运行。
管理员通过 Citrix Studio 或 Citrix 组策略在 ICA > FIDO2 下配置此策略。
示例：
"Fido2PolicyEnabled": true
会话 ID
显示当前 HDX 会话的 ID。此值有助于在故障排除期间将诊断输出与 Director 中的会话日志或事件查看器条目相关联。
示例：
"Session ID": 2
WebAuthn API 版本
显示当前 CVAD 和 CWA 组合支持的 WebAuthn API 版本。API 版本决定了哪些 FIDO2/WebAuthn 功能可用于重定向。
示例：
"WebAuthn API Version": 7
FIDO2 允许的进程注册表设置
列出通过会话主机上的注册表配置的、允许使用 FIDO2 重定向的应用程序进程路径。这些路径对应于以下注册表值：
HKLM\SOFTWARE\Citrix\CtxHook\AppInit_DLLs\CtxWebAuthnHook\
此列表通常包括受支持的浏览器（Chrome、Edge、Firefox、Brave）、Azure AD Broker 插件以及 Citrix ICA 客户端本身。FIDO2 诊断工具可执行文件也包含在内，以便它可以执行诊断调用。
FIDO2 允许的进程 Studio 策略设置
列出管理员通过 Citrix Studio 策略设置配置的、允许使用 FIDO2 重定向的其他应用程序进程路径。这些条目补充了基于注册表的列表，并允许管理员添加自定义应用程序（例如第三方身份验证器实用程序），而无需直接修改注册表。
FIDO2 重定向可挂钩应用程序
列出 FIDO2 挂钩模块已成功识别并可拦截以进行 WebAuthn API 重定向的应用程序可执行文件名称。只有在此列表中出现的应用程序，其 FIDO2 身份验证请求才会被重定向到客户端设备。
如果应用程序出现在允许的进程列表中但未在此处显示，则挂钩模块无法附加到它。这可能表示兼容性问题、应用程序当前未运行或配置问题。
相关信息
有关解决此工具识别出的 FIDO2 重定向问题的详细指导，请参阅排查 FIDO2 重定向问题。