故障排除

Last published : Nov 13, 2026
以下步骤应遵循以解决 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. 未设置设备规则，以使用通用 USB 重定向来重定向 FIDO2 密钥设备。
    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 支持，提供收集到的信息以加快解决速度。
Related information
FIDO2 和 WebAuthn 身份验证

常见问题和解决方案

  1. 使用 Microsoft Edge 浏览器打开的网页可能无法进行 FIDO2 身份验证
    1. 可能的原因：带有 AppContainer 的 Edge 沙盒实例不允许 Citrix 挂钩到进程中，这会阻止 WebAuthn 调用的重定向正常工作。
    2. 解决方案：可以通过在组策略编辑器中或通过 Intune 更新相应设置来解决此问题。有关此内容的更多信息，请参阅此处。或者，将 DynamicCodeSettings 注册表值设置为 0 也应有助于解决此问题。
      • 项：Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\
      • 值名称：DynamicCodeSettings
      • 值类型：DWORD
      • 值数据：0
  2. FIDO2（例如 Yubikey）重定向在 Web 浏览器中不起作用
    1. 可能的原因：与浏览器相关的 FSLogix 配置文件管理 AppMasking 规则可能会阻止 Citrix FIDO2 服务查看和验证浏览器安装的文件路径。
    2. 解决方案：禁用 FSLogix 中使 Chrome 文件路径对 Citrix FIDO2 服务不可见的隐藏规则，将确保 Yubikey 成功重定向并显示在浏览器中。