Configure SOCKS proxy settings
Explanation
Use this policy to configure the use of additional SOCKS proxies that are required for some advanced network topologies.
When enabled, the client will examine the "SOCKS protocol version" setting. If connection via SOCKS is not disabled, the client will attempt to connect using the SOCKS proxy specified by the "Proxy host names" and "Proxy ports" settings.
The client supports connections using either SOCKS v4 or SOCKS v5 proxy servers. Alternatively, it can attempt to automatically detect the version being used by the proxy server.
Troubleshooting:
The SOCKS proxy settings are designed for traversing a proxy in addition to the primary or alternative proxy server. When traversing only a single proxy, these SOCKS proxy settings should be disabled.
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: receiver/Policy_ProxySocks
$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 }
# SOCKS protocol version
# Possible options:
# Disabled = -1,default
# Detect version = 0,4,5
# SOCKS v4 = 4
# SOCKS v5 = 5
Set-ItemProperty -Path $k -Name 'ICASOCKSProtocolVersion' -Value '0,4,5' -Type String
# Proxy host names
Set-ItemProperty -Path $k -Name 'ICASOCKSProxyHost' -Value '<value>' -Type String
# Proxy ports
Set-ItemProperty -Path $k -Name 'ICASOCKSProxyPortNumber' -Value '<value>' -Type StringDisable
# Disable: receiver/Policy_ProxySocks
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": receiver/Policy_ProxySocks
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'ICASOCKSProtocolVersion' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ICASOCKSProxyHost' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ICASOCKSProxyPortNumber' -ErrorAction SilentlyContinueOptions (3)
| Label | Control | Registry value | REG type | Constraints / details | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SOCKS protocol versionPart_ProxySocks_Version | Drop-down listenum | ICASOCKSProtocolVersion | REG_SZ | Default choice (UI): #1
| ||||||||||
| Proxy host namesPart_ProxySocks_ProxyHostLockdown | Text boxtext | ICASOCKSProxyHost | REG_SZ | |||||||||||
| Proxy portsPart_ProxySOCKS_ProxyPortLockdown | Text boxtext | ICASOCKSProxyPortNumber | REG_SZ |
Application
Citrix Workspace app (Citrix) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.