From: Graham Leggett This module is used to treat the client which initiated the
- request as the originating client as identified by httpd for the
- purposes of authorization and logging, even where that client is
+ This module is used to treat the useragent which initiated the
+ request as the originating useragent as identified by httpd for the
+ purposes of authorization and logging, even where that useragent is
behind a load balancer, front end server, or proxy server. The module overrides the peer IP address for the connection
- with the client IP address reported in the request header configured
+ The module overrides the client IP address for the connection
+ with the useragent IP address reported in the request header configured
with the Once replaced as instructed, this overridden client IP address is
+ Once replaced as instructed, this overridden useragent IP address is
then used for the Apache by default identifies the client with the connection's
- peer_ip value, and the connection remote_host and remote_logname are
+ Apache by default identifies the useragent with the connection's
+ client_ip value, and the connection remote_host and remote_logname are
derived from this value. These fields play a role in authentication,
authorization and logging and other purposes by other loadable
modules. mod_remoteip overrides the peer IP of the connection with the
- advertised client IP as provided by a proxy or load balancer, for
+ mod_remoteip overrides the client IP of the connection with the
+ advertised useragent IP as provided by a proxy or load balancer, for
the duration of the request. A load balancer might establish a long
lived keepalive connection with the server, and each request will
- have the correct client IP, even though the underlying peer IP
+ have the correct useragent IP, even though the underlying client IP
address of the load balancer remains unchanged. When multiple, comma delimited client IP addresses are listed in the
+ When multiple, comma delimited useragent IP addresses are listed in the
header value, they are processed in Right-to-Left order. Processing
- halts when a given client IP address is not trusted to present the
+ halts when a given useragent IP address is not trusted to present the
preceding IP address. The header field is updated to this remaining
list of unconfirmed IP addresses, or if all IP addresses were trusted,
this header is removed from the request altogether. The The The conn_rec->remote_ip and conn_rec->remote_addr
-
mod_proxy
Description: Replaces the original peer IP address for the connection
-with the client IP address list presented by a proxies or a load balancer
+ Description: Replaces the original client IP address for the connection
+with the useragent IP address list presented by a proxies or a load balancer
via the request headers.
@@ -33,26 +33,27 @@ via the request headers.
Status: Base Source File: mod_remoteip.c Summary
- RemoteIPHeader
directive.mod_authz_host
<Require ip>
feature, is reported by mod_status
, and is recorded by
mod_log_config
%a
and core
- %a
format strings. The underlying peer IP of the connection
+ %a
format strings. The underlying client IP of the connection
is available in the %{c}a
format string.Directives
@@ -76,22 +77,22 @@ via the request headers.
Remote IP Processing
- RemoteIPHeader Directive
-
+Description: Declare the header field which should be parsed for client IP addresses Description: Declare the header field which should be parsed for useragent IP addresses Syntax: RemoteIPHeader header-field
Context: server config, virtual host
@@ -125,8 +126,8 @@ via the request headers.
Status: Base RemoteIPHeader
directive triggers
mod_remoteip
to treat the value of the specified
- header-field header as the client IP address, or list
- of intermediate client IP addresses, subject to further configuration
+ header-field header as the useragent IP address, or list
+ of intermediate useragent IP addresses, subject to further configuration
of the RemoteIPInternalProxy
and
RemoteIPTrustedProxy
directives. Unless these
other directives are used, mod_remoteip
will trust all
@@ -152,7 +153,7 @@ via the request headers.
RemoteIPInternalProxy
directive adds one
or more addresses (or address blocks) to trust as presenting a valid
- RemoteIPHeader value of the client IP. Unlike the
+ RemoteIPHeader value of the useragent IP. Unlike the
RemoteIPTrustedProxy
directive, any IP address
presented in this header, including private intranet addresses, are
trusted when passed from these proxies.RemoteIPInternalProxyList
directive specifies
a file parsed at startup, and builds a list of addresses (or address blocks)
- to trust as presenting a valid RemoteIPHeader value of the client IP.
The '#
' hash character designates a comment line, otherwise
each whitespace or newline separated entry is processed identically to
@@ -204,7 +205,7 @@ via the request headers.
The RemoteIPProxiesHeader
directive specifies
a header into which mod_remoteip
will collect a list of
- all of the intermediate client IP addresses trusted to resolve the client
+ all of the intermediate client IP addresses trusted to resolve the useragent
IP of the request. Note that intermediate
RemoteIPTrustedProxy
addresses are recorded in
this header, while any intermediate
@@ -227,11 +228,11 @@ via the request headers.
The RemoteIPTrustedProxy
directive adds one
or more addresses (or address blocks) to trust as presenting a valid
- RemoteIPHeader value of the client IP. Unlike the
+ RemoteIPHeader value of the useragent IP. Unlike the
RemoteIPInternalProxy
directive, any intranet
or private IP address reported by such proxies, including the 10/8, 172.16/12,
192.168/16, 169.254/16 and 127/8 blocks (or outside of the IPv6 public
- 2000::/3 block) are not trusted as the client IP, and are left in the
+ 2000::/3 block) are not trusted as the useragent IP, and are left in the
RemoteIPHeader
header's value.
The
@@ -252,7 +253,7 @@ via the request headers.
RemoteIPTrustedProxyList
directive specifies
a file parsed at startup, and builds a list of addresses (or address blocks)
- to trust as presenting a valid RemoteIPHeader value of the client IP.
The '#
' hash character designates a comment line, otherwise
each whitespace or newline seperated entry is processed identically to
diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en
index 1ba7a0575f..4e41354ec3 100644
--- a/docs/manual/mod/quickreference.html.en
+++ b/docs/manual/mod/quickreference.html.en
@@ -704,7 +704,7 @@ a different URL