Appendix A CSG2 Command Reference

subscriber-ip http-header forwarded-for

To prevent exposure of potentially sensitive IP addresses, the CSG2 can obscure the contents of X-Forwarded-For headers, overwriting the contents with blanks.

If you want to obscure the contents of the X-Forwarded-For header, enter the subscriber-iphttp-headerx-forwarded-forcommand with the obscure keyword.

If you do not want to obscure the contents of the X-Forwarded-For header, enter the subscriber-iphttp-headerx-forwarded-forcommand without the obscure keyword (the default setting).

When obscuring the IP address in X-Forwarded-For headers, keep the following considerations in mind:

The CSG2 does not obscure the IP address in fragmented request packets that have X-Forwarded-For headers, because the CSG2 does not reassemble the fragments and therefore cannot modify the packets.

The CSG2 does not obscure the X-Forwarded-For header for traffic that is downgraded from Layer 7 inspection to Layer 4 inspection.

If the active CSG2 fails over to the standby CSG2, the standby CSG2 does not obscure the IP address in X-Forwarded-For header for existing HTTP sessions. However, the standby CSG2 does obscure the IP address in X-Forwarded-For headers for new HTTP sessions.

If the subscriber sends more than one GET request with X-Forwarded-For headers, and the content host fails to send a TCP acknowledgement within five seconds, the CSG2 resets the subscriber side connection.

Examples

 

The following example configures the CSG2 to obtain the subscriber's IP address from the HTTP

 

 

X-Forwarded-For header, and obscures the IP address in the X-Forwarded-For header:

 

 

ip csg content MOVIES

 

 

 

parse protocol http

 

 

 

subscriber-ip http-header x-forwarded-for obscure

 

 

 

 

Related Commands

 

Command

Description

 

 

 

 

 

 

ip csg content

Configures content for CSG2 services, and enters CSG2 content

 

 

 

configuration mode.

 

 

 

 

 

ip csg mode single-tpEnables the CSG2 to use a single TP instead of multiple TPs.

 

 

 

 

 

 

parse length

Defines the maximum number of Layer 7 bytes that the CSG2 is to parse when

 

 

 

attempting to assign a policy.

 

 

 

 

 

 

parse protocol

Defines how the CSG2 is to parse traffic for a content.

 

 

 

 

 

 

Cisco Content Services Gateway - 2nd Generation Release 2.0 Installation and Configuration Guide

 

 

 

 

 

 

 

OL-15491-01

 

 

A-251

 

 

 

 

 

Page 251
Image 251
Cisco Systems OL-15491-01 appendix Ip csg content, 251