Product Documentation

Adding the Citrix Gateway plug-in to Citrix Receiver

When Citrix Receiver is installed on the user device, users can log on with the Citrix Gateway plug-in through Receiver. You upload the Citrix Gateway plug-in to Merchandising Server, which then downloads and installs the plug-in to Receiver on the user device. If users have the Citrix Gateway plug-in installed when they install Receiver for the first time, the plug-in is automatically added to Receiver.

Delivering plug-ins to User Devices

To deliver plug-ins to user devices, you must upload and configure the Citrix Gateway plug-in on the Merchandising Server. When users make a selection, the plug-in downloads and installs from the Merchandising Server.

If users install the Citrix Gateway plug-in and then later install Receiver, when the Receiver installation is complete, the Citrix Gateway plug-in appears in the Receiver menu.

If users have Citrix Receiver for Windows, users can install Receiver Updater for Windows. This is an optional component that updates the plug-ins and communicates with Merchandising Server. Receiver includes all of the plug-ins available for delivery, including the Citrix Gateway plug-in. For more information about Receiver Updater for Windows, see the Receivers and plug-ins section in the Citrix eDocs library.

Connecting to Citrix Gateway with Receiver

If users connect with Receiver for Windows, they can right-click the Receiver icon in the notification area, click Preferences and then click plug-in status. If the Citrix Gateway plug-in is installed on the user device, users right-click the Citrix Gateway plug-in and then click Logon. When authentication succeeds, the Citrix Gateway plug-in establishes the connection to Citrix Gateway and establishes a full VPN tunnel.

Users can also log on with a web browser. Users enter the fully qualified domain name (FQDN) of Citrix Gateway and log on. When Citrix Gateway establishes the connection, users can verify the connection on the Preferences > plug-in status panel in Receiver.

The Citrix Gateway web address is part of the metadata configured on Merchandising Server and users cannot change the address. The Citrix Gateway plug-in initiates the logon to Citrix Gateway. If the version of Citrix Gateway plug-in for Windows that is installed on the user device is different than the version on the Citrix Gateway appliance, the plug-in downgrades or upgrades automatically when users log on. The Citrix Gateway plug-in for Mac OS X does not downgrade automatically. To install an earlier version of the plug-in on a Mac computer, users must first uninstall the Citrix Gateway plug-in and then download the earlier version from Citrix Gateway.

Upgrading or Downgrading the Citrix Gateway plug-in

During an upgrade or downgrade of the Citrix Gateway plug-in, the appliance removes, downloads, and then installs the correct version of the plug-in. Users can confirm the new installation by checking the plug-in entry on the Preferences > plug-in status panel in Receiver. The newly installed version of the Citrix Gateway plug-in might be a different version than what is configured on Merchandising Server.

Adding the Citrix Gateway plug-in to Merchandising Server

You can also configure Citrix Gateway plug-in delivery on Merchandising Server, which provides a web configuration interface that allows you to upload the Citrix Gateway plug-in MSI installation package. On Merchandising Server, you can:

  • Specify the version and metadata for the Citrix Gateway plug-in.

  • Configure one or more Web addresses for the Citrix Gateway appliance.

  • Associate specific rules based on operating system or other parameters for delivery.

Users cannot add or remove servers from the list of servers configured on Merchandising Server, although they can select a different server from the configured list in the Network Settings panel in Receiver.

If you are using Access Scenario Fallback or load balancing, you can configure a fixed set of Citrix Gateway web addresses and designate Merchandising Server as the default address. Users connect to the default server when they select Log On from the Receiver menu. Users can select a different address from the provided list by using the Receiver’s Preferences > Network Settings panel in Receiver.

Users can continue to use a web browser to log on to any Citrix Gateway. If users log on by using a web browser, the Citrix Gateway plug-in upgrades or downgrades automatically to the version that is on Citrix Gateway.

The following are general steps for adding the Citrix Gateway plug-in to Merchandising Server. For specific configuration steps, see Merchandising Server in the Technologies section in the Citrix eDocs library.

  • Configure the settings on the General tab in the Merchandising Server Administrator Console.

  • Add the Citrix Gateway plug-in to Merchandising Server.

  • Select the appropriate plug-in version for the target platform. The Citrix Gateway plug-in must be added to the main page of Merchandising Server for the plug-in to appear in the Add plug-ins to Delivery page.

  • Configure delivery for the Citrix Gateway plug-in.

  • Use a friendly name for the location that identifies the Citrix Gateway Web address. This name appears in Receiver. You can also add additional Citrix Gateway appliances.

  • Specify authentication type and customize specific labels that appear in the Receiver logon dialog box, such as the user name, password, or personal identification number (PIN).

  • Add rules for the delivery.

  • You must create rules if you want rules to appear in the Add Rule to Delivery page.

  • Schedule the delivery.

Version

Adding the Citrix Gateway plug-in to Citrix Receiver