Help Center/ Web Application Firewall/ Best Practices/ Obtaining the Real Client IP Addresses

Updated on 2024-11-14 GMT+08:00

View PDF

Obtaining the Real Client IP Addresses

Application Scenarios

A client IP address refers to an IP address of a visitor (or the device a visitor uses to initiate the request). Sometimes, a web application needs to require the client IP address. For example, a voting system needs to obtain the client IP addresses to ensure that each client casts only once.

After your website is connected to WAF, WAF works as a reverse proxy between the client and the server. The real IP address of the server is hidden, and only the IP addresses of WAF are visible to web visitors. In this case, you can obtain the real IP address of the client through WAF or configure the website server to obtain the real IP address of the client.

The following describes how to obtain the client IP address from WAF and how to configure different types of web application servers, including Tomcat, Apache, Nginx, IIS 6, and IIS 7, to obtain the client IP address.

Architecture

Generally, a browser request does not directly reach the web server. Proxy servers, such as CDN, WAF, and advanced anti-DDoS, may be deployed between the browser and the origin server. Using WAF as an example, see Figure 1.

Figure 1 WAF deployment diagram
Click to enlarge

DNS resolves your domain name to the origin server IP address before your website is connected to WAF. Therefore, web visitors can directly access the server.
After your website is connected to WAF, DNS resolves your domain name to the CNAME record of WAF. In this way, the traffic passes through WAF. WAF then filters out illegitimate traffic and only routes legitimate traffic back to the origin server.

In this case, the access request may be forwarded by multiple layers of security or acceleration proxies before reaching the origin server. So, how does the server obtain the real IP address of the client that initiates the request?

When forwarding HTTP requests to the downstream server, the transparent proxy server adds an X-Forwarded-For field to the HTTP header to identify the client IP address in the format of X-Forwarded-For: client IP address, proxy 1-IP address, proxy 2-IP address, proxy 3-IP address, ........->....

Then, you can obtain the client IP address from the X-Forwarded-For field, the first IP address in which is the client IP address.

Constraints

Ensure that Use Layer-7 Proxy is configured correctly when you add a website to the WAF instance, or WAF cannot obtain the real IP address of your website visitors.
To ensure that WAF obtains real client IP addresses and takes protective actions configured in protection policies, select Yes for Use Layer-7 Proxy when your website has a layer-7 proxy server such as CDN and cloud acceleration products deployed in front of WAF. In other cases, select No for Use Layer-7 Proxy.
In normal cases, the first IP address in the X-Forwarded-For field is the real IP address of the client. If the length of an IPv6 address exceeds the length limit of the X-Forwarded-For field, the IP address cannot be read. In NAT64, the load balancer uses IPv4 listeners, which cannot read IPv6 addresses.

Obtaining the Client IP Address from WAF

After a website is connected to WAF, WAF is deployed between the client and server as a reverse proxy to protect the website. The principles for WAF to obtain the real IP address are as follows:

If you select Yes for Use Layer-7 Proxy when you add a domain name to WAF, WAF obtains the source IP address in the following sequence:
1. The source IP header list configured in upstream is preferentially used, that is, the IP address tag configured on the basic information page of the domain name. For details, see Configuring a Traffic Identifier for a Known Attack Source. If no IP address is available, go to 2.
  
  If you want to use a TCP connection IP address as the client IP address, set IP Tag to remote_addr.
2. Obtain the value of the cdn-src-ip field in the source IP header list configured in the config file. If no value is obtained, go to 3.
3. Obtain the value of the x-real-ip field. If no value is obtained, go to 4.
4. Obtain the first public IP address from the left of the x-forwarded-for field. If no public IP address is obtained, go to 5.
5. Obtain the value of the remote_addr field, which includes the IP address used for establishing the TCP connection.
If no proxy is used, that is, you select No for Use Layer-7 Proxy when adding the domain name to WAF, WAF obtains the source IP address from the remote_ip field.

The following describes how WAF uses the X-Forwarded-For and X-Real-IP variables to obtain the real IP address of a client:

Using the X-Forwarded-For field to obtain the client IP address

The client IP address is placed in the X-Forwarded-For HTTP header field. The format is as follows:

      
           X-Forwarded-For: Client IP address,Proxy 1-IP address,Proxy 2-IP address,...

The first IP address included in the X-Forwarded-For field is the client IP address.

The methods to obtain the X-Forwarded-For field by invoking the SDK interface in different programming languages are as follows:

ASP

Request.ServerVariables("HTTP_X_FORWARDED_FOR")

ASP.NET(C#)

Request.ServerVariables["HTTP_X_FORWARDED_FOR"]

PHP
```
$_SERVER["HTTP_X_FORWARDED_FOR"]
```

JSP

request.getHeader("HTTP_X_FORWARDED_FOR")

Using the X-Real-IP field to obtain the client IP address (modifications caused by reverse proxies is considered)
The methods to obtain the X-Real-IP field by invoking the SDK interface in different programming languages are as follows:
- ASP
```
Request.ServerVariables("HTTP_X_REAL_IP")
```
- ASP.NET(C#)
```
Request.ServerVariables["HTTP_X_REAL_IP"]
```
- PHP
```
$_SERVER["HTTP_X_REAL_IP"]
```
- JSP
```
request.getHeader("HTTP_X_REAL_IP")
```

How Does Tomcat Obtain the Client IP Address from Access Logs?

If Tomcat is deployed on your origin server, you can enable the X-Forwarded-For function of Tomcat to obtain the client IP address.

Open the server.xml file in the tomcat/conf/ directory. Partial information about the AccessLogValue logging function is as follows:

<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
        <Valve className="org.apache.catalina.values.AccessLogValue" directory="logs"
               prefix="localhost_access_log." suffix=".txt"
               pattern="%h %l %u %t "%r" %s %b" />

Add %{X-Forwarded-For}i to pattern. Part of the modified server.xml file is as follows:

<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
        <Valve className="org.apache.catalina.valves.AccessLogValue" directory="logs"
               prefix="localhost_access_log." suffix=".txt"
               pattern="%{X-Forwarded-For}i %h %l %u %t "%r" %s %b" />
</Host>

View the localhost_access_log file to obtain the client IP address from the X-Forwarded-For field.

How Does Apache Obtain the Client IP Address from Access Logs?

If Apache HTTP Server 2.4 or later is deployed on your origin server, you can use the mod_remoteip.so file under remoteip_module in the Apache installation package to obtain the real client IP address.

CentOS 7.6
1. Add the following content to the httpd.conf file:
```
LoadModule remoteip_module modules/mod_remoteip.so ##Load the mod_remoteip.so module.
RemoteIPHeader X-Forwarded-For ## Set RemoteIPHeader.
RemoteIPInternalProxy WAF IP address range##Set the WAF back-to-source IP address range.
```
  For more details, see How Do I Whitelist the WAF Back-to-Source IP Address Ranges?
  - File /etc/httpd/conf.modules.d/00-base.conf:46 has been added to the mod_remoteip.so module.
  - Use spaces to separate multiple back-to-source IP address ranges.
2. Replace %h with %a in the log format file.
```
LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined 
LogFormat "%a %l %u %t \"%r\" %>s %b" common
```
3. Restart the Apache service to make the configuration take effect.

Ubuntu 20.04.2
1. Add the following content to the apache2.conf file:
```
ln -s ../mods-available/remoteip.load /etc/apache2/mods-enabled/remoteip.load  ##Load the mod_remoteip.so module.
RemoteIPHeader X-Forwarded-For   ## Set RemoteIPHeader.
RemoteIPInternalProxy WAF IP address range##Set the WAF back-to-source IP address range.
```
  For more details, see How Do I Whitelist the WAF Back-to-Source IP Address Ranges?
  - You can also add the following content to load the mod_remoteip.so module:
    LoadModule remoteip_module /usr/lib/apache2/modules/mod_remoteip.so
  - Use spaces to separate multiple back-to-source IP address ranges.
2. Replace %h with %a in the log format file.
```
LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined 
LogFormat "%a %l %u %t \"%r\" %>s %b" common
```
3. Restart the Apache service to make the configuration take effect.

If Apache 2.2 or earlier is deployed on your origin server, to obtain the real client IP address, you can run commands to install third-party module mod_rpaf of Apache and modify the http.conf file

Run the following commands to install third-party module mod_rpaf for Apache:

wget https://github.com/gnif/mod_rpaf/archive/v0.6.0.tar.gz
tar xvfz mod_rpaf-0.6.tar.gz
cd mod_rpaf-0.6
/usr/local/apache/bin/apxs -i -c -n mod_rpaf-2.0.so mod_rpaf-2.0.c

Open the httpd.conf configuration file and modify the file content as follows:

LoadModule rpaf_module   modules/mod_rpaf-2.0.so ##Load module mod_rpaf.
<IfModule mod_rpaf.c>
RPAFenable On
RPAFsethostname On
RPAFproxy_ips 127.0.0.1 <Reverse proxy IP address>
RPAFheader X-Forwarded-For
</IfModule>

Define the log format.

LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" common

Enable customized logs.

CustomLog"[Apache server directory]/logs/$access.log"common

Restart the Apache server for the configuration to take effect.
```
/[Apache server directory]/httpd/bin/apachectl restart
```
View the access.log file to obtain the client IP address from the X-Forwarded-For field.

How Does Nginx Obtain the Client IP Address from Access Logs?

If an Nginx reverse proxy is deployed on your origin server, you can configure location information on the Nginx reverse proxy so that the backend web server can use similar functions to obtain the client IP address

Configure the following information in the corresponding location of the Nginx reverse proxy to obtain the information about the client IP address:

      
           Location ^ /<uri> {
    proxy_pass  ....;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

The backend web server obtains the real IP address of your website visitors by defining the Nginx log parameter $http_x_forwarded_for.

Example

log_format main ' "<$http_Cdn_Src_IP>" "{$http_x_real_ip}" "[$http_x_forwarded_for]" "$remote_addr" ' '$http_user_agent - $remote_user [$time_local] "$request" '   ' $status $body_bytes_sent "$http_referer" ';

How Does IIS 6 Obtain the Client IP Address from Access Logs?

If you have deployed an IIS 6 server on your origin server, you can install the F5XForwardedFor.dll plug-in and obtain the client IP address from the access logs recorded by the IIS 6 server.

Download the F5XForwardedFor module.
Copy the F5XForwardedFor.dll file in the x86\Release or x64\Release directory to a specified directory (for example, C:\ISAPIFilters) based on the operating system version of your server. Ensure that the IIS process has the read permission for the directory.
Open the IIS manager, right-click the website that is currently open, and choose Attribute from the shortcut menu. The Attribute page is displayed.
On the Attribute page, switch to ISAPI filter and click Add. In the dialog box that is displayed, configure the following information:
- Filter Name: Set this parameter to F5XForwardedFor.
- Executable file: Set this parameter to the full path of F5XForwardedFor.dll, for example, C:\ISAPIFilters\F5XForwardedFor.dll.
Click OK to restart the IIS 6 server.
View the access logs recorded by the IIS 6 server (the default log path is C:\WINDOWS\system32\LogFiles\, and the IIS log file name extension is .log). You can obtain client IP address from the X-Forwarded-For field.

How Does IIS 7 Obtain the Client IP Address from Access Logs?

If you have deployed an IIS 7 server on your origin server, you can install the F5XForwardedFor.dll module and obtain the client IP address from the access logs recorded by the IIS 7 server.

Download the F5XForwardedFor module.
Copy the F5XFFHttpModule.dll and F5XFFHttpModule.ini files in the x86\Release or x64\Release directory to a specified directory (for example, C:\x_forwarded_for\x86 or C:\x_forwarded_for\x64) based on the operating system version of your server. Ensure that the IIS process has the read permission for the directory.
On the server home page, double-click Modules to go to the Modules page.
Click Configure Native Module. In the dialog box displayed, click Register.
In the displayed dialog box, register the downloaded DLL file according to the operating system, and then click OK.
- x86 operating system: registration module x_forwarded_for_x86
  - Name: x_forwarded_for_x86
  - Path: C:\x_forwarded_for\x86\F5XFFHttpModule.dll
- x64: Register the module x_forwarded_for_x64.
  - Name: x_forwarded_for_x64
  - Path: C:\x_forwarded_for\x64\F5XFFHttpModule.dll
After the registration is complete, select the newly registered module (x_forwarded_for_x86 or x_forwarded_for_x64) and click OK.
In ISAPI and CGI restriction, add the registered DLL files by operating system and change Restriction to Permitting.
- x86 operating system:
  - ISAPI or CGI path: C:\x_forwarded_for\x86\F5XFFHttpModule.dll
  - Description: x86
- x64 operating system:
  - ISAPI or CGI path: C:\x_forwarded_for\x64\F5XFFHttpModule.dll
  - Description: x64
Restart the IIS 7 server and wait for the configuration to take effect.
View the access logs recorded by the IIS 7 server (the default log path is C:\WINDOWS\system32\LogFiles\, and the IIS log file name extension is .log). You can obtain the client IP address from the X-Forwarded-For field.

How Does WAF Obtain the Real Client IP Addresses for Services Deployed in CCE?

If your service is deployed on Cloud Container Engine (CCE), CCE records the real client IP address in the X-Original-Forwarded-For field and records the WAF back-to-source address in the X-Forwarded-For field. You need to modify the CCE configuration file to enable Ingress to add the real IP address to the X-Forwarded-For field. In this way, WAF can obtain the real client IP address.

To modify the CCE configuration file, take the following steps:

Run the following command to modify the kube-system/nginx-configuration configuration file:
```
kubectl -n kube-system edit cm nginx-configuration
```

Add the following information to the configuration file:

compute-full-forwarded-for: "true"
forwarded-for-header: "X-Forwarded-For" 
use-forwarded-headers: "true"

Save the configuration file.

The configuration takes effect after you save the file. Ingress adds the real client IP addresses to the X-Forwarded-For field.
Modify the field for the service to obtain the real client IP addresses to X-Original-Forwarded-For.