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アプリのバージョンを表示します。FIDO2リダイレクトが正しく機能するには、VDAとCitrix Workspaceアプリの両方が最小バージョン要件を満たしている必要があります。
例:
"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リダイレクトのトラブルシューティング」を参照してください。