Product Documentation

Enable data collection for Citrix ADC Gateway appliances deployed in double-hop mode

The Citrix ADC Gateway double-hop mode provides additional protection to an organization’s internal network because an attacker would need to penetrate multiple security zones or Demilitarized zones (DMZ) to reach the servers in the secure network. If you want to analyze the number of hops (Citrix ADC Gateway appliances) through which the ICA connections pass, and also the details about the latency on each TCP connection and how it fairs against the total ICA latency perceived by the client, you must install Citrix Application Delivery Management (ADM) so that the Citrix ADC Gateway appliances report these vital statistics.

Figure 3. Citrix ADM deployed in double-hop mode

localized image

The Citrix ADC Gateway in the first DMZ handles user connections and performs the security functions of an SSL VPN. This Citrix ADC Gateway encrypts user connections, determines how the users are authenticated, and controls access to the servers in the internal network.

The Citrix ADC Gateway in the second DMZ serves as a Citrix ADC Gateway proxy device. This Citrix ADC Gateway enables the ICA traffic to traverse the second DMZ to complete user connections to the server farm.

The Citrix ADM can be deployed either in the subnet belonging to the Citrix ADC Gateway appliance in the first DMZ or the subnet belonging to the Citrix ADC Gateway appliance second DMZ. In the above image, the Citrix ADM and Citrix ADC Gateway in the first DMZ are deployed in the same subnet.

In a double-hop mode, Citrix ADM collects TCP records from one appliance and ICA records from the other appliance. After you add the Citrix ADC Gateway appliances to the Citrix ADM inventory and enable data collection, each of the appliances export the reports by keeping track of the hop count and connection chain ID.

For Citrix ADM to identify which appliance is exporting records, each appliance is specified with a hop count and each connection is specified with a connection chain ID. Hop count represents the number of Citrix ADC Gateway appliances through which the traffic flows from a client to the servers. The connection chain ID represents the end- to end connections between the client and server.

Citrix ADM uses the hop count and connection chain ID to co-relate the data from both the Citrix ADC Gateway appliances and generates the reports.

To monitor Citrix ADC Gateway appliances deployed in this mode, you must first add the Citrix ADC Gateway to Citrix ADM inventory, enable AppFlow on Citrix ADM and then view the reports on the Citrix ADM dashboard.

Enabling data collection on Citrix ADM

If you enable Citrix ADM to start collecting the ICA details from both the appliances, the details collected are redundant. That is both the appliances report the same metrics. To overcome this situation, you must enable AppFlow for ICA on one of the first Citrix ADC Gateway appliance, and then enable AppFlow for TCP on the second appliance. By doing so, one of the appliances export ICA AppFlow records and the other appliance exports TCP AppFlow records. This also saves the processing time on parsing the ICA traffic.

To enable the AppFlow feature from Citrix ADM:

  1. In a web browser, type the IP address of the Citrix Application Delivery Management (ADM) (for example, http://192.168.100.1).

  2. In User Name and Password, enter the administrator credentials.

  3. Navigate to Infrastructure > Instances, and select the Citrix ADC instance you want to enable analytics.

  4. From the Action drop-down, select Enable/Disable Insight.

  5. Select the VPN virtual servers, and click Enable AppFlow.

  6. In the Enable AppFlow field, type true, and select ICA/TCP for ICA traffic an TCP traffic respectively.

    Note: If AppFlow logging is not enabled for the respective services or service groups on the Citrix ADC appliance, the Citrix ADM dashboard does not display the records, even if the Insight column shows Enabled.

  7. Click OK.

    localized image

Configuring Citrix ADC Gateway appliances to export data

After you install the Citrix ADC Gateway appliances, you must configure the following settings on the Citrix ADC gateway appliances to export the reports to Citrix ADM:

  • Configure virtual servers of the Citrix ADC Gateway appliances in the first and second DMZ to communicate with each other.
  • Bind the Citrix ADC Gateway virtual server in the second DMZ to the Citrix ADC Gateway virtual server in the first DMZ.
  • Enable double hop on the Citrix ADC Gateway in the second DMZ.
  • Disable authentication on the Citrix ADC Gateway virtual server in the second DMZ.
  • Enable one of the Citrix ADC Gateway appliances to export ICA records
  • Enable the other Citrix ADC Gateway appliance to export TCP records:
  • Enable connection chaining on both the Citrix ADC Gateway appliances.

Configuring Citrix ADC Gateway using the command line interface:

  1. Configure the Citrix ADC Gateway virtual server in the first DMZ to communicate with the Citrix ADC Gateway virtual server in the second DMZ.

    add vpn nextHopServer <name> <nextHopIP> <nextHopPort> [-secure (ON OFF)] [-imgGifToPng] …
    add vpn nextHopServer nh1 10.102.2.33 8443 –secure ON
    
  2. Bind the Citrix ADC Gateway virtual server in the second DMZ to the Citrix ADC Gateway virtual server in the first DMZ. Run the following command on the Citrix ADC Gateway in the first DMZ:

    bind vpn vserver <name> -nextHopServer <name>

    bind vpn vserver vs1 -nextHopServer nh1
    
  3. Enable double hop and AppFlow on the Citrix ADC Gateway in the second DMZ.

    set vpn vserver <name> [- doubleHop ( ENABLED DISABLED )] [- appflowLog ( ENABLED DISABLED )]
    set vpn vserver vpnhop2 –doubleHop ENABLED –appFlowLog ENABLED
    
  4. Disable authentication on the Citrix ADC Gateway virtual server in the second DMZ.

    set vpn vserver <name> [-authentication (ON OFF)]
    set vpn vserver vs -authentication OFF
    
  5. Enable one of the Citrix ADC Gateway appliances to export TCP records.

    bind vpn vserver <name> [-policy <string> -priority <positive_integer>] [-type <type>]

    bind vpn vserver vpn1 -policy appflowpol1 -priority 101 –type OTHERTCP\_REQUEST
    
  6. Enable the other Citrix ADC Gateway appliance to export ICA records:

    bind vpn vserver <name> [-policy <string> -priority <positive_integer>] [-type <type>]

    bind vpn vserver vpn2 -policy appflowpol1 -priority 101 -type ICA\_REQUEST
    
  7. Enable connection chaining on both the Citrix ADC Gateway appliances:

    set appFlow param [-connectionChaining (ENABLED DISABLED)]
    set appflow param -connectionChaining ENABLED
    

Configuring Citrix ADC Gateway using configuration utility:

  1. Configure the Citrix ADC Gateway in the first DMZ to communicate with the Citrix ADC Gateway in the second DMZ and bind the Citrix ADC Gateway in the second DMZ to the Citrix ADC Gateway in the first DMZ.
    1. On the Configuration tab expand Citrix ADC Gateway and click Virtual Servers.
    2. In the right pane, double- click the virtual server, and in the Advanced group, expand Published Applications.
    3. Click Next Hop Server and bind a next hop server to the second Citrix ADC Gateway appliance.
  2. Enable double hop on the Citrix ADC Gateway in the second DMZ.
    1. On the Configuration tab expand Citrix ADC Gateway and click Virtual Servers.
    2. In the right pane, double- click the virtual server, and in the Basic Settings group, click the edit icon.
    3. Expand More , select Double Hop and click OK.
  3. Disable authentication on the virtual server on the Citrix ADC Gateway in the second DMZ.
    1. On the Configuration tab expand Citrix ADC Gateway and click Virtual Servers.
    2. In the right pane, double- click the virtual server, and in the Basic Settings group, click the edit icon.
    3. Expand More, and uncheck Enable Authentication.
  4. Enable one of the Citrix ADC Gateway appliance to export TCP records.
    1. On the Configuration tab expand Citrix ADC Gateway and click Virtual Servers.
    2. In the right pane, double- click the virtual server, and in the Advanced group, expand Policies.
    3. Click the + icon and in the from the Choose Policy drop-down list, select AppFlow and from the Choose Type drop-down list, select Other TCP Request.
    4. Click Continue.
    5. Add a policy binding, and click Close.
  5. Enable the other Citrix ADC Gateway appliance to export ICA records:
    1. On the Configuration tab expand Citrix ADC Gateway and click Virtual Servers.
    2. In the right pane, double- click the virtual server, and in the Advanced group, expand Policies.
    3. Click the + icon and in the from the Choose Policy drop-down list, select AppFlow and from theChoose Type drop-down list, select Other TCP Request.
    4. Click Continue.
    5. Add a policy binding, and click Close.
  6. Enable connection chaining on both the Citrix ADC Gateway appliances.
    1. On the Configuration tab, navigate to System > Appflow.
    2. In the right Pane, in the Settings group, click on Change Appflow Settings.
    3. Select Connection Chaining and Click OK.

Enable data collection for Citrix ADC Gateway appliances deployed in double-hop mode