NetScaler Gateway Windows VPN-Client-Registrierungsschlüssel

Last published : Oct 14, 2026
Die VPN-Client-Registrierungsschlüssel sind unter HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client verfügbar. Die folgende Tabelle listet die NetScaler Gateway VPN-Client-Registrierungsschlüssel, Werte und eine kurze Beschreibung jedes Werts auf.
Registrierungsschlüssel Registrierungstyp Registrierungssteuerung Werte und Beschreibung Standardwert
addedRoutes/modifiedRoutes REG_SZ Verwaltet vom Citrix Secure Access Client. Erstellt für die interne Plug-in-Kommunikation. Benutzer dürfen diesen Schlüssel nicht ändern. Diese Registrierung hat keinen Standardwert.
AlwaysOnService REG_DWORD Der Administrator kann diese Registrierung über ein Gruppenrichtlinienobjekt (GPO) mithilfe der Gruppenrichtlinienverwaltungskonsole (GPMC) oder per System Center Configuration Manager (SCCM)-Push bereitstellen.
  • 1 => Einen Tunnel auf Maschinenebene, aber keinen Tunnel auf Benutzerebene herstellen.
  • 2 => Entweder einen Tunnel auf Maschinenebene oder einen Tunnel auf Benutzerebene zu einem beliebigen Zeitpunkt herstellen.
  • 3 => Sowohl einen Tunnel auf Maschinenebene als auch einen Tunnel auf Benutzerebene herstellen, um Multi-Session-Betriebssysteme in Citrix Secure Private Access für in die Domäne eingebundene Maschinen zu ermöglichen.
    Hinweis: Die Unterstützung für Multi-Session-Betriebssystemfunktionen befindet sich in der Vorschau.
Diese Registrierung hat keinen Standardwert.
AlwaysOnURL REG_SZ
Sie können diese Registrierung auf eine der folgenden zwei Arten steuern.
  • Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen (oder)
  • Über die CLI. Weitere Informationen finden Sie unter Hinweis*.
 URL des virtuellen NetScaler Gateway-Servers, mit dem sich der Benutzer verbinden möchte. Beispiel: https://xyz.companyDomain.com Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
AlwaysOn REG_DWORD Verwendung der CLI. Weitere Informationen finden Sie unter Hinweis*.
  • 1 => Netzwerkzugriff bei VPN-Fehler zulassen.
  • 2=> Netzwerkzugriff bei VPN-Fehler blockieren.
 Dieser Registrierungsschlüssel hat keinen Standardwert.
AlwaysOnAllowlist REG_SZ Der Administrator kann diesen Registrierungsschlüssel über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Semikolon-getrennte Liste von FQDNs, IP-Adressbereichen oder IP-Adressen, die vom Treiber im Always-On-Strict-Modus zugelassen werden. Beispiele: example.citrix.com;192.0.2.0;192.0.2.100-192.0.2.255 leer oder NULL
ClientControl REG_DWORD Verwendung der CLI. Weitere Informationen finden Sie unter Hinweis*.
  • 1 => Ermöglicht Benutzern, sich abzumelden oder sich mit anderen Gateways zu verbinden.
  • 0 => Blockiert Benutzer daran, sich abzumelden oder sich mit anderen Gateways zu verbinden.
 1
ConfigSize REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. Diese Registrierung wird nur für Citrix Secure Private Access verwendet. Der Windows-Client unterstützt standardmäßig eine Konfigurationsdateigröße von 64 KB. Verwenden Sie diese Registrierung, um die Konfigurationsdateigröße zu erhöhen.
Wenn die Konfigurationsdateigröße den Standardwert von 64 KB überschreitet, setzen Sie den Registrierungswert ConfigSize auf das 5-fache von 64 KB (in Bytes) für jede zusätzlichen 64 KB.
Zum Beispiel, wenn Sie zusätzliche 64 KB hinzufügen, dann müssen Sie den Registrierungswert auf 64 x 1024 x 5 = 327680 setzen. Ebenso, wenn Sie 128 KB hinzufügen, dann müssen Sie den Registrierungswert auf 64 x 1024 x (5+5) = 655360 setzen.
64 KB
Verbunden REG_DWORD Verwaltet vom Citrix Secure Access Client. Bei erfolgreicher Verbindung wird dieser Schlüssel auf 1 gesetzt, andernfalls auf 0. Dieser Schlüssel wird intern verwendet. Benutzer dürfen diesen Schlüssel nicht ändern. Diese Registrierung hat keinen Standardwert.
DisableCredProv REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. Wenn AlwaysOn VPN vor der Windows-Anmeldung aktiviert ist, fügt das Windows VPN-Plug-in den Anmeldeinformationsanbieter hinzu, um den Tunnelstatus auf dem Anmeldebildschirm anzuzeigen. Wenn Sie diese zusätzliche Funktionalität nicht benötigen, erstellen und setzen Sie diesen Registrierungseintrag auf 1. 0
DisableIconHide REG_DWORD Verwendung der CLI: set vpn parameter iconWithReceiver ON
  • 1 => Die Citrix Workspace-App und das NetScaler Gateway-Plug-in werden in der Taskleiste angezeigt.
  • 0 => Das NetScaler Gateway Plug-in-Symbol ist in die Citrix Workspace-App für Windows integriert. Das NetScaler Gateway Plug-in ist in der Taskleiste nicht sichtbar, wenn die vollständige VPN-Sitzung ausgeführt wird.
 0
DisableDNSRoutes REG_DWORD Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen.
  • 0 => Standardwert. Das VPN-Plug-in fügt Routen für DNS-Server hinzu, wenn diese sich vom Standard-Gateway für eine physische Schnittstelle unterscheiden. Basierend auf der Netzwerktopologie des Windows-Clientcomputers sind DNS-Serverrouten jedoch möglicherweise nicht immer erforderlich.
  • 1 => Das VPN-Plug-in fügt keine expliziten Routen für die DNS-Server hinzu.
 0
DisallowCaptivePortals REG_DWORD Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen.
  • 1 => VPN-Plug-in prüft auf Captive Portals, indem es versucht, eine Verbindung zur Microsoft Connect-Testseite herzustellen, bevor eine VPN-Sitzung gestartet wird.
  • 0 => VPN-Plug-in überspringt die Captive-Portal-Prüfung.
 0
DisableIntuneDeviceEnrollment REG_DWORD Der Administrator kann diesen Registrierungseintrag über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Wenn auf 1 gesetzt, wird die Intune-Geräteregistrierung nicht durchgeführt. 0
EnableAutoUpdate REG_DWORD Der Administrator kann diesen Registrierungseintrag über GPO mithilfe von GPMC oder SCCM-Push bereitstellen.
Dient zur Steuerung der Plug-in-Update-Funktionalität von Clientseite aus.
  • 0 => Automatische Update-Funktionalität deaktivieren.
  • 1 => Automatische Update-Funktionalität aktivieren.
    Hinweis:
    Dieser Registrierungsschlüssel ist verfügbar unter HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client\AutoUpdate.
0
EnableEdgeWebview REG_DWORD Der Administrator kann diesen Registrierungsschlüssel über GPO mithilfe von GPMC oder SCCM-Push bereitstellen.
  • 0 => Microsoft Edge WebView deaktivieren.
  • 1 => Microsoft Edge WebView aktivieren.
 1
EnableKerberosAuth REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen.
  • 0 => Standardwert.
  • 1 => Der VPN-Client verwendet die Kerberos-Authentifizierungsmethode für die automatische Anmeldung.
 0
EnableMultiSessionFlow REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen.
  • 0 => Zugriff auf Multi-Session-Betriebssystem in Citrix Secure Private Access deaktivieren
  • 1 => Zugriff auf Multi-Session-Betriebssystem in Citrix Secure Private Access aktivieren
 Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
EnableTCPDNS REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen.
  • 0 => Deaktiviert die Split-DNS-Unterstützung für TCP-basierte DNS-Anfragen.
  • 1 => Ermöglicht Split-DNS-Unterstützung für TCP-basierte DNS-Anfragen.
 1
EnableVA REG_DWORD Verwaltet vom Citrix Secure Access Client. Dieser Schlüssel wird intern verwendet, wenn der Citrix Virtual Adapter aktiviert werden muss, wenn IIP vorhanden ist. Benutzer dürfen diesen Schlüssel nicht ändern. 1
EnableWFP REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen.
  • 1 => Das VPN-Plug-in verwendet WFP. Ab dem Citrix Secure Access Client für Windows Release 25.1.1.27 ist WFP standardmäßig aktiviert.
 1
0 => VPN-Plug-in verwendet DNE.
ExcludeDomainsFromRemoteDns REG_SZ Der Administrator kann diesen Registrierungseintrag über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Schließt die DNS-Auflösung durch den Citrix Secure Access Client über einen Remote-DNS-Server aus. Dieser Registrierungseintrag hat keinen Standardwert, da er für eine benutzerdefinierte Lösung konfiguriert ist.
Wenn example.com eine Intranet-Domäne ist und Sie bestimmte Anwendungen wie sshhost.example.com, rdphost.example.com oder *.ftphost.example.com ausschließen möchten, verwenden Sie diesen Registrierungseintrag. *.ftphost.example.com ist ein Platzhaltermuster, das jede Unterdomäne unter ftphost.example.com abgleicht.
Stellen Sie sicher, dass Sie die Domänennamen und Muster entsprechend Ihren Anforderungen anpassen. Sobald Sie die Änderungen vorgenommen haben, starten Sie Citrix Secure Access oder das System neu, damit die Einstellungen wirksam werden.
ExcludeDomainsFromTunnel (Vorschau) REG_SZ Administratoren können diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Schließt den Datenverkehr bestimmter Domänen vom Tunneln über den Citrix Secure Access Client aus. Wenn example.com eine Intranet-Domäne ist und Sie bestimmte Anwendungen wie sshhost.example.com, rdphost.example.com oder *.ftphost.example.com ausschließen möchten, verwenden Sie diese Registrierung. Stellen Sie sicher, dass Sie den Registrierungswert auf eine kommagetrennte Liste von Domänennamen oder Mustern festlegen. Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
HttpTimeout REG_DWORD Administratoren können diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Das HTTP-Timeout wird in Sekunden konfiguriert. Wenn kein Timeout konfiguriert ist, wird das Standard-Timeout verwendet. Der Standard-Timeout-Wert beträgt 100 Sekunden, basierend auf Windows-Standards. 100 Sekunden
InstallDir REG_SZ Verwaltet vom Citrix Secure Access Client. Speicherort, an dem der Citrix Secure Access Client installiert ist. "C:\Program Files\Citrix\Secure Access Client"
locationDetection REG_DWORD Verwendung der CLI. Weitere Informationen finden Sie unter Hinweis*.
  • 1 => Zur Aktivierung der Standorterkennung.
  • 0 => Zur Deaktivierung der Standorterkennung.
 Diese Registrierung hat keinen Standardwert und wird nur konfiguriert, wenn der Always-On-Modus aktiviert ist.
NoDHCPRoute REG_DWORD
  1. Erstellen Sie auf der NetScaler Appliance eine neue Datei mit dem Namen pluginCustomization.json und dem Wert \{ "NoDHCPRoute" : true }.
  2. Legen Sie die Datei pluginCustomization.json in den Ordnern /netscaler/ns_gui/vpn und /var/netscaler/gui/vpn ab.
 Wenn auf 1 gesetzt, wird die DHCP-Serverroute nicht hinzugefügt. Diese Registrierung hat keinen Standardwert, da sie an die Netzwerktopologie angepasst wird.
overrideIPV6DnsDrop REG_DWORD Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen.
  • 1 => IPv6-DNS-Verkehr über VPN zulassen.
 Diese Registrierung hat keinen Standardwert, da sie an die Netzwerktopologie angepasst wird.
0 => IPv6-DNS-Datenverkehr einschränken.
ProductVersion REG_SZ Verwaltet vom Citrix Secure Access Client. Aktuell installierte Version des Citrix Secure Access Clients. Produktversionsinformationen
ProductCode REG_SZ Verwaltet vom Citrix Secure Access Client. Dieser Schlüssel wird intern verwendet. Benutzer dürfen diesen Schlüssel nicht ändern. {B04137FF-B5C9-4058-ACEB-04118790118D}
secureDNSUpdate REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen.
  • 0 => Das VPN-Plug-in versucht nur das unsichere DNS-Update.
  • 1 => Das VPN-Plug-in versucht zuerst das unsichere DNS-Update. Schlägt das unsichere DNS-Update fehl, versucht das VPN-Plug-in anschließend das sichere DNS-Update. Dies ist das Standardverhalten ab dem 21.3.1.2 Windows Plug-in Build.
  • 2 => Das VPN-Plug-in versucht nur das sichere DNS-Update.
 1
SecureChannelResetTimeoutSeconds REG_DWORD Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. Standardmäßig ist dieser Registrierungswert nicht festgelegt oder hinzugefügt. Wenn der Wert von SecureChannelResetTimeoutSeconds 0xFFFFFFFF ist oder nicht in der Registrierung vorhanden ist, wartet das VPN-Plug-in, bis der SecureChannelReset() API-Aufruf abgeschlossen ist, bevor es mit dem Tunneln des Datenverkehrs beginnt. Dies ist das Standardverhalten. Der Administrator muss diese Registrierung auf dem Client festlegen, damit das VPN-Plug-in nach Ablauf der angegebenen Wartezeit für den API-Aufruf mit dem Tunneln des Datenverkehrs beginnt. Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
SecureAccessLogInScript REG_SZ Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Der Citrix Secure Access-Dienst greift über diesen Registrierungsschlüssel auf die Anmeldeskriptkonfiguration zu, wenn er eine Verbindung zum Citrix Secure Private Access-Dienst herstellt. Weitere Informationen finden Sie unter Registrierungen für die Konfiguration von Anmelde- und Abmeldeskripts. Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
SecureAccessLogOutScript REG_SZ Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. Der Citrix Secure Access-Dienst greift über diesen Registrierungsschlüssel auf die Abmeldeskriptkonfiguration zu, wenn er eine Verbindung zum Citrix Secure Private Access-Dienst herstellt. Weitere Informationen finden Sie unter Registrierungen für die Konfiguration von Anmelde- und Abmeldeskripts. Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
suffixList REG_SZ Verwenden der CLI: add dns suffix Semikolon-Liste von Intranet-Domänen. Wird verwendet, wenn die Standorterkennung aktiviert ist. Ruft den Wert vom DNS-Suffix ab, der auf dem Server konfiguriert ist.
SicBeginPort REG_DWORD
  1. Erstellen Sie auf der NetScaler Appliance eine neue Datei namens pluginCustomization.json mit dem Wert \{"SicBeginPort" : 51000}.
  2. Legen Sie die Datei pluginCustomization.json in die Ordner /netscaler/ns_gui/vpn und /var/netscaler/gui/vpn.
 Vermeidet Konflikte, die entstehen können, wenn Sie Ports verwenden, um Sockets zwischen dem Citrix Secure Access Client und Drittanbieter-Apps auf den Client-Maschinen zu erstellen. Der zulässige Bereich ist 49152–64535 (C000 bis FC17 im Hexadezimalformat). Der VPN-Client verwendet bis zu 1000 Ports, beginnend bei SicBeginPort, nur wenn EnableWFP ebenfalls auf 1 gesetzt ist. Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist.
userCertCAList REG_SZ Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. Wird im Kontext des Always-On-Dienstes verwendet, bei dem ein Kunde die Liste der CAs angeben kann, aus denen das Clientzertifikat ausgewählt werden soll. Dieser Registrierungsschlüssel hat keinen Standardwert, da er für eine benutzerdefinierte Lösung konfiguriert ist.
Hinweis:
*Verwenden Sie den folgenden Befehl, um die Registrierungsschlüssel AlwaysOnURL, AlwaysOn, ClientControl und locationDetection über die CLI anzuwenden:
add alwaysONProfile <alwaysONProfileName>-clientControl ( ALLOW | DENY )-locationBasedVPN ( Remote | Everywhere )-networkAccessOnVPNFailure ( onlyToGateway | fullAccess )
Wichtig:
  • Sie können Registrierungsschlüssel basierend auf Ihren Bereitstellungen anwenden. Zum Beispiel ist der Registrierungsschlüssel AlwaysOnService nur für den Always-On-Dienst anwendbar, während der Registrierungsschlüssel ClientControl nicht für den Always-On-Dienst anwendbar ist. Weitere Details finden Sie in der jeweiligen Bereitstellungsdokumentation.
  • secureDNSUpdate ist nur für in die Domäne eingebundene Clientgeräte anwendbar.
  • Für Citrix Secure Access Client für Windows 23.1.1.8 und spätere Versionen lautet der Registrierungsschlüsselname overrideIPV6DnsDrop. Für Citrix Secure Access Client für Windows 22.10.1.9 und frühere Versionen lautet der Registrierungsschlüsselname overrideIP6DnsDrop.
  • Ab Citrix Secure Access Client für Windows 24.8.1.15 sind die Registrierungsschlüssel DisableGA, ForcedLogging und OverrideSpoofIPRange veraltet.
  • Ab Citrix Secure Access Client für Windows 24.8.1.19 kann der Administrator cloud-gehostete Multi-Session-VDIs in Secure Private Access mithilfe des Registrierungsschlüssels EnableMultiSessionFlow für den kontextbezogenen Zugriff auf Ressourcen basierend auf deren Standort, Gerät und anderen Faktoren aktivieren. Für in die Domäne eingebundene Maschinen verwenden Sie sowohl die Registrierungsschlüssel EnableMultiSessionFlow als auch AlwaysOnService.
  • Für Citrix Secure Access Client für Windows-Versionen vor 24.8.1.19 kann der Administrator Microsoft Edge WebView mithilfe des Registrierungsschlüssels EnableEdgeWebview aktivieren.
Related information
VPN-Konfiguration auf einer NetScaler Gateway Appliance