Citrix Secure Web Gateway

Integration with IPS or NGFW as inline devices

June 25, 2020

Contributed by:

S C S

Security devices such as Intrusion Prevention System (IPS) and Next Generation Firewall (NGFW) protect servers from network attacks. These devices can inspect live traffic and are typically deployed in layer 2 inline mode. Citrix Secure Web Gateway (SWG) provides security of users and the enterprise network when accessing resources on the internet.

A Citrix SWG appliance can be integrated with one or more inline devices to prevent threats and provide advanced security protection. The inline devices can be any security device, such as IPS and NGFW.

Some use cases where you can benefit by using the Citrix SWG appliance and inline device integration are:

Inspecting encrypted traffic: Most IPS and NGFW appliances bypass encrypted traffic, which can leave servers vulnerable to attacks. A Citrix SWG appliance can decrypt traffic and send it to the inline devices for inspection. This integration enhances the customer’s network security.
Offloading inline devices from TLS/SSL processing: TLS/SSL processing is expensive, which can result in high CPU utilization in IPS or NGFW appliances if they also decrypt the traffic. A Citrix SWG appliance helps in offloading TLS/SSL processing from inline devices. As a result, inline devices can inspect a higher volume of traffic.
Loading balancing inline devices: If you have configured multiple inline devices to manage heavy traffic, a Citrix SWG appliance can load balance and distribute traffic evenly to these devices.
Smart selection of traffic: Instead of sending all the traffic to the inline device for inspection, the appliance does a smart selection of traffic. For example, it skips sending text files for inspection to the inline devices.

Citrix SWG integration with inline devices

The following diagram shows how a Citrix SWG is integrated with inline security devices.

ips overview

When you integrate inline devices with Citrix SWG appliance, the components interact as follows:

A client sends a request to a Citrix SWG appliance.
The appliance sends the data to the inline device for content inspection based on the policy evaluation. For HTTPS traffic, the appliance decrypts the data and sends it in plain text to the inline device for content inspection.

Note:

If there are two or more inline devices, the appliance load balances the devices and sends the traffic.
The inline device inspects the data for threats and decides whether to drop, reset, or send the data back to the appliance.
If there are security threats, the device modifies the data and sends it to the appliance.
For HTTPS traffic, the appliance re-encrypts the data and forwards the request to the backend server.
The backend server sends the response to the appliance.
The appliance again decrypts the data and sends it to the inline device for inspection.
The inline device inspects the data. If there are security threats, the device modifies the data and sends it to the appliance.
The appliance re-encrypts the data and sends the response to the client.

Configuring inline device integration

You can configure a Citrix SWG appliance with an inline device in three different ways as follows:

Scenario 1: Using a single inline device

To integrate a security device (IPS or NGFW) in inline mode, you must enable content inspection and MAC-based forwarding (MBF) in global mode on the SWG appliance. Then, add a content inspection profile, a TCP service, a content inspection action for inline devices to reset, block, or drop the traffic based on inspection. Also add a content inspection policy that the appliance uses to decide the subset of traffic to send to the inline devices. Finally, configure the proxy virtual server with layer 2 connection enabled on the server and bind the content inspection policy to this proxy virtual server.

single inline device

Perform the following steps:

Enable MAC-based forwarding (MPF) mode.
Enable the content inspection feature.
Add a content inspection profile for the service. The content inspection profile contains the inline device settings that integrate the SWG appliance with an inline device.
(Optional) Add a TCP monitor.

Note:

Transparent devices do not have an IP address. Therefore, to perform health checks, you must explicitly bind a monitor.
Add a service. A service represents an inline device.
(Optional) Bind the service to the TCP monitor.
Add a content inspection action for the service.
Add a content inspection policy and specify the action.
Add an HTTP or HTTPS proxy (content switching) virtual server.
Bind the content inspection policy to the virtual server.

Configuration using the CLI

Type the following commands at the command prompt. Examples are given after most commands.

Enable MBF.
```
enable ns mode mbf

```

Enable the feature.

enable ns feature contentInspection
<!--NeedCopy-->

Add a content inspection profile.

add contentInspection profile <name> -type InlineInspection -egressInterface <interface_name> -ingressInterface <interface_name>[-egressVlan <positive_integer>] [-ingressVlan <positive_integer>]
<!--NeedCopy-->

Example:

add contentInspection profile ipsprof -type InlineInspection -ingressinterface "1/2" -egressInterface "1/3"
<!--NeedCopy-->

Add a service. Specify a dummy IP address that is not owned by any of the devices, including the inline devices. Set use source IP address (USIP) to YES. Set useproxyport to NO. Turn off the health monitor. Turn on health monitoring only if you bind this service to a TCP monitor. If you bind a monitor to a service, then set the TRANSPARENT option in the monitor to ON.
```
add service <service_name>  <IP> TCP <Port> - contentinspectionProfileName <Name>  -healthMonitor NO  -usip YES –useproxyport NO

```
Example:
```
add service ips_service 198.51.100.2 TCP * -healthMonitor YES -usip YES -useproxyport NO -contentInspectionProfileName ipsprof


```

Add a content inspection action.

add contentInspection action <name> -type INLINEINSPECTION -serverName <string>
<!--NeedCopy-->

Example:

add contentInspection action ips_action -type INLINEINSPECTION -serverName ips_service
<!--NeedCopy-->

Add a content inspection policy.

add contentInspection policy <name> -rule <expression> -action <string>
<!--NeedCopy-->

Example:

add contentInspection policy ips_pol -rule "HTTP.REQ.METHOD.NE(\"CONNECT\")" -action ips_action
<!--NeedCopy-->

Add a proxy virtual server.

add cs vserver <name> PROXY <IPAddress> <port> -cltTimeout <secs> -Listenpolicy <expression> -authn401 ( ON | OFF ) -authnVsName <string> -l2Conn ON
<!--NeedCopy-->

Example:

add cs vserver transparentcs PROXY * * -cltTimeout 180 -Listenpolicy exp1 -authn401 on -authnVsName swg-auth-vs-trans-http -l2Conn ON
<!--NeedCopy-->

Bind the policy to the virtual server.

bind cs vserver <name> -policyName <string> -priority <positive_integer> -gotoPriorityExpression <expression> -type REQUEST
<!--NeedCopy-->

Example:

bind cs vserver explicitcs -policyName ips_pol -priority 1 -gotoPriorityExpression END -type REQUEST
<!--NeedCopy-->

Configuration using the GUI

Navigate to System > Settings. In Modes and Features, click Configure Modes.
Navigate to System > Settings. In Modes and Features, click Configure Advanced Features.
Navigate to Secure Web Gateway > Content Inspection > Content Inspection Profiles. Click Add.
Navigate to Load Balancing > Services > Add and add a service. In Advanced Settings, click Profiles. In the CI Profile Name list, select the content inspection profile created earlier. In Service Settings, set Use Source IP Address to YES and Use Proxy Port to No. In Basic Settings, set Health Monitoring to NO. Turn on health monitoring only if you bind this service to a TCP monitor. If you bind a monitor to a service, then set the TRANSPARENT option in monitor to ON.
Navigate to Secure Web Gateway > Proxy Virtual Servers> Add. Specify a name, IP address, and port. In Advanced Settings, select Policies. Click the “+” sign.
In Choose Policy select Content Inspection. Click Continue.
Click Add. Specify a name. In Action, click Add.
Specify a name. In Type, select INLINEINSPECTION. In Server Name, select the TCP service created earlier.
Click Create. Specify the rule and click Create.
Click Bind.
Click Done.

Scenario 2: Load balance multiple inline devices with dedicated interfaces

If you are using two or more inline devices, you can load balance the devices using different content inspection services with dedicated interfaces. In this case, the Citrix SWG appliance load balances the subset of traffic sent to each device through a dedicated interface. The subset is decided based on the policies configured. For example, TXT or image files might not be sent for inspection to the inline devices.

multiple inline devices

The basic configuration remains the same as in scenario 1. However, you must create a content inspection profile for each inline device and specify the ingress and egress interface in each profile. Add a service for each inline device. Add a load balancing virtual server and specify it in the content inspection action. Perform the following extra steps:

Add content inspection profiles for each service.
Add a service for each device.
Add a load balancing virtual server.
Specify the load balancing virtual server in the content inspection action.

Configuration using the CLI

Type the following commands at the command prompt. Examples are given after each command.

Enable MBF.
```
enable ns mode mbf

```

Enable the feature.

enable ns feature contentInspection
<!--NeedCopy-->

Add profile 1 for service 1.

add contentInspection profile <name> -type InlineInspection -egressInterface <interface_name> -ingressInterface <interface_name>[-egressVlan <positive_integer>] [-ingressVlan <positive_integer>]
<!--NeedCopy-->

Example:

add contentInspection profile ipsprof1 -type InlineInspection -ingressInterface "1/2" -egressInterface "1/3"
<!--NeedCopy-->

Add profile 2 for service 2.

add contentInspection profile <name> -type InlineInspection -egressInterface <interface_name> -ingressInterface <interface_name>[-egressVlan <positive_integer>] [-ingressVlan <positive_integer>]
<!--NeedCopy-->

Example:

add contentInspection profile ipsprof2 -type InlineInspection -ingressInterface "1/4" -egressInterface "1/5"
<!--NeedCopy-->

Add service 1. Specify a dummy IP address that is not owned by any of the devices, including the inline devices. Set use source IP address (USIP) to YES. Set useproxyport to NO. Turn off the health monitor. Turn on health monitoring only if you bind this service to a TCP monitor. If you bind a monitor to a service, then set the TRANSPARENT option in the monitor to ON.
```
add service <service_name>  <IP> TCP <Port> - contentinspectionProfileName <Name>  -healthMonitor NO  -usip YES –useproxyport NO

```
Example:
```
add service ips_service1 192.168.10.2 TCP * -healthMonitor NO -usip YES -useproxyport NO -contentInspectionProfileName ipsprof1

```
Add service 2. Specify a dummy IP address that is not owned by any of the devices, including the inline devices. Set use source IP address (USIP) to YES. Set useproxyport to NO. Turn off the health monitor. Turn on health monitoring only if you bind this service to a TCP monitor. If you bind a monitor to a service, then set the TRANSPARENT option in the monitor to ON.
```
add service <service_name>  <IP> TCP <Port> - contentinspectionProfileName <Name>  -healthMonitor NO  -usip YES –useproxyport NO

```
Example:
```
add service ips_service2 192.168.10.3 TCP * -healthMonitor NO -usip YES -useproxyport NO  -contentInspectionProfileName ipsprof2

```

Add a load balancing virtual server.

add lb vserver <LB_VSERVER_NAME> TCP <IP> <port>
<!--NeedCopy-->

Example:

add lb vserver lb_inline_vserver TCP 192.0.2.100 *
<!--NeedCopy-->

Bind the services to the load balancing virtual server.

bind lb vserver <LB_VSERVER_NAME> <service_name>
bind lb vserver <LB_VSERVER_NAME> <service_name>
<!--NeedCopy-->

Example:

bind lb vserver lb_inline_vserver ips_service1
bind lb vserver lb_inline_vserver ips_service2
<!--NeedCopy-->

Specify the load balancing virtual server in the content inspection action.

add contentInspection action <name> -type INLINEINSPECTION -serverName <string>
<!--NeedCopy-->

Example:

add contentInspection action ips_action -type INLINEINSPECTION -serverName lb_inline_vserver
<!--NeedCopy-->

Add a content inspection policy. Specify the content inspection action in the policy.

add contentInspection policy <name> -rule <expression> -action <string>
<!--NeedCopy-->

Example:

add contentInspection policy ips_pol -rule "HTTP.REQ.METHOD.NE(\"CONNECT\")" -action ips_action
<!--NeedCopy-->

Add a proxy virtual server.

add cs vserver <name> PROXY <IPAddress> <port> -l2Conn ON
<!--NeedCopy-->

Example:

add cs vserver transparentcs PROXY * * -l2Conn ON
<!--NeedCopy-->

Bind the content inspection policy to the virtual server.

bind cs vserver <name> -policyName <string> -priority <positive_integer> -gotoPriorityExpression <expression> -type REQUEST
<!--NeedCopy-->

Example:

bind cs vserver explicitcs -policyName ips_pol -priority 1 -gotoPriorityExpression END -type REQUEST
<!--NeedCopy-->

Configuration using the GUI

Navigate to System > Settings. In Modes and Features, click Configure Modes.
Navigate to System > Settings. In Modes and Features, click Configure Advanced Features.
Navigate to Secure Web Gateway > Content Inspection > Content Inspection Profiles. Click Add.

Specify the ingress and egress interfaces.

Create two profiles. Specify a different ingress and egress interface in the second profile.
Navigate to Load Balancing > Services > Add and add a service. In Advanced Settings, click Profiles. In the CI Profile Name list, select the content inspection profile created earlier. In Service Settings, set Use Source IP Address to YES and Use Proxy Port to No. In Basic Settings, set Health Monitoring to NO. Turn on health monitoring only if you bind this service to a TCP monitor. If you bind a monitor to a service, then set the TRANSPARENT option in monitor to ON.

Create two services. Specify dummy IP addresses that are not owned by any of the devices, including the inline devices.
Navigate to Load Balancing > Virtual Servers > Add. Create a TCP load balancing virtual server.

Click OK.
Click inside the Load Balancing Virtual Server Service Binding section. In Service Binding, click the arrow in Select Service. Select the two services created earlier, and click Select. Click Bind.
Navigate to Secure Web Gateway > Proxy Virtual Servers> Add. Specify a name, IP address, and port. In Advanced Settings, select Policies. Click the “+” sign.
In Choose Policy select Content Inspection. Click Continue.
Click Add. Specify a name. In Action, click Add.
Specify a name. In Type, select INLINEINSPECTION. In Server Name, select the load balancing virtual server created earlier.
Click Create. Specify the rule and click Create.
Click Bind.
Click Done.

Scenario 3: Load balance multiple inline devices with shared interfaces

If you are using two or more inline devices, you can load balance the devices using different content inspection services with shared interfaces. In this case, the Citrix SWG appliance load balances the subset of traffic sent to each device through a shared interface. The subset is decided based on the policies configured. For example, TXT or image files might not be sent for inspection to the inline devices.

multiple inline devices with shared interface

The basic configuration remains the same as in scenario 2. For this scenario, bind the interfaces to different VLANs to segregate the traffic for each inline device. Specify the VLANs in the content inspection profiles. Perform the following extra steps:

Bind the shared interfaces to different VLANs.
Specify the ingress and egress VLANs in the content inspection profiles.

Configuration using the CLI

Type the following commands at the command prompt. Examples are given after each command.

Enable MBF.
```
enable ns mode mbf

```

Enable the feature.

enable ns feature contentInspection
<!--NeedCopy-->

Bind the shared interfaces to different VLANs.

bind vlan <id> -ifnum <interface> -tagged
<!--NeedCopy-->

Example:

bind vlan 100 –ifnum 1/2 tagged
bind vlan 200 –ifnum 1/3 tagged
bind vlan 300 –ifnum 1/2 tagged
bind vlan 400 –ifnum 1/3 tagged
<!--NeedCopy-->

Add profile 1 for service 1. Specify the ingress and egress VLANs in the profile.

add contentInspection profile <name> -type InlineInspection -egressInterface <interface_name> -ingressInterface <interface_name>[-egressVlan <positive_integer>] [-ingressVlan <positive_integer>]
<!--NeedCopy-->

Example:

add contentInspection profile ipsprof1 -type InlineInspection -egressInterface "1/3" -ingressinterface "1/2" –egressVlan 100 -ingressVlan 300
<!--NeedCopy-->

Add profile 2 for service 2. Specify the ingress and egress VLANs in the profile.

add contentInspection profile <name> -type InlineInspection -egressInterface <interface_name> -ingressInterface <interface_name>[-egressVlan <positive_integer>] [-ingressVlan <positive_integer>]
<!--NeedCopy-->

Example:

add contentInspection profile ipsprof2 -type InlineInspection -egressInterface "1/3" -ingressinterface "1/2" –egressVlan 200 -ingressVlan 400
<!--NeedCopy-->

Add service 1.

add service <service_name>  <IP> TCP <Port> - contentinspectionProfileName <Name>  -healthMonitor NO  -usip YES –useproxyport NO
<!--NeedCopy-->

Example:

add service ips_service1 192.168.10.2 TCP * -healthMonitor NO -usip YES -useproxyport NO -contentInspectionProfileName ipsprof1
<!--NeedCopy-->

Add service 2.

add service <service_name>  <IP> TCP <Port> - contentinspectionProfileName <Name>  -healthMonitor NO  -usip YES –useproxyport NO
<!--NeedCopy-->

Example:

add service ips_service2 192.168.10.3 TCP * -healthMonitor NO -usip YES -useproxyport NO -contentInspectionProfileName ipsprof2
<!--NeedCopy-->

Add a load balancing virtual server.

add lb vserver <LB_VSERVER_NAME> TCP <IP> <port>
<!--NeedCopy-->

Example:

add lb vserver lb_inline_vserver TCP 192.0.2.100 *
<!--NeedCopy-->

Bind the services to the load balancing virtual server.

bind lb vserver <LB_VSERVER_NAME> <service_name>
bind lb vserver <LB_VSERVER_NAME> <service_name>
<!--NeedCopy-->

Example:

bind lb vserver lb_inline_vserver ips_service1
bind lb vserver lb_inline_vserver ips_service2
<!--NeedCopy-->

Specify the load balancing virtual server in the content inspection action.

add contentInspection action <name> -type INLINEINSPECTION -serverName <string>
<!--NeedCopy-->

Example:

add contentInspection action ips_action -type INLINEINSPECTION -serverName lb_inline_vserver
<!--NeedCopy-->

Add a content inspection policy. Specify the content inspection action in the policy.

add contentInspection policy <name> -rule <expression> -action <string>
<!--NeedCopy-->

Example:

add contentInspection policy ips_pol -rule "HTTP.REQ.METHOD.NE(\"CONNECT\")" -action ips_action
<!--NeedCopy-->

Add a proxy virtual server.

add cs vserver <name> PROXY <IPAddress> <port> -l2Conn ON
<!--NeedCopy-->

Example:

add cs vserver transparentcs PROXY * * -l2Conn ON
<!--NeedCopy-->

Bind the content inspection policy to the virtual server.

bind cs vserver <name> -policyName <string> -priority <positive_integer> -gotoPriorityExpression <expression> -type REQUEST
<!--NeedCopy-->

Example:

bind cs vserver explicitcs -policyName ips_pol -priority 1 -gotoPriorityExpression END -type REQUEST
<!--NeedCopy-->

Configuration using the GUI

Navigate to System > Settings. In Modes and Features, click Configure Modes.
Navigate to System > Settings. In Modes and Features, click Configure Advanced Features.
Navigate to System > Network > VLANs > Add. Add four VLANs and tag them to the interfaces.
Navigate to Secure Web Gateway > Content Inspection > Content Inspection Profiles. Click Add.

Specify the ingress and egress VLANs.

Create another profiles. Specify a different ingress and egress VLAN in the second profile.
Navigate to Load Balancing > Services > Add and add a service. In Advanced Settings, click Profiles. In the CI Profile Name list, select the content inspection profile created earlier. In Service Settings, set Use Source IP Address to YES and Use Proxy Port to No. In Basic Settings, set Health Monitoring to NO.

Create two services. Specify dummy IP addresses that are not owned by any of the devices, including the inline devices. Specify profile 1 in service 1, and profile 2 in service 2.
Navigate to Load Balancing > Virtual Servers > Add. Create a TCP load balancing virtual server.

Click OK.
Click inside the Load Balancing Virtual Server Service Binding section. In Service Binding, click the arrow in Select Service. Select the two services created earlier, and click Select. Click Bind.
Navigate to Secure Web Gateway > Proxy Virtual Servers> Add. Specify a name, IP address, and port. In Advanced Settings, select Policies. Click the “+” sign.
In Choose Policy select Content Inspection. Click Continue.
Click Add. Specify a name. In Action, click Add.
Specify a name. In Type, select INLINEINSPECTION. In Server Name, select the load balancing virtual server created earlier.
Click Create. Specify the rule and click Create.
Click Bind.
Click Done.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Integration with IPS or NGFW as inline devices

June 25, 2020

Contributed by:

S C S

June 25, 2020

Contributed by:

S C S

Integration with IPS or NGFW as inline devices

Citrix SWG integration with inline devices

Configuring inline device integration

Scenario 1: Using a single inline device

Configuration using the CLI

Configuration using the GUI

Scenario 2: Load balance multiple inline devices with dedicated interfaces

Configuration using the CLI

Configuration using the GUI

Scenario 3: Load balance multiple inline devices with shared interfaces

Configuration using the CLI

Configuration using the GUI

In this article