Clés de registre du client VPN Windows NetScaler Gateway

Dernière publication : Oct 14, 2026
Les clés de registre du client VPN sont disponibles sous HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client. Le tableau suivant répertorie les clés de registre, les valeurs et une brève description de chaque valeur du client VPN NetScaler Gateway.
Clé de registre Type de registre Contrôle du registre Valeurs et description Valeur par défaut
addedRoutes/modifiedRoutes REG_SZ Géré par le client Citrix Secure Access. Créé pour la communication interne des plug-ins. Les utilisateurs ne doivent pas modifier cette clé. Ce registre n'a pas de valeur par défaut.
AlwaysOnService REG_DWORD L'administrateur peut déployer ce registre via un objet de stratégie de groupe (GPO) à l'aide de la console de gestion des stratégies de groupe (GPMC) ou d'un déploiement (push) System Center Configuration Manager (SCCM).
  • 1 => Établir un tunnel au niveau de la machine mais pas un tunnel au niveau de l'utilisateur.
  • 2 => Établir soit un tunnel au niveau de la machine, soit un tunnel au niveau de l'utilisateur à tout moment.
  • 3 => Établir à la fois un tunnel au niveau de la machine et un tunnel au niveau de l'utilisateur pour activer le système d'exploitation multi-session dans Citrix Secure Private Access pour les machines jointes au domaine.
    Remarque : La prise en charge des fonctionnalités du système d'exploitation multi-session est en préversion.
Ce registre n'a pas de valeur par défaut.
AlwaysOnURL REG_SZ
Vous pouvez contrôler ce registre de l'une des deux manières suivantes.
  • L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM (ou)
  • Utilisation de la CLI. Pour plus d'informations, consultez la note*.
URL du serveur virtuel NetScaler Gateway auquel l'utilisateur souhaite se connecter. Exemple : https://xyz.companyDomain.com Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
^
AlwaysOn REG_DWORD À l'aide de la CLI. Pour plus d'informations, consultez la note*.
  • 1 => Autoriser l'accès réseau en cas d'échec du VPN.
  • 2=> Bloquer l'accès réseau en cas d'échec du VPN.
Cette clé de registre n'a pas de valeur par défaut.
AlwaysOnAllowlist REG_SZ L'administrateur peut déployer cette clé de registre via une GPO à l'aide de GPMC ou d'un déploiement SCCM. Liste de FQDN, de plages d'adresses IP ou d'adresses IP séparées par des points-virgules, autorisées par le pilote en mode strict Always On. Exemples : example.citrix.com;192.0.2.0;192.0.2.100-192.0.2.255 vide ou NULL
ClientControl REG_DWORD À l'aide de la CLI. Pour plus d'informations, consultez la note*.
  • 1 => Permet aux utilisateurs de se déconnecter ou de se connecter à d'autres passerelles.
  • 0 => Empêche les utilisateurs de se déconnecter ou de se connecter à d'autres passerelles.
1
ConfigSize REG_DWORD L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM. Ce registre est utilisé uniquement pour Citrix Secure Private Access. Le client Windows prend en charge une taille de fichier de configuration de 64 Ko par défaut. Utilisez ce registre pour augmenter la taille du fichier de configuration.
Si la taille du fichier de configuration dépasse la valeur par défaut de 64 Ko, définissez la valeur de registre ConfigSize à 5 fois 64 Ko (en octets) pour chaque 64 Ko supplémentaire.
Par exemple, si vous ajoutez 64 Ko supplémentaires, vous devez définir la valeur de registre sur 64 x 1024 x 5 = 327680. De même, si vous ajoutez 128 Ko, vous devez définir la valeur de registre sur 64 x 1024 x (5+5) = 655360.
64 Ko
Connecté REG_DWORD Géré par le client Citrix Secure Access. Lors d'une connexion réussie, cette clé est définie sur 1 ; sinon, elle est définie sur 0. Cette clé est utilisée en interne. Les utilisateurs ne doivent pas modifier cette clé. Ce registre n'a pas de valeur par défaut.
DisableCredProv REG_DWORD L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM. Lorsque le VPN AlwaysOn avant l'ouverture de session Windows est activé, le plug-in VPN Windows ajoute le fournisseur d'informations d'identification pour afficher l'état du tunnel sur l'écran de connexion. Si vous n'avez pas besoin de cette fonctionnalité supplémentaire, créez et définissez ce registre sur 1. 0
DisableIconHide REG_DWORD À l'aide de la CLI : set vpn parameter iconWithReceiver ON
  • 1 => L'application Citrix Workspace et le plug-in NetScaler Gateway sont affichés dans la barre des tâches.
  • 0 => L'icône du plug-in NetScaler Gateway est intégrée à l'application Citrix Workspace pour Windows. Le plug-in NetScaler Gateway n'est pas visible dans la barre des tâches lorsque la session VPN complète est en cours d'exécution.
0
DisableDNSRoutes REG_DWORD L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM.
  • 0 => Valeur par défaut. Le plug-in VPN ajoute des routes pour les serveurs DNS s'ils sont différents de la passerelle par défaut pour une interface physique. Cependant, en fonction de la topologie réseau de la machine cliente Windows, les routes des serveurs DNS peuvent ne pas toujours être nécessaires.
  • 1 => Le plug-in VPN n'ajoute pas de routes explicites pour les serveurs DNS.
0
DisallowCaptivePortals REG_DWORD L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM.
  • 1 => Le plug-in VPN vérifie les portails captifs en essayant de se connecter à la page Microsoft Connect test avant de démarrer une session VPN.
  • 0 => Le plug-in VPN ignore la vérification des portails captifs.
0
DisableIntuneDeviceEnrollment REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Si la valeur est définie sur 1, l'inscription de l'appareil Intune n'est pas effectuée. 0
EnableAutoUpdate REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM.
Utilisé pour contrôler la fonctionnalité de mise à jour du plug-in côté client.
  • 0 => Désactiver la fonctionnalité de mise à jour automatique.
  • 1 => Activer la fonctionnalité de mise à jour automatique.
    Remarque :
    Cette clé de registre est disponible sous HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client\AutoUpdate.
0
EnableEdgeWebview REG_DWORD L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un push SCCM.
  • 0 => Désactiver Microsoft Edge WebView.
  • 1 => Activer Microsoft Edge WebView.
1
EnableKerberosAuth REG_DWORD L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un push SCCM.
  • 0 => Valeur par défaut.
  • 1 => Le client VPN utilise la méthode d'authentification Kerberos pour la connexion automatique.
0
EnableMultiSessionFlow REG_DWORD L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un push SCCM.
  • 0 => Désactiver l'accès au système d'exploitation multi-session dans Citrix Secure Private Access
  • 1 => Activer l'accès au système d'exploitation multi-session dans Citrix Secure Private Access
Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
EnableTCPDNS REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM.
  • 0 => Désactive la prise en charge du DNS fractionné pour les requêtes DNS basées sur TCP.
  • 1 => Active la prise en charge du DNS fractionné pour les requêtes DNS basées sur TCP.
1
EnableVA REG_DWORD Géré par le client Citrix Secure Access. Cette clé est utilisée en interne si l'adaptateur virtuel Citrix doit être activé lorsque IIP est présent. Les utilisateurs ne doivent pas modifier cette clé. 1
EnableWFP REG_DWORD L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM ou via un indicateur de fonctionnalité.
  • 1 => Le plug-in VPN utilise WFP. À partir de la version 25.1.1.27 du client Citrix Secure Access pour Windows, WFP est activé par défaut.
  • 0 => Le plug-in VPN utilise DNE.
1
ExcludeDomainsFromRemoteDns REG_SZ L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Exclut la résolution DNS d'être effectuée par le client Citrix Secure Access via un serveur DNS distant.
Si example.com est un domaine intranet et que vous souhaitez exclure des applications spécifiques comme sshhost.example.com, rdphost.example.com ou *.ftphost.example.com, utilisez ce registre. *.ftphost.example.com est un modèle générique qui correspond à tout sous-domaine sous ftphost.example.com.
Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
Veillez à ajuster les noms de domaine et les modèles en fonction de vos besoins. Une fois les modifications effectuées, redémarrez Citrix Secure Access ou le système pour que les paramètres prennent effet.
ExcludeDomainsFromTunnel (Aperçu) REG_SZ L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un déploiement SCCM. Exclut le trafic de domaines spécifiques du tunnel via le client Citrix Secure Access. Si example.com est un domaine intranet et que vous souhaitez exclure des applications spécifiques comme sshhost.example.com, rdphost.example.com ou *.ftphost.example.com, utilisez cette clé de registre. Veillez à définir la valeur de la clé de registre comme une liste de noms de domaine ou de modèles séparés par des virgules. Cette clé de registre n'a pas de valeur par défaut car elle est configurée pour une solution personnalisée.
HttpTimeout REG_DWORD L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un déploiement SCCM. Le délai d'expiration HTTP est configuré en secondes. Si le délai d'expiration n'est pas configuré, le délai d'expiration par défaut est utilisé. La valeur par défaut du délai d'expiration est de 100 secondes, conformément aux normes Windows. 100 secondes
InstallDir REG_SZ Géré par le client Citrix Secure Access. Emplacement où le client Citrix Secure Access est installé. "C:\Program Files\Citrix\Secure Access Client"
locationDetection REG_DWORD Utilisation de l'interface de ligne de commande. Pour plus d'informations, consultez la note*.
  • 1 => Pour activer la détection de localisation.
  • 0 => Pour désactiver la détection de localisation.
Ce registre n'a pas de valeur par défaut et n'est configuré que lorsque le mode Always On est activé.
NoDHCPRoute REG_DWORD
  1. À partir de l'appliance NetScaler, créez un nouveau fichier nommé pluginCustomization.json avec la valeur \{ "NoDHCPRoute" : true }.
  2. Placez le fichier pluginCustomization.json dans les dossiers /netscaler/ns_gui/vpn et /var/netscaler/gui/vpn.
Si défini sur 1, la route du serveur DHCP n'est pas ajoutée. Ce registre n'a pas de valeur par défaut car il est personnalisé en fonction de la topologie du réseau.
overrideIPV6DnsDrop REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM.
  • 1 => Autoriser le trafic DNS IPv6 à transiter par le VPN.
  • 0 => Restreindre le flux de trafic DNS IPv6.
Ce registre n'a pas de valeur par défaut car il est personnalisé en fonction de la topologie du réseau.
ProductVersion REG_SZ Géré par le client Citrix Secure Access. Version actuellement installée du client Citrix Secure Access. Informations sur la version du produit
ProductCode REG_SZ Géré par le client Citrix Secure Access. Cette clé est utilisée en interne. Les utilisateurs ne doivent pas modifier cette clé. {B04137FF-B5C9-4058-ACEB-04118790118D}
secureDNSUpdate REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un déploiement SCCM.
  • 0 => Le plug-in VPN tente uniquement la mise à jour DNS non sécurisée.
  • 1 => Le plug-in VPN tente d'abord la mise à jour DNS non sécurisée. Si la mise à jour DNS non sécurisée échoue, le plug-in VPN tente alors la mise à jour DNS sécurisée. C'est le comportement par défaut à partir de la version 21.3.1.2 du plug-in Windows.
  • 2 => Le plug-in VPN tente uniquement la mise à jour DNS sécurisée.
1
SecureChannelResetTimeoutSeconds REG_DWORD L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Par défaut, cette valeur de registre n'est pas définie ou ajoutée. Lorsque la valeur de SecureChannelResetTimeoutSeconds est 0xFFFFFFFF ou n'est pas présente dans le registre, le plug-in VPN attend que l'appel d'API SecureChannelReset() soit terminé avant de commencer à acheminer le trafic de données. C'est le comportement par défaut. L'administrateur doit définir ce registre sur le client pour que le plug-in VPN commence à acheminer le trafic de données après avoir attendu le temps spécifié pour que l'appel d'API se termine. Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
SecureAccessLogInScript REG_SZ L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Le service Citrix Secure Access accède à la configuration du script de connexion à l'aide de cette clé de registre lorsqu'il se connecte au service Citrix Secure Private Access. Pour plus de détails, consultez Registres de configuration des scripts de connexion et de déconnexion. Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
SecureAccessLogOutScript REG_SZ L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Le service Citrix Secure Access accède à la configuration du script de déconnexion à l'aide de cette clé de registre lorsqu'il se connecte au service Citrix Secure Private Access. Pour plus de détails, consultez Registres de configuration des scripts de connexion et de déconnexion. Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
suffixList REG_SZ À l'aide de la CLI : add dns suffix Liste de domaines intranet séparés par des points-virgules. Utilisé lorsque la détection de localisation est activée. Récupère la valeur du suffixe DNS configuré sur le serveur.
SicBeginPort REG_DWORD
  1. Depuis l'appliance NetScaler, créez un nouveau fichier nommé pluginCustomization.json avec la valeur \{"SicBeginPort" : 51000}.
  2. Placez le fichier pluginCustomization.json dans les dossiers /netscaler/ns_gui/vpn et /var/netscaler/gui/vpn.
Évite les conflits qui pourraient survenir lorsque vous utilisez des ports pour créer des sockets entre le client Citrix Secure Access et des applications tierces sur les machines clientes. La plage autorisée est 49152–64535 (C000 à FC17 en format hexadécimal). Le client VPN utilise jusqu'à 1000 ports à partir de SicBeginPort uniquement si EnableWFP est également défini sur 1. Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
userCertCAList REG_SZ L'administrateur peut déployer ce registre via GPO en utilisant GPMC ou un push SCCM. Utilisé dans le contexte du service Always On où un client peut spécifier la liste des autorités de certification à partir desquelles choisir le certificat client. Ce registre n'a pas de valeur par défaut car il est configuré pour une solution personnalisée.
Remarque :
*Utilisez la commande suivante pour appliquer les clés de registre AlwaysOnURL, AlwaysOn, ClientControl et locationDetection à l'aide de l'interface de ligne de commande :
add alwaysONProfile <alwaysONProfileName>-clientControl ( ALLOW | DENY )-locationBasedVPN ( Remote | Everywhere )-networkAccessOnVPNFailure ( onlyToGateway | fullAccess )
Important :
  • Vous pouvez appliquer des clés de registre en fonction de vos déploiements. Par exemple, la clé de registre AlwaysOnService s'applique uniquement au service Always On, tandis que la clé de registre ClientControl ne s'applique pas au service Always On. Reportez-vous à la documentation de déploiement individuelle pour plus de détails.
  • secureDNSUpdate s'applique uniquement aux périphériques clients joints à un domaine.
  • Pour le client Citrix Secure Access pour Windows 23.1.1.8 et les versions ultérieures, le nom de la clé de registre est overrideIPV6DnsDrop. Pour le client Citrix Secure Access pour Windows 22.10.1.9 et les versions antérieures, le nom de la clé de registre est overrideIP6DnsDrop.
  • À partir du client Citrix Secure Access pour Windows 24.8.1.15, les clés de registre DisableGA, ForcedLogging et OverrideSpoofIPRange sont obsolètes.
  • À partir du client Citrix Secure Access pour Windows 24.8.1.19, l'administrateur peut activer le VDI multi-session hébergé dans le cloud dans Secure Private Access à l'aide du registre EnableMultiSessionFlow pour un accès contextuel aux ressources en fonction de leur emplacement, de leur appareil et d'autres facteurs. Pour les machines jointes à un domaine, utilisez les registres EnableMultiSessionFlow et AlwaysOnService.
  • Pour les versions du client Citrix Secure Access pour Windows antérieures à 24.8.1.19, l'administrateur peut activer Microsoft Edge WebView à l'aide du registre EnableEdgeWebview.