Strumento di diagnostica FIDO2
CtxFido2Diagnostics.exe è uno strumento da riga di comando sul VDA che aiuta gli amministratori Citrix e gli ingegneri del supporto a diagnosticare e risolvere i problemi di configurazione del reindirizzamento FIDO2 nelle sessioni HDX. Lo strumento raccoglie e visualizza i dati di configurazione chiave in formato JSON, consentendo una rapida identificazione di configurazioni errate delle policy, agganci di applicazioni mancanti e discrepanze di versione.
Lo strumento si trova in:
C:\Program Files\Citrix\HDX\bin\CtxFido2Diagnostics.exe
Il percorso dello strumento è incluso nelle variabili di ambiente di sistema durante l'installazione del VDA, quindi è possibile eseguirlo da qualsiasi directory digitando
CtxFido2Diagnostics.exe.
Requisiti
Host di sessione
-
Sistema operativo: Windows 10 1809 o versioni successive, Windows 11 21H2 o versioni successive, Windows Server 2019 o versioni successive
Dispositivo client
-
Sistema operativo: Windows 10 1809 o versioni successive
Informazioni visualizzate
Quando si esegue
CtxFido2Diagnostics.exe all'interno di una sessione HDX, lo strumento restituisce un oggetto JSON contenente le seguenti informazioni diagnostiche:
Versione CVAD
Visualizza la versione di Citrix Virtual Apps and Desktops installata sull'host della sessione. Utilizzare questa informazione per verificare che la versione del VDA supporti il reindirizzamento FIDO2 e le specifiche funzionalità WebAuthn richieste dalla propria distribuzione.
Esempio:
"CVAD Version": "2607.0.100.407"
Versione CWA
Visualizza la versione dell'app Citrix Workspace installata sul dispositivo client. Sia il VDA che l'app Citrix Workspace devono soddisfare i requisiti minimi di versione affinché il reindirizzamento FIDO2 funzioni correttamente.
Esempio:
"CWA Version": "CWA for Windows, 26.3.10.69"
Fido2PolicyEnabled
Indica se la policy di reindirizzamento FIDO2 è abilitata (
true) o disabilitata (false) per la sessione corrente. Quando questo valore è false, il reindirizzamento FIDO2 non funziona indipendentemente dalle altre impostazioni di configurazione.
Gli amministratori configurano questa policy tramite Citrix Studio o Criteri di gruppo Citrix in ICA > FIDO2.
Esempio:
"Fido2PolicyEnabled": true
ID sessione
Visualizza l'ID della sessione HDX corrente. Questo valore è utile per correlare l'output diagnostico con i log di sessione in Director o le voci del visualizzatore eventi durante la risoluzione dei problemi.
Esempio:
"Session ID": 2
Versione API WebAuthn
Visualizza la versione API WebAuthn supportata dalla combinazione corrente di CVAD e CWA. La versione API determina quali funzionalità FIDO2/WebAuthn sono disponibili per il reindirizzamento.
Esempio:
"WebAuthn API Version": 7
Impostazione del Registro di sistema dei processi consentiti FIDO2
Elenca i percorsi dei processi dell'applicazione configurati tramite il Registro di sistema sull'host di sessione a cui è consentito utilizzare il reindirizzamento FIDO2. Questi percorsi corrispondono al valore del Registro di sistema in:
HKLM\SOFTWARE\Citrix\CtxHook\AppInit_DLLs\CtxWebAuthnHook\
Questo elenco include in genere i browser supportati (Chrome, Edge, Firefox, Brave), il plug-in Azure AD Broker e il client Citrix ICA stesso. È incluso anche l'eseguibile dello strumento di diagnostica FIDO2 in modo che possa eseguire chiamate diagnostiche.
Impostazione dei criteri di Studio dei processi consentiti FIDO2
Elenca percorsi aggiuntivi dei processi dell'applicazione configurati dagli amministratori tramite l'impostazione dei criteri di Citrix Studio a cui è consentito utilizzare il reindirizzamento FIDO2. Queste voci integrano l'elenco basato sul Registro di sistema e consentono agli amministratori di aggiungere applicazioni personalizzate (come utilità di autenticazione di terze parti) senza modificare direttamente il Registro di sistema.
Applicazioni agganciabili per il reindirizzamento FIDO2
Elenca i nomi degli eseguibili delle applicazioni che il modulo di hooking FIDO2 ha identificato con successo e può intercettare per il reindirizzamento dell'API WebAuthn. Solo le applicazioni che compaiono in questo elenco avranno le loro richieste di autenticazione FIDO2 reindirizzate al dispositivo client.
Se un'applicazione compare nell'elenco dei processi consentiti ma non compare qui, il modulo di hooking non è riuscito ad agganciarsi ad essa. Ciò può indicare un problema di compatibilità, un'applicazione che non è attualmente in esecuzione o un problema di configurazione.
Informazioni correlate
Per una guida dettagliata sulla risoluzione dei problemi di reindirizzamento FIDO2 identificati da questo strumento, vedere Risolvere i problemi di reindirizzamento FIDO2.