Gateway

Configure client interception

You configure interception rules for user connections on Citrix Gateway by using Intranet Applications. By default, when you configure the system IP address, a mapped IP address, or a subnet IP address on the appliance, subnet routes are created based on these IP addresses. Intranet applications are created automatically based on these routes and can be bound to a virtual server. If you enable split tunneling, you must define intranet applications for client interception to occur.

You can configure intranet applications by using the configuration utility. You can bind intranet applications to users, groups, or virtual servers.

If you enable split tunneling and users connect by using WorxWeb or WorxMail, when you configure client interception, you must add the IP addresses for Citrix Endpoint Management and your Exchange server. If you do not enable split tunneling, you do not need to configure the Endpoint Management and Exchange IP addresses in Intranet Applications.

For information about split tunneling configuration, see Configure split tunneling.

Configure intranet applications for the Citrix Gateway plug-in

You create intranet applications for user access to resources by defining the following:

  • One IP address
  • A range of IP addresses
  • A host name

When you define an intranet application on Citrix Gateway, the Citrix Secure Access agent for Windows intercepts user traffic that is destined to the resource and sends the traffic through Citrix Gateway.

When configuring intranet applications, consider the following:

  • When Split Tunnel is ON,
    • Configure the intranet applications.
    • Assign intranet applications to every authentication, authorization, and auditing group.
  • When Split Tunnel is OFF,
    • All traffic intercepts through the VPN tunnel.
    • Intranet applications need not be configured.
  • When Split Tunnel is REVERSE,
    • Configure the intranet applications. The traffic that is not specified by the intranet applications pass through the VPN tunnel.
    • Assign the intranet applications to be excluded from VPN to every authentication, authorization, and auditing group.

    Important:

    Interception must be set to TRANSPARENT irrespective of the split tunnel configuration.

Note:

  • When configuring an intranet application, you must select an interception mode that corresponds to the type of plug-in software used to make connections.
  • You cannot configure an intranet application for both proxy and transparent interception.

To create an intranet application for one IP address

  1. On the Configuration tab, in the navigation pane, expand Citrix Gateway Resources and then click Intranet Applications.
  2. In the details pane, click Add.
  3. In Name, type a name for the profile.
  4. In the Create Intranet Application dialog box, select TRANSPARENT.
  5. In Destination Type, select IP Address and Netmask.
  6. In Protocol, select the protocol that applies to the network resource.
  7. In IP Address, type the IP address.
  8. In Netmask, type subnet mask, click Create and then click Close.

To configure an IP address range

If you have multiple servers in your network, such as web, email, and file shares, you can configure a network resource that includes the IP range for network resources. This setting allows users access to the network resources contained in the IP address range.

  1. On the Configuration tab, in the navigation pane, expand Citrix Gateway Resources and then click Intranet Applications.
  2. In the details pane, click Add.
  3. In Name, type a name for the profile.
  4. In Protocol, select the protocol that applies to the network resource.
  5. In the Create Intranet Application dialog box, select TRANSPARENT.
  6. In Destination Type, select IP Address Range.
  7. In IP Start, type the starting IP address and in IP End, type the ending IP address, click Create and then click Close.

To create an intranet application for a host name

  1. On the Configuration tab, in the navigation pane, expand Citrix Gateway Resources and then click Intranet Applications.
  2. In the details pane, click Add.
  3. In Name, type a name for the profile.
  4. In the Create Intranet Application dialog box, select TRANSPARENT.
  5. In Destination Type, select hostname.
  6. In Protocol, select ANY, click Create, and then click Close.

Important:

  • From release 13.0 build 36.27 and later, the Windows VPN plug-in supports host name (FQDN) based rules for split tunneling. You must upgrade both the Citrix ADC appliance and the Windows VPN plug-in to release 13.0 build 36.27 or later.
  • Wildcard host names are also supported. For example, if an intranet application with host name “*.example.com” is configured, a1.example.com, b2.example.com, and so on gets tunneled.
  • Host name-based intranet application works only when you have split tunneling set to ON or REVERSE.
  • Host name-based rules are not supported for reverse split tunneling.

Configure intranet applications for the Citrix Gateway plug-in for Java

If users connect with the Citrix Gateway plug-in for Java, you must configure an intranet application and set the interception mode to proxy. The Citrix Gateway plug-in for Java intercepts traffic by using the user device loopback IP address and port number specified in the profile.

If users are connecting from a Windows-based device, the Citrix Gateway plug-in for Java attempts to modify the host file by setting the application host name to access the loopback IP address and port specified in the profile. Users must have administrative privileges on the user device for the HOST file modification.

If users are connecting from a non-Windows device, you must configure applications manually by using the source IP address and port values specified in the intranet application profile.

To configure an intranet application for the Citrix Gateway plug-in for Java

  1. On the Configuration tab, in the navigation pane, expand Citrix Gateway Resources and then click Intranet Applications.
  2. In the details pane, click Add.
  3. In Name, type a name for the profile.
  4. Click Proxy.
  5. In Destination IP Address and Destination Port, type the destination IP address and port.
  6. Under Source IP Address and Source Port, type the source IP address and port.

    Note:

    Set the source IP address to the loopback IP address of 127.0.0.1. If you do not specify an IP address, the loopback IP address is used. If you do not enter a port value, the destination port value is used.