Claves del registro del cliente VPN de NetScaler Gateway para Windows

Last published : Oct 14, 2026
Las claves del registro del cliente VPN están disponibles en HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client. La siguiente tabla enumera las claves del registro del cliente VPN de NetScaler Gateway, sus valores y una breve descripción de cada valor.
Clave del registro Tipo de registro Control de registro Valores y descripción Valor predeterminado
addedRoutes/modifiedRoutes REG_SZ Administrado por el cliente Citrix Secure Access. Creado para la comunicación interna del complemento. Los usuarios no deben modificar esta clave. Este registro no tiene un valor predeterminado.
AlwaysOnService REG_DWORD El administrador puede implementar este registro a través de un objeto de directiva de grupo (GPO) mediante la Consola de administración de directivas de grupo (GPMC) o la inserción de System Center Configuration Manager (SCCM).
  • 1 => Establecer un túnel a nivel de máquina pero no un túnel a nivel de usuario.
  • 2 => Establecer un túnel a nivel de máquina o un túnel a nivel de usuario en cualquier momento.
  • 3 => Establecer un túnel a nivel de máquina y un túnel a nivel de usuario para habilitar el SO multisecuencia en Citrix Secure Private Access para máquinas unidas a un dominio.
    Nota: La compatibilidad con la función de SO multisecuencia está en versión preliminar.
Este registro no tiene un valor predeterminado.
AlwaysOnURL REG_SZ
Puede controlar este registro de una de las dos maneras siguientes.
  • El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push (o)
  • Uso de la CLI. Para obtener más información, consulte la nota*.
 URL del servidor virtual de NetScaler Gateway al que el usuario desea conectarse. Ejemplo: https://xyz.companyDomain.com Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
AlwaysOn REG_DWORD Mediante la CLI. Para obtener más información, consulte la nota*.
  • 1 => Permitir el acceso a la red en caso de fallo de la VPN.
  • 2=> Bloquear el acceso a la red en caso de fallo de la VPN.
 Este registro no tiene un valor predeterminado.
AlwaysOnAllowlist REG_SZ El administrador puede implementar este registro a través de GPO mediante GPMC o el envío de SCCM. Lista separada por punto y coma de FQDN, rangos de direcciones IP o direcciones IP permitidas por el controlador en modo estricto Always On. Ejemplos: example.citrix.com;192.0.2.0;192.0.2.100-192.0.2.255 vacío o NULO
ClientControl REG_DWORD Uso de la CLI. Para obtener más información, consulte la nota*.
  • 1 => Permite a los usuarios cerrar sesión o conectarse a otras puertas de enlace.
  • 0 => Impide a los usuarios cerrar sesión o conectarse a otras puertas de enlace.
 1
ConfigSize REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o SCCM push. Este registro se utiliza solo para Citrix Secure Private Access. El cliente de Windows admite un tamaño de archivo de configuración de 64 KB de forma predeterminada. Utilice este registro para aumentar el tamaño del archivo de configuración.
Si el tamaño del archivo de configuración supera el valor predeterminado de 64 KB, establezca el valor del registro ConfigSize en 5 veces 64 KB (en bytes) por cada 64 KB adicionales.
Por ejemplo, si va a añadir 64 KB adicionales, debe establecer el valor del registro en 64 x 1024 x 5 = 327680. Del mismo modo, si va a añadir 128 KB, debe establecer el valor del registro en 64 x 1024 x (5+5) = 655360.
64 KB
Conectado REG_DWORD Gestionado por el cliente de Citrix Secure Access. Si la conexión es correcta, esta clave se establece en 1; de lo contrario, se establece en 0. Esta clave se utiliza internamente. Los usuarios no deben modificar esta clave. Este registro no tiene un valor predeterminado.
DisableCredProv REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o un envío de SCCM. Cuando AlwaysOn VPN antes del inicio de sesión de Windows está habilitado, el complemento VPN de Windows agrega el proveedor de credenciales para mostrar el estado del túnel en la pantalla de inicio de sesión. Si no necesita esta funcionalidad adicional, cree y establezca este registro en 1. 0
DisableIconHide REG_DWORD Mediante CLI: set vpn parameter iconWithReceiver ON
  • 1 => La aplicación Citrix Workspace y el complemento NetScaler Gateway se muestran en la barra de tareas.
 0
0 => El icono del complemento de NetScaler Gateway está integrado con la aplicación Citrix Workspace para Windows. El complemento de NetScaler Gateway no es visible en la barra de tareas cuando la sesión VPN completa está en ejecución.
DisableDNSRoutes REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o el envío de SCCM.
  • 0 => Valor predeterminado. El complemento VPN agrega rutas para los servidores DNS si son diferentes de la puerta de enlace predeterminada para una interfaz física. Sin embargo, según la topología de red de la máquina cliente de Windows, es posible que las rutas del servidor DNS no siempre sean necesarias.
 0
1 => El complemento VPN no agrega rutas explícitas para los servidores DNS.
DisallowCaptivePortals REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o el envío de SCCM.
  • 1 => El complemento VPN comprueba si hay portales cautivos intentando conectarse a la página (http://www.msftconnecttest.com/connecttest.txt) de prueba de Microsoft Connect antes de iniciar una sesión VPN.
  • 0 => El complemento VPN omite la comprobación de portales cautivos.
 0
DisableIntuneDeviceEnrollment REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push. Si se establece en 1, no se realiza la inscripción de dispositivos Intune. 0
EnableAutoUpdate REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push.
Se utiliza para controlar la funcionalidad de actualización del complemento desde el lado del cliente.
  • 0 => Deshabilitar la funcionalidad de actualización automática.
  • 1 => Habilitar la funcionalidad de actualización automática.
    Nota:
    Esta clave de registro está disponible en HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client\AutoUpdate.
0
EnableEdgeWebview REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o mediante un envío de SCCM.
  • 0 => Deshabilitar Microsoft Edge WebView.
  • 1 => Habilitar Microsoft Edge WebView.
 1
EnableKerberosAuth REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o un envío de SCCM.
  • 0 => Valor predeterminado.
  • 1 => El cliente VPN utiliza el método de autenticación Kerberos para el inicio de sesión automático.
 0
EnableMultiSessionFlow REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o un envío de SCCM.
  • 0 => Deshabilitar el acceso al SO multisecuencia en Citrix Secure Private Access
  • 1 => Habilitar el acceso al SO multisecuencia en Citrix Secure Private Access
 Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
EnableTCPDNS REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o el envío de SCCM.
  • 0 => Deshabilita la compatibilidad con DNS dividido para solicitudes DNS basadas en TCP.
  • 1 => Habilita la compatibilidad con DNS dividido para solicitudes DNS basadas en TCP.
 1
EnableVA REG_DWORD Administrado por el cliente de Citrix Secure Access. Esta clave se utiliza internamente si el adaptador virtual de Citrix debe habilitarse cuando IIP está presente. Los usuarios no deben modificar esta clave. 1
EnableWFP REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push o mediante un indicador de función.
  • 1 => El complemento VPN utiliza WFP. A partir de la versión 25.1.1.27 del cliente de Citrix Secure Access para Windows, WFP está habilitado de forma predeterminada.
 1
0 => El complemento VPN utiliza DNE.
ExcludeDomainsFromRemoteDns REG_SZ El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push. Excluye la resolución DNS de ser realizada por el cliente de Citrix Secure Access a través de un servidor DNS remoto. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
Si example.com es un dominio de intranet y quiere excluir aplicaciones específicas como sshhost.example.com, rdphost.example.com o *.ftphost.example.com, utilice este registro. *.ftphost.example.com es un patrón comodín que coincide con cualquier subdominio bajo ftphost.example.com.
Asegúrese de ajustar los nombres de dominio y los patrones según sus requisitos. Una vez que haya realizado los cambios, reinicie Citrix Secure Access o el sistema para que la configuración surta efecto.
ExcludeDomainsFromTunnel (Vista previa) REG_SZ El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. Excluye el tráfico de dominios específicos de ser tunelizado a través del cliente Citrix Secure Access. Si example.com es un dominio de intranet y desea excluir aplicaciones específicas como sshhost.example.com, rdphost.example.com o *.ftphost.example.com, utilice este registro. Asegúrese de establecer el valor del registro como una lista de nombres de dominio o patrones separados por comas. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
HttpTimeout REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. El tiempo de espera HTTP se configura en segundos. Si el tiempo de espera no está configurado, se utiliza el tiempo de espera predeterminado. El valor de tiempo de espera predeterminado es de 100 segundos, según los estándares de Windows. 100 segundos
InstallDir REG_SZ Administrado por el cliente Citrix Secure Access. Ubicación donde está instalado el cliente de Citrix Secure Access. "C:\Program Files\Citrix\Secure Access Client"
locationDetection REG_DWORD Uso de la CLI. Para obtener más información, consulte la nota*.
  • 1 => Para habilitar la detección de ubicación.
  • 0 => Para deshabilitar la detección de ubicación.
 Este registro no tiene un valor predeterminado y solo se configura cuando el modo Always On está habilitado.
NoDHCPRoute REG_DWORD
  1. Desde el dispositivo NetScaler, cree un nuevo archivo llamado pluginCustomization.json con el valor \{ "NoDHCPRoute" : true }.
  2. Coloque el archivo pluginCustomization.json en las carpetas /netscaler/ns_gui/vpn y /var/netscaler/gui/vpn.
 Si se establece en 1, no se añade la ruta del servidor DHCP. Este registro no tiene un valor predeterminado, ya que se personaliza en función de la topología de red.
overrideIPV6DnsDrop REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o SCCM push.
  • 1 => Permite que el tráfico DNS IPv6 fluya a través de la VPN.
 Este registro no tiene un valor predeterminado, ya que se personaliza en función de la topología de red.
0 => Restringir el flujo de tráfico DNS IPv6.
ProductVersion REG_SZ Administrado por el cliente Citrix Secure Access. Versión actualmente instalada del cliente Citrix Secure Access. Información de la versión del producto
ProductCode REG_SZ Administrado por el cliente Citrix Secure Access. Esta clave se utiliza internamente. Los usuarios no deben modificar esta clave. {B04137FF-B5C9-4058-ACEB-04118790118D}
secureDNSUpdate REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push.
  • 0 => El complemento VPN solo intenta la actualización DNS no segura.
  • 1 => El complemento VPN intenta primero la actualización DNS no segura. Si la actualización DNS no segura falla, el complemento VPN intenta entonces la actualización DNS segura. Este es el comportamiento predeterminado a partir de la compilación 21.3.1.2 del complemento de Windows.
  • 2 => El complemento VPN solo intenta la actualización DNS segura.
 1
SecureChannelResetTimeoutSeconds REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. Por defecto, este valor de registro no está establecido ni añadido. Cuando el valor de SecureChannelResetTimeoutSeconds es 0xFFFFFFFF o no está presente en el registro, el complemento VPN espera a que la llamada a la API SecureChannelReset() se complete antes de empezar a tunelizar el tráfico de datos. Este es el comportamiento predeterminado. El administrador debe establecer este registro en el cliente para que el complemento VPN comience a tunelizar el tráfico de datos después de esperar el tiempo especificado para que la llamada a la API se complete. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
SecureAccessLogInScript REG_SZ El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. El servicio Citrix Secure Access accede a la configuración del script de inicio de sesión utilizando esta clave de registro cuando se conecta al servicio Citrix Secure Private Access. Para obtener más información, consulte Registros de configuración de scripts de inicio y cierre de sesión. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
SecureAccessLogOutScript REG_SZ El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. El servicio Citrix Secure Access accede a la configuración del script de cierre de sesión utilizando esta clave de registro cuando se conecta al servicio Citrix Secure Private Access. Para obtener más información, consulte Registros de configuración de scripts de inicio y cierre de sesión. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
suffixList REG_SZ Mediante CLI: add dns suffix Lista de dominios de intranet separados por punto y coma. Se utiliza cuando la detección de ubicación está habilitada. Recupera el valor del sufijo DNS configurado en el servidor.
SicBeginPort REG_DWORD
  1. Desde el dispositivo NetScaler, cree un nuevo archivo llamado pluginCustomization.json con el valor \{"SicBeginPort" : 51000}.
  2. Coloque el archivo pluginCustomization.json en las carpetas /netscaler/ns_gui/vpn y /var/netscaler/gui/vpn.
 Evita conflictos que puedan surgir al usar puertos para crear sockets entre el cliente de Citrix Secure Access y aplicaciones de terceros en las máquinas cliente. El rango permitido es 49152–64535 (C000 a FC17 en formato hexadecimal). El cliente VPN utiliza hasta 1000 puertos a partir de SicBeginPort solo si EnableWFP también está configurado en 1. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
userCertCAList REG_SZ El administrador puede implementar este registro a través de GPO utilizando GPMC o SCCM push. Se utiliza en el contexto del servicio Always On, donde un cliente puede especificar la lista de CA de las que elegir el certificado de cliente. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
Nota:
*Utilice el siguiente comando para aplicar las claves de registro AlwaysOnURL, AlwaysOn, ClientControl y locationDetection mediante la CLI:
add alwaysONProfile <alwaysONProfileName>-clientControl ( ALLOW | DENY )-locationBasedVPN ( Remote | Everywhere )-networkAccessOnVPNFailure ( onlyToGateway | fullAccess )
Importante:
  • Puede aplicar claves de registro según sus implementaciones. Por ejemplo, la clave de registro AlwaysOnService solo es aplicable al servicio Always On, mientras que la clave de registro ClientControl no es aplicable al servicio Always On. Consulte la documentación de implementación individual para obtener más detalles.
  • secureDNSUpdate solo es aplicable a dispositivos cliente unidos a un dominio.
  • Para el cliente Citrix Secure Access para Windows 23.1.1.8 y versiones posteriores, el nombre de la clave de registro es overrideIPV6DnsDrop. Para el cliente Citrix Secure Access para Windows 22.10.1.9 y versiones anteriores, el nombre de la clave de registro es overrideIP6DnsDrop.
  • A partir del cliente Citrix Secure Access para Windows 24.8.1.15, las claves de registro DisableGA, ForcedLogging y OverrideSpoofIPRange están obsoletas.
  • A partir del cliente Citrix Secure Access para Windows 24.8.1.19, el administrador puede habilitar VDI multisecuencia alojado en la nube en Secure Private Access mediante el registro EnableMultiSessionFlow para el acceso contextual a los recursos en función de su ubicación, dispositivo y otros factores. Para las máquinas unidas a un dominio, utilice los registros EnableMultiSessionFlow y AlwaysOnService.
  • Para el cliente Citrix Secure Access para Windows en versiones anteriores a la 24.8.1.19, el administrador puede habilitar Microsoft Edge WebView mediante el registro EnableEdgeWebview.
Related information
Configuración de VPN en un dispositivo NetScaler Gateway