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 740d72b60bd02b0d9295e322813c5f03778b2f43..8b018c98d0354f683f2d6a596c90a4d10500fc86 100644 (file)
--- 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 70c71a0ac5a9305f157d4da06946e50a66da79e3..d33a2197b1be92814b45930caeab9145378d26ea 100644 (file)
--- 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,