Passing Client IP to a server in the Web Farm using Application Request Router

When you setup a Web Farm using Application Request Router (ARR) the value for the c-ip written to the IIS log is the IP address of the ARR server and not the client or user IP address. Click on the Server Farm from within the IIS management console, then click on the Proxy link. As shown in Figure 1, by default, the Client or user IP address is preserved, or placed into the X-Forwarded-For header.

image

Figure 1, passing the Client IP (c-ip) address through ARR

By installing Message Analyzer, found here, on the ARR server I was able to confirm this was indeed happening. Figure 2 illustrates the output of Message Analyzer and the X-Forwarded-For header. Review the “preserve client IP in the following header” element Name here for some more detail.

image

Figure 2, Client-IP for ARR clients to Server Farm servers

That’s nice, but how can you log it? Well, in this post where I discussed “What’s new in IIS 8.5”, you can now add a custom field, such as “X-Forwarded-For” to the data which IIS logs. On the Server Farm web servers, you need to add a custom field, similar to that shown in Figure 3.

image

Figure 3, add custom log filed to IIS for ARR client ip

Once added, the client or user client IP is logged into the IIS log files and using LogParser, for example, to analyze which IP is accessing your web farm, can be utilized.

How to do the same prior to IIS 8.5

There is a tool called ARRHelper which you can read about and download from here. This installs a binary file into the “%PROGRAMFILES%\IIS\ARRHelper” directory which manages the configuration and logging of the client or user IP address. (Install this on the ARR server).

Once this ARRHelper is installed on the ARR, the X-Forwarded-For value is stored in the C-IP column of the W3C IIS log on the IIS server configured in the Server Farm. Similar to how it would happen if ARR was not managing/routing/balancing the requests.

NOTE: Install this first on a staging environment and test, reading the article that discusses this ARRHelper mentions that it changes more than just the C-IP. For example, SSL Offloading and Client Certificates. View the schema file “%windir%\system32\inetsrv\config\schema\arr_helper_schema.xml” to see what change to make sure you don’t have any unwanted impact. Testing is always recommended.

UPDATE: If you use Dynamic IP restrictions with Application Request Router, take a look at the article here for Information about that. Basically, if you have enabled enableProxyMode, then the restriction is based on the X-Forwarded-For value and not on the C-IP.