Replacing Headers using iRules

Well, given the examples you listed, it looks as though you may be looking for different functionality than what the HTTP::header replace command gives.

This command will replace the last instance of whatever header you name, with the contents provided. Note that the header name will remain the same.

This means, given your example:

when HTTP_REQUEST {
  if { [HTTP::header exists "X-Forwarded-For"] } {
    HTTP::header replace "X-Forwarded-For" "WL-Proxy-Client-IP"
  }
}

You would end up with a header named "X-Forwarded-For" with a value of "WL-Proxy-Client-IP". Note that this would be that exact text, not the value of the Proxy-Client-IP, unless the value was stated there instead of the name.

In the working example, below, you are removing the X-Forwarded-For header, and replacing it wwith a DIFFERENT header, named completely differently, with the client's IP address as its value.

So, to use the replace command to garner similar results, you would do something to this effect:

when HTTP_REQUEST {
  if { [HTTP::header exists "X-Forwarded-For"] } {
    HTTP::header replace "X-Forwarded-For" [IP::client_addr]
  }
}

This would result in a header named X-Forwarded-For, with a value of the client's IP address. If you're looking to change the name of the header, then the second example you gave, using the remove then the insert with a new name, is the correct syntax.

HTH,

-Colin