This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Host to client redirection
Host to client redirection allows URLs, embedded as hyperlinks in applications running on a Citrix session, to open using the corresponding application on the user endpoint device. Some common use cases for host to client redirection include:
- Redirection of websites in cases where the Citrix server doesn’t have Internet or network access to the source.
- Redirection of websites when running a web browser inside the Citrix session is not desired for security, performance, compatibility, or scalability reasons.
- Redirection of specific URL types in cases where the required applications to open the URL are not installed on the Citrix server.
Host to client redirection is not intended for URLs that you access on a webpage or type in the address bar of the web browser running in the Citrix session. For redirection of URLs in web browsers, see Bidirectional URL redirection or Browser content redirection.
System requirements
- Multi-session OS VDA
- Supported clients:
- Citrix Workspace app for Windows
- Citrix Workspace app for Mac
- Citrix Workspace app for Linux
- Citrix Workspace app for HTML5
- Citrix Workspace app for Chrome
The client device must have an application installed and configured for handling the redirection of the URL types.
Configuration
Use the Host to client redirection Citrix policy to enable this functionality. Host to client redirection is disabled by default. After you enable the Host to client redirection policy, the Citrix Launcher application registers with the Windows server to ensure that it can intercept URLs and send them to the client device.
Then you must configure the Windows Group Policy to use Citrix Launcher as the default application for the required URL types. On the Citrix server VDA, create the ServerFTAdefaultPolicy.xml file and insert the following XML code.
<?xml version="1.0" encoding="UTF-8"?>
<DefaultAssociations>
<Association Identifier="http" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
<Association Identifier="https" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
</DefaultAssociations>
<!--NeedCopy-->
From the Group Policy management console, go to Computer configuration > Administrative Templates > Windows Components > File Explorer > Set a default associations configuration file, and save your ServerFTAdefaultPolicy.xml file.
Note:
If a Citrix server doesn’t have the Group Policy settings, Windows prompts users to select an application for opening URLs.
By default, we support redirection of the following URL types:
- HTTP
- HTTPS
- RTSP
- RTSPU
- PNM
- MMS
To include additional standard or custom URL types on the list for redirection, create a new Association Identifier line in the ServerFTAdefaultPolicy.xml file referenced earlier. For example:
<Association Identifier="ftp" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
<Association Identifier="mailto" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
<Association Identifier="customtype1" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
<Association Identifier="customtype2" ProgId="ServerFTAHTML" ApplicationName="ServerFTA" />
Adding URL types to the list also requires client configuration. Create the following registry key and values on the Windows client.
Note:
Editing the registry incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.
- Key: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Policies\Citrix\ICA Client\SFTA
- Value name: ExtraURLProtocols
- Value type: REG_SZ
- Value data: Specify the required URL types separated by semicolon. Include everything before the authority portion of the URL. For example:
ftp://;mailto:;customtype1://;custometype2://
You can add URL types only for Windows clients. Clients missing the registry settings above reject redirection back to the Citrix session. Client must have an application installed and configured to handle the specified URL types.
To remove URL types from the default redirection list, create the following registry key and values on the server VDA.
-
Key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA
- Value name: DisableServerFTA
- Value type: DWORD
-
Value data: 1
- Value name: NoRedirectClasses
- Value type: REG_MULTI_SZ
- Value data: Specify any combination of the values:
http
,https
,rtsp
,rtspu
,pnm
, ormms
. Type multiple values on separate lines. For example:
http
https
rtsp
To enable host to client redirection for a specific set of websites, create a registry key and values on the server VDA.
- Key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA
- Value name: ValidSites
- Value type: REG_MULTI_SZ
- Value data: Specify any combination of fully qualified domain names (FQDNs). Type multiple FQDNs on separate lines. Include the FQDN only, without protocols (
http://
orhttps://
). An FQDN can include an asterisk (*
) as a wildcard character in the leftmost position only. This wildcard matches a single level of domain, which is consistent with the rules in RFC 6125. For example:
www.exmaple.com
*.example.com
Note:
You cannot use the ValidSites key in combination with the DisableServerFTA and NoRedirectClasses keys.
Server VDA default browser configuration
Enabling host to client redirection as referenced in this section supersedes any previous default browser configuration on the server VDA. If a web URL is not redirected, the Citrix Launcher passes the URL to the browser configured in the command_backup
registry key. The key points to Internet Explorer by default, but you can modify it to include the path to a different browser. For more information, see Server VDA default browser configuration in the list of features managed through the registry.
Share
Share
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.