diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index afd6d99c61..b3ee2536f8 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -505,8 +505,9 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
Directives placed in Proxy
- sections apply only to matching proxied content using a simple string prefix match against the URL. Shell-style wildcards are also
- allowed.
+ sections apply only to matching proxied content using a simple string
+ prefix match against the URL. Shell-style wildcards are also allowed.
+
For example, the following will allow only hosts in
yournetwork.example.com to access content via your proxy
@@ -528,6 +529,14 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10
</Proxy>
+ Warning
+ This configuration section does not canonicalize any part of the string
+ being matched such as schemes, hostnames, IP addresses, etc. Care should be
+ taken if using it for access control, including but not limited to
+ denying access by default and allowing expected hostnames rather than the
+ inverse where a denial could be bypassed by using alternate forms.
+
+
Differences from the Location configuration section
A backend URL matches the configuration section if it begins with the
the wildcard-url string, even if the last path segment in the
@@ -591,6 +600,14 @@ proxied resources
type="section">Proxy directive, except that it matches URLs
using regular expressions.
+ Warning
+ This configuration section does not canonicalize any part of the string
+ being matched such as schemes, hostnames, IP addresses, etc. Care should be
+ taken if using it for access control, including but not limited to
+ denying access by default and allowing expected hostnames rather than the
+ inverse where a denial could be bypassed by using alternate forms.
+
+
From 2.4.8 onwards, named groups and backreferences are captured and
written to the environment with the corresponding name prefixed with
"MATCH_" and in upper case. This allows elements of URLs to be referenced