Ouvrir dans l'explorateur

Configure client proxy settings

Cette stratégie n'a pas de traduction française dans les modèles de l'éditeur ; le texte original est en anglais.

Type
Ordinateur
Chemin GPO
Configuration ordinateur › Stratégies › Modèles d'administration › Citrix Components › Citrix Workspace › Network routing › Proxy EN : Computer Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › Network routing › Proxy
Pris en charge sur
All Citrix Workspace supported platforms
Fichier ADMX
receiver.admx
Nom interne
receiver/Policy_ProxyLockdown

Explication

Enable this policy to configure the primary network proxies that the client can use to connect to remote application or desktop.
From the Proxy Type drop-down menu, select:
- Auto: To enable the client to use the local machine settings to determine the proxy server.
- None: To enable the client to connect to the server directly without using a proxy server.
- Script: To enable the client to retrieve a Java based .pac file from the URL specified in the proxy script URLs. The .pac file is executed to identify the proxy server used for connection.
- Secure: When "Secure" is selected, the client will contact the proxy identified by the "Proxy host names" and "Proxy ports" settings. The negotiation protocol will use a "HTTP CONNECT" header request specifying the desired destination address. This proxy protocol is commonly used for HTTP based traffic, and supports GSSAPI proxy authentication.
- SOCKS/SOCKS V4/SOCKS V5: When a "SOCKS" proxy is selected, the client will perform a SOCKS V4 or SOCKS V5 handshake to the proxy identified by the "Proxy hostnames" and "Proxy ports" settings. The "SOCKS" option will detect and use the correct version of Socks.

To enable proxy server bypass, select Bypass Server list.

Troubleshooting:
Some client platforms do not support the "Auto" proxy type due to operating system limitations. See the appropriate Administrator's Guide for details. For these platforms, the proxy settings should be manually set on the client device.

When configuring the Web Interface server, an appropriate proxy server can be indicated for the particular location of the client. When configuring proxies via Group Policy, it is important to avoid overriding these settings. Where multiple proxies can be chosen, simply use a comma-separated list of options with the first being the default.

Most Intranet client deployments should use the "None" option for the proxy type, otherwise the client may attempt to connect over the Internet. For more advanced deployments the "Bypass server list" option can be used, alternatively ".pac" scripts or Trusted Server Configuration are available to suit the network topology.

Some proxy servers will automatically disconnect connections that are idle for a certain length of time. This can cause client sessions to be disconnected when not in use. A server-side option "ICA Keep-Alive" is available to send extra data packets during periods of inactivity that can be used prevent proxies closing connections.

Registre

HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy
Nom de la valeur
non défini dans l'ADMX

Valeurs d'activation / désactivation : non défini dans l'ADMX (voir les options ci-dessous).

PowerShell

Commandes PowerShell qui écrivent dans le registre ce que la stratégie écrirait. Les valeurs entre chevrons (<…>) sont à remplacer.

Écrire directement dans le registre contourne la stratégie de groupe : si une GPO gère cette valeur, elle sera réécrite au prochain gpupdate ; sinon la valeur reste en place (effet « tatouage »). Préférez une GPO ou, en local, LGPO.exe. Exécutez PowerShell en administrateur pour HKLM. Certaines stratégies demandent un redémarrage ou gpupdate /force.

Activer

# Activer : receiver/Policy_ProxyLockdown
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Proxy types
# Options possibles :
#   Auto = Auto
#   None = None
#   SOCKS = SOCKS
#   SOCKSv4 = SOCKSv4
#   SOCKSv5 = SOCKSv5
#   Secure = Secure
#   Script = Script
Set-ItemProperty -Path $k -Name 'ProxyType' -Value 'Auto' -Type String
# Proxy host names
Set-ItemProperty -Path $k -Name 'ProxyHost' -Value '<valeur>' -Type String
# Proxy ports
Set-ItemProperty -Path $k -Name 'ProxyPort' -Value '<valeur>' -Type String
# Proxy script URLs
Set-ItemProperty -Path $k -Name 'ProxyAutoConfigUrl' -Value '<valeur>' -Type String
# Bypass server list
Set-ItemProperty -Path $k -Name 'ProxyBypassList' -Value '<valeur>' -Type String

Désactiver

# Désactiver : receiver/Policy_ProxyLockdown
# Aucune valeur n'est écrite à l'état « Désactivé » (rien de défini dans l'ADMX)

Revenir à « Non configuré »

# Revenir à « Non configuré » : receiver/Policy_ProxyLockdown
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'ProxyType' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyHost' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyPort' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyAutoConfigUrl' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyBypassList' -ErrorAction SilentlyContinue

Options (5)

LibelléContrôleValeur de registreType REGContraintes / détails
Proxy typesPart_Proxy_ProxyTypeLockdownListe déroulanteenumProxyTypeREG_SZ
LibelléValeur
AutoREG_SZ = Auto
NoneREG_SZ = None
SOCKSREG_SZ = SOCKS
SOCKSv4REG_SZ = SOCKSv4
SOCKSv5REG_SZ = SOCKSv5
SecureREG_SZ = Secure
ScriptREG_SZ = Script
Proxy host namesPart_Proxy_ProxyHostLockdownZone de textetextProxyHostREG_SZ
Proxy portsPart_Proxy_ProxyPortLockdownZone de textetextProxyPortREG_SZ
Proxy script URLsPart_Proxy_ProxyAutoConfigUrlLockdownZone de textetextProxyAutoConfigUrlREG_SZ
Bypass server listPart_Proxy_ProxyBypassListLockdownZone de textetextProxyBypassListREG_SZ

Application

Citrix Workspace app (Citrix) — modèles d'octobre 2026

Modèles d'octobre 2026 issus de pl4nty/web-admx-tool.