トラブルシューティング

最終公開日 : 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を選択します。FIDO2呼び出しがリダイレクトされた結果として、wfica32.exeプロセスからのダイアログプロンプトが表示されるはずです (添付のスクリーンショットを参照)。そうでない場合：
      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 Support に連絡し、収集した情報を提供して、より迅速な解決を図ります。
Related information
FIDO2認証