Client IP addresses in HTTP headers (-r)

The -r junction option allows us to insert client IP address information into the HTTP headers of requests destined for junctioned application servers. The HTTP header information enables applications on junctioned third-party servers to perform actions based on this IP address information.

HTTP header information must be transformed by the back-end server to environment variable format for use by a service on the back-end server. Header information is transformed into a CGI environment variable format by replacing all dashes (-) with underscores (_) and prepending "HTTP" to the beginning of the string. The value of the HTTP header becomes the value of the new environment variable.

HTTP Header Field
specific to
  Security Verify Access
CGI Environment
Variable Equivalent
Description
iv-remote-address HTTP_IV_REMOTE_ADDRESS The IP address of the client. This value could also represent the IP address of a proxy server or a network address translator (NAT).
iv-remote-address-ipv6 HTTP_IV_REMOTE_ADDRESS_IPV6 The IP address of the client in IPv6 format.

The -r option specifies the IP address of the incoming request be sent to the back-end application server. The option is expressed without any arguments.

The -r option is also supported on virtual host junctions.

Parent topic: Single Sign-on Solutions