NetScaler Gateway Windows VPN-Client-Registrierungsschlüssel
Die VPN-Client-Registrierungsschlüssel sind unter HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Secure Access Client verfügbar. Die folgende Tabelle listet die NetScaler Gateway Windows 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. |
|
Diese Registrierung hat keinen Standardwert. |
| AlwaysOnURL | REG_SZ |
Sie können diese Registrierung auf eine der folgenden zwei Arten steuern.
|
URL des NetScaler Gateway Virtual 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*. |
|
Diese Registrierung hat keinen Standardwert. |
| AlwaysOnAllowlist | REG_SZ | Der Administrator kann diese Registrierung ü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 |
| 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 jedes zusätzliche 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 mithilfe von 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 diese Registrierung auf 1. | 0 |
| DisableIconHide | REG_DWORD | Verwendung der CLI: set vpn parameter iconWithReceiver ON |
|
0 |
| DisableDNSRoutes | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
0 |
| DisallowCaptivePortals | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
0 |
| DisableIntuneDeviceEnrollment | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. | Wenn auf 1 gesetzt, wird die Intune-Geräteregistrierung nicht durchgeführt. | 0 |
| DisableWebViewForAutoLogon | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen. |
|
0 |
| EnableAdminConfigFetch | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. | Aktiviert die Client-App-Verwaltungseinstellungen auf der Clientseite. | 0 |
| 0 => Deaktiviert die Client-App-Verwaltungsfunktionalität. | ||||
| 1 => Aktiviert die Client-App-Verwaltungsfunktionalität. | ||||
| EnableAntiDllProtection | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
0 |
| EnableAutoUpdate | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. |
Wird verwendet, um die Plug-in-Update-Funktionalität von Clientseite aus zu steuern.
|
0 |
| EnableContextualAccess | REG_DWORD | Der Administrator kann diesen Registrierungsschlüssel über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen. |
|
0 |
| EnableEdgeWebview | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. |
|
1 |
| EnableKerberosAuth | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
0 |
| EnableMonitorDuringSleep | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
0 |
| EnableMultiSessionFlow | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
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 mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
1 |
| EnableVA | REG_DWORD | Verwaltet durch den 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 |
| EnableWebModuleUI | REG_DWORD | Administratoren können diese Registrierung über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen. |
|
0 |
| EnableWFP | REG_DWORD | Administratoren können diese Registrierung über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen. |
|
1 |
| ExcludeDomainsFromRemoteDns | REG_SZ | Der Administrator kann diese Registrierung ü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. | Diese Registrierung hat keinen Standardwert, da sie 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 diese Registrierung. *.ftphost.example.com ist ein Wildcard-Muster, das jede Subdomäne unter ftphost.example.com abgleicht. |
||||
| Stellen Sie sicher, dass Sie die Domänennamen und Muster entsprechend Ihren Anforderungen anpassen. Nachdem Sie die Änderungen vorgenommen haben, starten Sie Citrix Secure Access oder das System neu, damit die Einstellungen wirksam werden. | ||||
| ExcludeDomainsFromTunnel (Vorschau) | REG_SZ | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. | Schließt den Datenverkehr bestimmter Domänen vom Tunneling ü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. |
| HideLoginLogoutScriptsPrompt | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push oder über ein Feature-Flag bereitstellen. |
|
0 |
| HttpTimeout | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels 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 durch den Citrix Secure Access-Client. | Speicherort, an dem der Citrix Secure Access Client installiert ist. | "C:\Program Files\Citrix\Secure Access Client" |
| IsAutoUpdateControlledViaAdmin | REG_DWORD | Der Administrator kann diese Registrierung über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. |
Wird verwendet, um auszuwählen, welche Computer automatisch Updates für die Beta-Version oder die Produktionsversion des Citrix Secure Access Clients für Windows erhalten sollen.
|
Standardmäßig deaktiviert. |
| locationDetection | REG_DWORD | Mithilfe der CLI. Weitere Informationen finden Sie unter Hinweis*. |
|
Diese Registrierung hat keinen Standardwert und wird nur konfiguriert, wenn der Always On-Modus aktiviert ist. |
| NoDHCPRoute | REG_DWORD |
|
Wenn auf 1 gesetzt, wird die DHCP-Server-Route nicht hinzugefügt. | Diese Registrierung hat keinen Standardwert, da sie basierend auf der Netzwerktopologie angepasst wird. |
| overrideIPV6DnsDrop | REG_DWORD | Der Administrator kann diese Registrierung über GPO mittels GPMC oder SCCM-Push bereitstellen. |
|
Diese Registrierung hat keinen Standardwert, da sie basierend auf der Netzwerktopologie angepasst wird. |
| 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 mithilfe von GPMC oder SCCM-Push bereitstellen. |
|
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 An- und Abmeldeskriptkonfiguration. | 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 An- und Abmeldeskriptkonfiguration. | Diese Registrierung hat keinen Standardwert, da sie für eine benutzerdefinierte Lösung konfiguriert ist. |
| suffixList | REG_SZ | Über die CLI: add dns suffix |
Semikolon-Liste von Intranet-Domänen. Wird verwendet, wenn die Standorterkennung aktiviert ist. | Ruft den Wert aus dem auf dem Server konfigurierten DNS-Suffix ab. |
| SicBeginPort | REG_DWORD |
|
Vermeidet Konflikte, die entstehen könnten, 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. |
Dieser Registrierungsschlüssel hat keinen Standardwert, da er für eine benutzerdefinierte Lösung konfiguriert ist. |
| userCertCAList | REG_SZ | Der Administrator kann diesen Registrierungsschlüssel ü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. |
| UserTunnelFallbackEnabled | REG_DWORD | Der Administrator kann diesen Registrierungsschlüssel über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. | Der Fallback-Mechanismus für Always On VPN, wenn der Maschinentunnel nicht aufgebaut werden kann. Wenn der Registrierungsschlüssel UserTunnelFallbackEnabled aktiviert ist, versucht der Citrix Secure Access Client automatisch, einen Benutzertunnel zu bilden, selbst wenn der Maschinentunnel nicht aufgebaut werden kann.
Wenn auf 1 gesetzt, ist der Parameter UserTunnelFallbackEnabled aktiviert.
|
Dieser Registrierungsschlüssel hat keinen Standardwert, da er für eine benutzerdefinierte Lösung konfiguriert ist. |
| smartCardProviders | REG_SZ | Der Administrator kann diesen Registrierungsschlüssel über GPO mithilfe von GPMC oder SCCM-Push bereitstellen. | Semikolon-getrennte Liste von Smartcard-Anbietern. | leer oder NULL |
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
AlwaysOnServicenur für den Always-on-Dienst anwendbar, während der RegistrierungsschlüsselClientControlnicht für den Always-on-Dienst anwendbar ist. Weitere Details finden Sie in der jeweiligen Bereitstellungsdokumentation. -
secureDNSUpdateist 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üsselnameoverrideIP6DnsDrop. -
Ab Citrix Secure Access Client für Windows 24.8.1.15 sind die Registrierungsschlüssel
DisableGA,ForcedLoggingundOverrideSpoofIPRangeveraltet. -
Ab Citrix Secure Access Client für Windows 24.8.1.19 kann der Administrator cloud-gehostete Multi-Session-VDIs in Citrix Secure Private Access mithilfe des Registrierungsschlüssels
EnableMultiSessionFlowfü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üsselEnableMultiSessionFlowals auchAlwaysOnService. -
Ab Citrix Secure Access Client für Windows 24.11.1.17 kann der Administrator die automatische Update-Funktion aktivieren und auswählen, welche Maschinen automatisch Updates für Early-Access-Builds oder Produktions-Builds erhalten sollen, indem er die Registrierungsschlüssel
EnableAutoUpdateundIsAutoUpdateControlledViaAdminverwendet. Da die automatische Update-Funktion in Citrix Secure Access Client für Windows Version 24.11.1.17 eingeführt wurde, können Administratoren diese Funktion in den nachfolgenden Releases nutzen. -
Ab Citrix Secure Access Client für Windows 24.11.1.17 kann der Administrator die Funktion für kontextbezogenen Zugriff in Secure Private Access mithilfe des Registrierungsschlüssels
EnableContextualAccessaktivieren. Die Funktion für kontextbezogenen Zugriff ermöglicht es einem Administrator, ZTNA-Richtlinien dynamisch basierend auf dem Benutzerkontext wie Netwerkstandort, geografischem Standort und Gerätehaltung durchzusetzen. -
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
EnableEdgeWebviewaktivieren. -
Ab Citrix Secure Access Client für Windows Version 25.11.1.12 kann der Administrator die verbesserte Benutzeroberfläche mit Benachrichtigungscenter, integriertem WebView und Captive-Portal-Unterstützung mithilfe des Registrierungsschlüssels
EnableWebModuleUIaktivieren. -
Ab Citrix Secure Access Client Version 25.11.1.12 kann der Administrator die Sicherheitsverbesserung zur Anti-DLL-Injektion mithilfe der
EnableAntiDllProtectionRegistrierung aktivieren. Wenn aktiviert, schützt sie den Citrix Secure Access Client vor bestimmten nicht autorisierten Dynamic-Link Libraries (DLLs) oder nicht vertrauenswürdigen Modulen. Wenn solche nicht vertrauenswürdigen Module injiziert werden, erkennt der Citrix Secure Access Client diese Eingriffe und verhindert das Laden der Module. Wird außerdem beim Start des Citrix Secure Access eine nicht vertrauenswürdige oder bösartige DLL erkannt, wird eine Benachrichtigung generiert und der Anwendungsstart beendet. -
Ab Citrix Secure Access Client Version 25.11.1.12 kann der Administrator die
HideLoginLogoutScriptsPromptRegistrierung konfigurieren, um sicherzustellen, dass die Eingabeaufforderung nicht aufblinkt, wenn Anmelde- oder Abmeldeskripte während des Aufbaus oder der Beendigung des Citrix Secure Access Tunnels ausgeführt werden. -
Ab Citrix Secure Access Client Version 25.11.1.12 kann der Administrator die
DisableWebViewForAutoLogonRegistrierung konfigurieren, um sicherzustellen, dass der Citrix Secure Access Client Gerätehaltung oder Authentifizierungsbildschirme ausblendet, wenn er im Always On-Modus ausgeführt wird. Diese Funktionalität wird nur mit der neuen Benutzeroberfläche unterstützt, die mithilfe derEnableWebModuleUIRegistrierung aktiviert wird. -
Ab Citrix Secure Access Client für Windows Version 25.11.1.12 müssen Administratoren die
EnableAdminConfigFetchRegistrierung konfigurieren, um die Einstellungen für die Client-App-Verwaltung auf Clientseite zu aktivieren oder den Citrix Support zu kontaktieren. Weitere Informationen finden Sie unter Citrix Secure Access - Client-App-Verwaltung. -
Die
UserTunnelFallbackEnabledRegistrierung ist ab Citrix Secure Access Client für Windows Version 26.1.1.9 verfügbar.