StoreFront Client Proxy Configuration

StoreFront Client Proxy Configuration

book

Article ID: CTX136516

calendar_today

Updated On:

Description

This article describes how to change the Proxy settings on StoreFront.

Instructions

In Web Interface, there were options in the GUI for client side proxy, but this option is not available in the GUI of StoreFront.

Complete the following steps to change the proxy settings of StoreFront :

  1. Open c:\inetpub\wwwroot\citrix\<storeName>\App_Data\default.ica file in Notepad.

    App-Data

  2. Add a line for ProxyType=<value> in both the WFClient and Application section in the default.ica file, as illustrated in the following screen shot and save the file: 

    Default ICA

ProxyType Options

  • When None is specified, the client will attempt to connect to the server directly without traversing a proxy server.

  • When Auto is specified, the client will use the local machine settings to determine which proxy server to use for a connection. This is usually the settings used by the web browser installed on the machine.

  • When Script is specified, the client will retrieve a JavaScript based .pac file from the URL specified in the Proxy script URLs policy option. The .pac file is executed to identify which proxy server should be used for the connection.

  • When Secure is specified, 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.

  • When a SOCKS proxy is specified, 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.
Note: These changes are global changes for each StoreFront store.
Example:
ProxyType=Secure
ProxyHost=mycompany.com:portnumber

Client Side Configuration (will override global settings configured on StoreFront or Web Interface)

Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.

The following registry key setting on the client will override any settings configured on default.ica file or Web Interface GUI. Uses same values as shown above:
[HKEY_CURRENT_USER\Software\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\Proxy]
ProxyType=<value>

Environment

Caution! Using Registry Editor 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.

Issue/Introduction

This article describes how to change the Proxy settings on StoreFront.

Additional Information

Citrix Documentation - ICA Settings Reference

Powered by Wolken Software