Open in the explorer

Configure proxy authentication

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › Network routing › Proxy
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_ProxyAuthentication

Explanation

Use this policy to control the authentication mechanisms that the client uses when connecting to a proxy server. Authenticating proxy servers can be used to monitor data traffic in large network deployments.

In general, authentication is handled by the operating system but in some scenarios, the user may be provided with a specific user name and password. To prevent the user from being specifically prompted for these credentials, clear the "Prompt user for credentials" check box. This will force the client to attempt an anonymous connection. Alternatively, you can configure the client to connect using credentials passed to it by the Web Interface server, or these can be explicitly specified via Group Policy using the "Explicit user name" and "Explicit password" options.

Troubleshooting:
In general NTLM proxy authentication will be performed under the control of the Domain Controller, and cannot be controlled by the client. Both client and proxy will need to be configured with the appropriate domain level trust relations.

Proxy authentication cannot be linked to the pass-through authentication feature of the client. In general, the proxy password will be unrelated to user's passwords.

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_ProxyAuthentication
$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 }
# Prompt user for credentials
# unchecked: false
Set-ItemProperty -Path $k -Name 'ProxyAuthenticationPrompt' -Value '*' -Type String
# Allow clear text authentication
# unchecked: false
Set-ItemProperty -Path $k -Name 'ProxyAuthenticationBasic' -Value '*' -Type String
# Allow NTLM hash authentication
# unchecked: false
Set-ItemProperty -Path $k -Name 'ProxyAuthenticationNTLM' -Value '*' -Type String
# Explicit user name
Set-ItemProperty -Path $k -Name 'ProxyUsername' -Value '<value>' -Type String
# Explicit password
Set-ItemProperty -Path $k -Name 'ProxyPassword' -Value '<value>' -Type String

Disable

# Disable: receiver/Policy_ProxyAuthentication
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_ProxyAuthentication
$k = 'HKLM:\Software\Policies\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy'
Remove-ItemProperty -Path $k -Name 'ProxyAuthenticationPrompt' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyAuthenticationBasic' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyAuthenticationNTLM' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyUsername' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ProxyPassword' -ErrorAction SilentlyContinue

Options (5)

LabelControlRegistry valueREG typeConstraints / details
Prompt user for credentialsPolicy_ProxyExplicitAuthenticationEnabledCheck boxbooleanProxyAuthenticationPromptREG_SZ
Default (UI): true
Checked: REG_SZ = *
Unchecked: REG_SZ = false
Allow clear text authenticationPolicy_ProxyBasicAuthenticationEnabledCheck boxbooleanProxyAuthenticationBasicREG_SZ
Default (UI): true
Checked: REG_SZ = *
Unchecked: REG_SZ = false
Allow NTLM hash authenticationPolicy_ProxyNTLMAuthenticationEnabledCheck boxbooleanProxyAuthenticationNTLMREG_SZ
Default (UI): true
Checked: REG_SZ = *
Unchecked: REG_SZ = false
Explicit user namePart_Proxy_Socks5UserText boxtextProxyUsernameREG_SZ
Explicit passwordPart_Proxy_Socks5PasswordText boxtextProxyPasswordREG_SZ

Application

Citrix Workspace app (Citrix) — October 2026 templates

October 2026 templates from pl4nty/web-admx-tool.