Product Documentation

Adding the NetScaler Gateway Plug-in to Receiver

Feb 03, 2014

When Citrix Receiver is installed on the user device, users can log on with the NetScaler Gateway Plug-in through Receiver. You upload the NetScaler Gateway Plug-in to Merchandising Server, which then downloads and installs the plug-in to Receiver on the user device. If users have the NetScaler 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 NetScaler 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 NetScaler Gateway Plug-in and then later install Receiver, when the Receiver installation is complete, the NetScaler 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 NetScaler 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 NetScaler 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 NetScaler Gateway Plug-in is installed on the user device, users right-click the NetScaler Gateway Plug-in and then click Logon. When authentication succeeds, the NetScaler Gateway Plug-in establishes the connection to NetScaler 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 NetScaler Gateway and log on. When NetScaler Gateway establishes the connection, users can verify the connection on the Preferences > Plug-in status panel in Receiver.

The NetScaler Gateway web address is part of the metadata configured on Merchandising Server and users cannot change the address. The NetScaler Gateway Plug-in initiates the logon to NetScaler Gateway. If the version of NetScaler Gateway Plug-in for Windows that is installed on the user device is different than the version on the NetScaler Gateway appliance, the plug-in downgrades or upgrades automatically when users log on. The NetScaler 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 NetScaler Gateway Plug-in and then download the earlier version from NetScaler Gateway.

Upgrading or Downgrading the NetScaler Gateway Plug-in

During an upgrade or downgrade of the NetScaler 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 NetScaler Gateway Plug-in might be a different version than what is configured on Merchandising Server.

Adding the NetScaler Gateway Plug-in to Merchandising Server

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

  • Specify the version and metadata for the NetScaler Gateway Plug-in.
  • Configure one or more Web addresses for the NetScaler Gateway appliance.
  • Associate specific rules based on operating system or other parameters for delivery.
Note: 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 NetScaler 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 NetScaler Gateway. If users log on by using a web browser, the NetScaler Gateway Plug-in upgrades or downgrades automatically to the version that is on NetScaler Gateway.

The following are general steps for adding the NetScaler 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 NetScaler Gateway Plug-in to Merchandising Server.

    Select the appropriate plug-in version for the target platform. The NetScaler 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 NetScaler Gateway Plug-in.

    Use a friendly name for the location that identifies the NetScaler Gateway Web address. This name appears in Receiver. You can also add additional NetScaler 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.

Uninstalling Receiver

If users uninstall Receiver without uninstalling individual plug-ins from the user device, all plug-ins registered with Receiver, including the NetScaler Gateway Plug-in, are removed from the user device. If users want to log on with the NetScaler Gateway Plug-in after removing Receiver, users need to install the plug-in as a standalone application by using a web browser.