Open in the explorer

OAuth Redirection

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Citrix Components › Citrix Workspace › User experience
Supported on
All Citrix Workspace supported platforms
ADMX file
receiver.admx
Internal name
receiver/Policy_OAuthRedirection

Explanation

OAuth Redirection allows configuring URL patterns to allow OAuth logins to be redirected over Bidirectional Content Redirection.

-OAuth Pattern : This indicates the list of URL regular expressions that, when redirected to the client via Host-to-Client URL redirection, will be tracked as if an OAuth authentication flow has begun, and when the flow completes that resulting URL will be redirected back into the Host VDA that initiated that flow.. Semi Colon ";" acts as a delimeter.

-OAuth Scheme : This indicates the scheme of URLs .If a Scheme is specified, the terminating URL is expected to be of the form: scheme://something. If Scheme is not specified (empty), then the original resulting URL pattern is extracted from the Pattern via a regular expression capture group (must be specified in the Pattern). Semi Colon ";" acts as a delimeter.

Note:
1)Number of Patterns and scheme entries should match .If no scheme is specified for pattern just porvide ';' for empty scheme
2)OAuth Redirection works only if BidirectionalContentRedirection is enabled

Registry

HKEY_CURRENT_USER\Software\Policies\Citrix\ICA Client\OAuth Redirection
Value name
AllowOAuthRedirection
StateValue written
EnabledREG_DWORD = 1
KeyValueData
Software\Classes\citrix-oauth-redirREG_SZ = URL:Citrix OAuth2 Redirection Helper
Software\Classes\citrix-oauth-redirURL ProtocolREG_SZ = (empty string)
Software\Classes\citrix-oauth-redir\shell\open\commandREG_SZ = "c:\Program Files (x86)\Citrix\ICA Client\redirector.exe" /launch "%1"
DisabledREG_DWORD = 0

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_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -Value 1 -Type DWord
# Pattern
Set-ItemProperty -Path $k -Name 'Pattern' -Value '<value>' -Type String
# Scheme
Set-ItemProperty -Path $k -Name 'Scheme' -Value '<value>' -Type String
$k = 'HKCU:\Software\Classes\citrix-oauth-redir'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name '' -Value 'URL:Citrix OAuth2 Redirection Helper' -Type String
Set-ItemProperty -Path $k -Name 'URL Protocol' -Value '' -Type String
$k = 'HKCU:\Software\Classes\citrix-oauth-redir\shell\open\command'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name '' -Value '"c:\Program Files (x86)\Citrix\ICA Client\redirector.exe" /launch "%1"' -Type String

Disable

# Disable: receiver/Policy_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -Value 0 -Type DWord

Revert to "Not configured"

# Revert to "Not configured": receiver/Policy_OAuthRedirection
$k = 'HKCU:\Software\Policies\Citrix\ICA Client\OAuth Redirection'
Remove-ItemProperty -Path $k -Name 'AllowOAuthRedirection' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'Pattern' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'Scheme' -ErrorAction SilentlyContinue
$k = 'HKCU:\Software\Classes\citrix-oauth-redir'
Remove-ItemProperty -Path $k -Name 'URL Protocol' -ErrorAction SilentlyContinue

Options (2)

LabelControlRegistry valueREG typeConstraints / details
Pattern:Part_OAuthRedirectionRedirectionPatternText boxtextPatternREG_SZ
Scheme:Part_OAuthRedirectionSchemeText boxtextSchemeREG_SZ

Application

Citrix Workspace app (Citrix) — October 2026 templates

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