产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

故障排除

April 8, 2026
投稿者: 
C C

请按照以下步骤对 FIDO2 重定向问题进行故障排除：

  1. 检查系统要求

    1. 根据 Citrix 官方文档，验证 FIDO2 重定向是否满足系统要求。

  2. 验证设备连接

    1. 对于物理 FIDO2 密钥：

      1. 确保 FIDO2 密钥已正确插入并在客户端端点上可见。
      2. 使用操作系统设备管理器（例如，Windows 上的“设备管理器”，macOS 上的“系统信息”）确认设备已识别并正常运行。
      3. 如果未检测到设备：
        1. 尝试重新插入密钥或使用不同的 USB 端口。
        2. 在其他设备上测试密钥以排除硬件问题。

    2. 对于内置身份验证器（例如 Windows Hello 等）：

      1. 确认客户端设备上已启用并配置该功能。

    3. 这一点很重要，因为如果客户端设备无法识别 FIDO2 密钥，Citrix 将无法将其重定向到 HDX 会话。

  3. 验证 Citrix 策略设置和配置

    1. 检查 Citrix 策略中的 FIDO2/WebAuthn 重定向和 USB 重定向设置。

      1. FIDO2 重定向策略已启用。
      2. 如果正在使用 EdgeWebView2 或自定义桌面应用程序，则在 FIDO2 允许的进程策略设置中添加了相应的文件路径。
      3. 未为 FIDO2 密钥设置设备规则，以使用通用 USB 重定向来重定向设备。

    2. 如果 Citrix 组件最近已更新，请验证您的配置是否与新版本保持一致。

  4. 使用 HDX Monitor 进行诊断

    1. 启动 HDX 会话，打开 Web 浏览器或 UWP 应用程序，然后导航到身份验证页面。

    2. 选择安全密钥、Webauthn 或 FIDO2 作为登录方法。您应该会看到 wfica32.exe 进程弹出的对话框提示，这是 FIDO2 调用被重定向的结果（请参阅随附的屏幕截图）。如果不是这种情况：

      1. 确保密钥未通过通用 USB 虚拟通道重定向。如果密钥在 HDX 会话中被重定向，您可能会看到一个对话框提示，显示“将安全密钥插入 USB 端口”。要解决此问题，请禁用 USB 重定向或确保安全密钥未在 HDX 会话中重定向。
      2. 在 HDX 会话中打开 HDX Monitor，然后导航到 FIDO2 - Webauthn 重定向节点。
      3. 确保 FIDO2 允许重定向策略设置为 True，并且需要 FIDO2/WebAuthn 身份验证的应用程序列在 FIDO2 重定向挂钩应用程序中。如果应用程序不存在，请根据 高级配置 中的信息将其添加到相应的注册表位置。
      4. 确保需要 FIDO2/WebAuthn 身份验证的应用程序的完整路径列在 FIDO2 允许的进程策略设置中。如果完整路径不存在，请将其添加到 Studio 中的 FIDO2 允许的进程策略设置中。有关更多信息，请参阅配置部分。
      5. （旧版）如果使用旧版基于注册表的设置配置 FIDO2 重定向，请将您的配置迁移到 Studio 中的 FIDO2 允许的进程策略设置，并确保包含需要 FIDO2/WebAuthn 身份验证的应用程序的完整路径。有关更多信息，请参阅配置部分。

注意：

如果您的会话主机上尚未安装 HDX Monitor，可以从 Citrix Virtual Apps and Desktops 安装程序的 Support 文件夹中安装它。

  1. 收集日志并联系技术支持

    1. 如果在执行上述步骤后问题仍然存在：

      1. 收集 HDX Monitor 输出、Citrix Workspace 应用程序和 VDA CDF 日志。
      2. 记录您已采取的所有故障排除步骤以及遇到的任何错误消息。
      3. 联系您的 IT 支持团队或 Citrix 支持，提供收集到的信息以加快解决速度。
故障排除
April 8, 2026
投稿者: 
C C
April 8, 2026
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.