Clés de registre du client VPN Windows NetScaler Gateway
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). |
|
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.
|
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*. |
|
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 |
| 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 |
|
0 |
| DisableDNSRoutes | REG_DWORD | L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM. |
|
0 |
| DisallowCaptivePortals | REG_DWORD | L'administrateur peut déployer ce registre via GPO à l'aide de GPMC ou d'un push SCCM. |
|
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 |
| EnableEdgeWebview | REG_DWORD | L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un push SCCM. |
|
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 |
| EnableMultiSessionFlow | REG_DWORD | L'administrateur peut déployer cette clé de registre via GPO à l'aide de GPMC ou d'un push SCCM. |
|
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. |
|
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 |
| 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*. |
|
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 |
|
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. |
|
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. |
|
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 |
|
É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
AlwaysOnServices'applique uniquement au service Always On, tandis que la clé de registreClientControlne s'applique pas au service Always On. Reportez-vous à la documentation de déploiement individuelle pour plus de détails. -
secureDNSUpdates'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 estoverrideIP6DnsDrop. -
À partir du client Citrix Secure Access pour Windows 24.8.1.15, les clés de registre
DisableGA,ForcedLoggingetOverrideSpoofIPRangesont 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
EnableMultiSessionFlowpour 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 registresEnableMultiSessionFlowetAlwaysOnService. -
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.