From: Eric Covener <covener@apache.org>
Date: Sat, 22 Dec 2012 21:16:09 +0000 (+0000)
Subject: caution about merging Location settings on top of directory/files authz config
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=be1fea4a3ec5c435c63611847021d64216fdb142;p=thirdparty%2Fapache%2Fhttpd.git

caution about merging Location settings on top of directory/files authz config

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1425345 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_authz_core.html.en b/docs/manual/mod/mod_authz_core.html.en
index 740d72b60bd..8b018c98d03 100644
--- a/docs/manual/mod/mod_authz_core.html.en
+++ b/docs/manual/mod/mod_authz_core.html.en
@@ -500,6 +500,18 @@ Require group admin
     entire request, and subsequent <code class="directive">Require</code> directives
     are ignored.</p>
 
+    <div class="warning"><h3>Security Warning</h3>
+    <p>Exercise caution when setting authorization directives in
+    <code class="directive"><a href="../mod/core.html#location">Location</a></code> sections
+    that overlap with content served out of the filesystem.  
+    By default, these <a href="../sections.html#mergin">configuration sections</a> overwrite authorization configuration
+    in <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>,  
+    and <code class="directive"><a href="../mod/core.html#files">Files</a></code> sections.</p>
+    <p>The <code class="directive"><a href="#authmerging">AuthMerging</a></code> directive 
+    can be used to control how authorization configuration sections are 
+    merged.</p>
+    </div>
+
 <h3>See also</h3>
 <ul>
 <li><a href="../howto/auth.html">Authentication, Authorization,
diff --git a/docs/manual/mod/mod_authz_core.xml b/docs/manual/mod/mod_authz_core.xml
index 70c71a0ac5a..d33a2197b1b 100644
--- a/docs/manual/mod/mod_authz_core.xml
+++ b/docs/manual/mod/mod_authz_core.xml
@@ -355,6 +355,19 @@ Require group admin
     directive.  Thus the first one to authorize a user authorizes the
     entire request, and subsequent <directive>Require</directive> directives
     are ignored.</p>
+
+    <note type="warning"><title>Security Warning</title>
+    <p>Exercise caution when setting authorization directives in
+    <directive module="core">Location</directive> sections
+    that overlap with content served out of the filesystem.  
+    By default, these <a href="../sections.html#mergin"
+    >configuration sections</a> overwrite authorization configuration
+    in <directive module="core">Directory</directive>,  
+    and <directive module="core">Files</directive> sections.</p>
+    <p>The <directive module="mod_authz_core">AuthMerging</directive> directive 
+    can be used to control how authorization configuration sections are 
+    merged.</p>
+    </note>
 </usage>
 
 <seealso><a href="../howto/auth.html">Authentication, Authorization,