Claves del registro del cliente VPN de Windows de NetScaler Gateway

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 Windows 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 formas siguientes.
  • El administrador puede implementar este registro a través de GPO mediante GPMC o SCCM push (o)
  • Mediante 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 de FQDN, rangos de direcciones IP o direcciones IP separados por punto y coma, permitidos 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 => Bloquea a los usuarios para que no cierren sesión ni se conecten a otras puertas de enlace.
 1
ConfigSize REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. Este registro se utiliza únicamente 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 Administrado por el cliente de Citrix Secure Access™. En caso de conexión exitosa, esta clave se establece en 1; si no, 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 utilizando 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 => El icono del complemento de NetScaler Gateway está integrado con la aplicación Citrix Workspace para Windows. El complemento de NetScaler Gateway no está visible en la barra de tareas cuando la sesión VPN completa está en ejecución.
 0
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.
  • 1 => El complemento VPN no agrega rutas explícitas para los servidores DNS.
 0
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 Microsoft Connect test 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 usando GPMC o un envío de SCCM. Si se establece en 1, no se realiza la inscripción de dispositivos Intune. 0
DisableWebViewForAutoLogon REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o un envío de SCCM o mediante un indicador de característica.
  • 1 => Oculta la postura del dispositivo o la pantalla de autenticación cuando se ejecuta en modo Always On.
  • 0 => La postura del dispositivo o las pantallas de autenticación aparecen cuando se ejecuta en modo Always On.
 0
EnableAdminConfigFetch REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM. Habilita la configuración de administración de aplicaciones cliente en el lado del cliente. 0
0 => Deshabilitar la funcionalidad de administración de aplicaciones cliente.
1 => Habilitar la funcionalidad de administración de aplicaciones cliente.
EnableAntiDllProtection REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o un envío de SCCM.
  • 1 => Habilitar la mejora de seguridad de inyección anti-DLL.
 0
Deshabilitar la mejora de seguridad de inyección anti-DLL.
EnableAutoUpdate REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o un envío de SCCM. 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.
EnableContextualAccess REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o mediante un envío de SCCM o un indicador de función.
  • 0 => Deshabilitar el acceso contextual en Secure Private Access
  • 1 => Habilitar el acceso contextual en Secure Private Access
 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 mediante 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
EnableMonitorDuringSleep REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o mediante un envío de SCCM.
  • 0 => Deshabilitar la supervisión de eventos de suspensión y activación cuando se modifican los eventos de energía en las máquinas del usuario final.
  • 1 => Habilitar la supervisión de eventos de suspensión y activación incluso cuando se modifican los eventos de energía en las máquinas del usuario final.
 0
EnableMultiSessionFlow REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o un envío de SCCM.
  • 0 => Deshabilitar 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.
1 => Habilitar el acceso a sistemas operativos multisecuencia en Citrix Secure Private Access
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 estar habilitado cuando IIP está presente. Los usuarios no deben modificar esta clave. 1
EnableWebModuleUI REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o mediante un envío de SCCM o a través de un indicador de función.
  • 1 => Habilita la interfaz de usuario mejorada con el Centro de notificaciones y WebView integrado.
  • 0 => Deshabilita la interfaz de usuario mejorada.
 0
EnableWFP REG_DWORD El administrador puede implementar este registro a través de GPO usando GPMC o mediante un envío de SCCM o a través de un indicador de función.
  • 1 => El complemento VPN usa WFP. A partir de la versión 25.1.1.27 del cliente Citrix Secure Access para Windows, WFP está habilitado de forma predeterminada.
  • 0 => El complemento VPN usa DNE.
 1
ExcludeDomainsFromRemoteDns REG_SZ El administrador puede implementar este registro a través de GPO mediante GPMC o un envío de SCCM. Excluye la resolución de DNS para que no la realice el cliente Citrix Secure Access a través de un servidor DNS remoto.
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. *.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 realizados los cambios, reinicie Citrix Secure Access o el sistema para que la configuración surta efecto.
Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
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 para que no se tunelice a través del cliente de 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 en 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.
HideLoginLogoutScriptsPrompt REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM o a través de un indicador de función.
  • 1 => Oculta la ejecución del script de inicio/cierre de sesión.
  • 0 => La ejecución del script de inicio/cierre de sesión es visible durante el establecimiento o la terminación del túnel de Citrix Secure Access.
 0
HttpTimeout REG_DWORD El administrador puede implementar este registro a través de GPO mediante GPMC o el envío de SCCM. El tiempo de espera HTTP se configura en segundos. Si no se configura el tiempo de espera, se utiliza el tiempo de espera predeterminado. El valor predeterminado del tiempo de espera es de 100 segundos, según los estándares de Windows. 100 segundos
InstallDir REG_SZ Administrado por el cliente de Citrix Secure Access. Ubicación donde está instalado el cliente de Citrix Secure Access. "C:\Program Files\Citrix\Secure Access Client"
IsAutoUpdateControlledViaAdmin REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o el envío de SCCM.
Se utiliza para elegir qué máquinas deben obtener automáticamente actualizaciones para la versión beta o la versión de producción del cliente de Citrix Secure Access para Windows.
  • 0 => El usuario final puede elegir actualizar a la versión beta o a la última versión de producción.
 Deshabilitado de forma predeterminada.
1 => El usuario final no tiene control para decidir entre versiones beta y de producción.
Nota:
Si la función de actualización automática está deshabilitada por el administrador mediante el registro EnableAutoUpdate, entonces el registro IsAutoUpdateControlledViaAdmin no tiene ningún efecto.
  • El registro IsAutoUpdateControlledViaAdmin está disponible en HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client\AutoUpdate.
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 inhabilitar 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 mediante GPMC o el envío de SCCM.
  • 1 => Permitir que el tráfico DNS IPv6 fluya a través de la VPN.
  • 0 => Restringir el flujo de tráfico DNS IPv6.
 Este registro no tiene un valor predeterminado, ya que se personaliza en función de la topología de red.
ProductVersion REG_SZ Administrado por el cliente de Citrix Secure Access. Versión actualmente instalada del cliente de Citrix Secure Access. Información de la versión del producto
ProductCode REG_SZ Administrado por el cliente de 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 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 un 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 un 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 usando GPMC o un envío de SCCM. Se utiliza en el contexto del servicio Always On, donde un cliente puede especificar la lista de CA para elegir el certificado de cliente. Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
UserTunnelFallbackEnabled REG_DWORD El administrador puede implementar este registro a través de GPO utilizando GPMC o un envío de SCCM. El mecanismo de reserva para Always On VPN cuando el túnel de la máquina no se puede establecer. Si la clave de registro UserTunnelFallbackEnabled está habilitada, el cliente de Citrix Secure Access intenta automáticamente formar un túnel de usuario incluso cuando el túnel de la máquina no se puede establecer.
Si se establece en 1, el parámetro UserTunnelFallbackEnabled está habilitado.
Este registro no tiene un valor predeterminado, ya que está configurado para una solución personalizada.
smartCardProviders REG_SZ El administrador puede implementar este registro a través de GPO utilizando GPMC o un envío de SCCM. Lista de proveedores de tarjetas inteligentes separados por punto y coma. vacío o NULO
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 en función de 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 Citrix Secure Access client para Windows 23.1.1.8 y versiones posteriores, el nombre de la clave de registro es overrideIPV6DnsDrop. Para Citrix Secure Access client para Windows 22.10.1.9 y versiones anteriores, el nombre de la clave de registro es overrideIP6DnsDrop.
  • A partir de Citrix Secure Access client para Windows 24.8.1.15, las claves de registro DisableGA, ForcedLogging y OverrideSpoofIPRange están obsoletas.
  • A partir de Citrix Secure Access client para Windows 24.8.1.19, el administrador puede habilitar VDI multisecuencia alojado en la nube en Citrix 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 máquinas unidas a un dominio, utilice los registros EnableMultiSessionFlow y AlwaysOnService.
  • A partir de Citrix Secure Access client para Windows 24.11.1.17, el administrador puede habilitar la función de actualización automática y elegir qué máquinas deben obtener actualizaciones automáticamente para la versión de acceso anticipado o la versión de producción mediante los registros EnableAutoUpdate y IsAutoUpdateControlledViaAdmin. Dado que la función de actualización automática se introdujo en Citrix Secure Access client para Windows versión 24.11.1.17, los administradores pueden utilizar esta función en las versiones posteriores.
  • A partir de Citrix Secure Access client para Windows 24.11.1.17, el administrador puede habilitar la función de acceso contextual en Secure Private Access mediante el registro EnableContextualAccess. La función de acceso contextual permite a un administrador aplicar directivas ZTNA dinámicamente en función del contexto del usuario, como la ubicación de red, la ubicación geográfica y el estado del dispositivo.
  • Para las versiones de Citrix Secure Access client para Windows anteriores a la 24.8.1.19, el administrador puede habilitar Microsoft Edge WebView mediante el registro EnableEdgeWebview.
  • A partir de Citrix Secure Access client para Windows versión 25.11.1.12, el administrador puede habilitar la interfaz de usuario mejorada con el Centro de notificaciones, WebView integrado y compatibilidad con portal cautivo mediante el registro EnableWebModuleUI.
  • A partir de la versión 25.11.1.12 del cliente de Citrix Secure Access, el administrador puede habilitar la mejora de seguridad de inyección anti-DLL mediante el registro EnableAntiDllProtection. Cuando está habilitada, protege al cliente de Citrix Secure Access de ciertas bibliotecas de vínculos dinámicos (DLL) no autorizadas o módulos no confiables. Si se inyectan dichos módulos no confiables, el cliente de Citrix Secure Access detecta estas intervenciones y evita que los módulos se carguen. Además, si se detecta alguna DLL no confiable o maliciosa durante el inicio de Citrix Secure Access, genera una notificación y finaliza el inicio de la aplicación.
  • A partir de la versión 25.11.1.12 del cliente de Citrix Secure Access, el administrador puede configurar el registro HideLoginLogoutScriptsPrompt para garantizar que el símbolo del sistema no parpadee cuando se ejecuten scripts de inicio o cierre de sesión durante el establecimiento o la terminación del túnel de Citrix Secure Access.
  • A partir de la versión 25.11.1.12 del cliente de Citrix Secure Access, el administrador puede configurar el registro DisableWebViewForAutoLogon para garantizar que el cliente de Citrix Secure Access oculte las pantallas de estado del dispositivo o de autenticación cuando se ejecuta en modo Always On. Esta funcionalidad solo es compatible con la nueva interfaz de usuario que se habilita mediante el registro EnableWebModuleUI.
  • A partir de la versión 25.11.1.12 del cliente de Citrix Secure Access para Windows, los administradores deben configurar el registro EnableAdminConfigFetch para habilitar la configuración de administración de aplicaciones cliente en el lado del cliente o ponerse en contacto con el soporte de Citrix. Para obtener más información, consulte Citrix Secure Access - Administración de aplicaciones cliente.
  • El registro UserTunnelFallbackEnabled está disponible a partir de la versión 26.1.1.9 del cliente de Citrix Secure Access para Windows.
Related information
Configuración de VPN en un dispositivo NetScaler Gateway