mod_allowmethods.xml revision 1f1b6bf13313fdd14a45e52e553d3ff28689b717
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<?xml version="1.0"?>
135c1278adef96d36fd421c536b1acc54a341cfbsf<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
135c1278adef96d36fd421c536b1acc54a341cfbsf<!-- $LastChangedRevision$ -->
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf<!--
135c1278adef96d36fd421c536b1acc54a341cfbsfUpon adding a new module XML doc, you will need to:
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsfsvn ps svn:eol-style native <alltextfiles>
135c1278adef96d36fd421c536b1acc54a341cfbsfsvn ps svn:keywords LastChangedRevision mod_allowmethods.xml
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsfin order for it to rebuild correctly.
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf-->
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<!--
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim Licensed to the Apache Software Foundation (ASF) under one or more
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim contributor license agreements. See the NOTICE file distributed with
135c1278adef96d36fd421c536b1acc54a341cfbsf this work for additional information regarding copyright ownership.
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim The ASF licenses this file to You under the Apache License, Version 2.0
135c1278adef96d36fd421c536b1acc54a341cfbsf (the "License"); you may not use this file except in compliance with
135c1278adef96d36fd421c536b1acc54a341cfbsf the License. You may obtain a copy of the License at
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf http://www.apache.org/licenses/LICENSE-2.0
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf Unless required by applicable law or agreed to in writing, software
135c1278adef96d36fd421c536b1acc54a341cfbsf distributed under the License is distributed on an "AS IS" BASIS,
135c1278adef96d36fd421c536b1acc54a341cfbsf WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
135c1278adef96d36fd421c536b1acc54a341cfbsf See the License for the specific language governing permissions and
135c1278adef96d36fd421c536b1acc54a341cfbsf limitations under the License.
135c1278adef96d36fd421c536b1acc54a341cfbsf-->
135c1278adef96d36fd421c536b1acc54a341cfbsf
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<modulesynopsis metafile="mod_allowmethods.xml.meta">
135c1278adef96d36fd421c536b1acc54a341cfbsf<name>mod_allowmethods</name>
135c1278adef96d36fd421c536b1acc54a341cfbsf<description>Easily restrict what HTTP methods can be used on the server</description>
b75b4bfd9e8ec9fbf28a95174dc0e4d420f744a8sf<status>Experimental</status>
135c1278adef96d36fd421c536b1acc54a341cfbsf<sourcefile>mod_allowmethods.c</sourcefile>
135c1278adef96d36fd421c536b1acc54a341cfbsf<identifier>allowmethods_module</identifier>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf<summary>
3c640343042e15b347e37fc5a135fefb9adb9e15poirier<p>This module makes it easy to restrict what HTTP methods can
135c1278adef96d36fd421c536b1acc54a341cfbsfused on an server. The most common configuration would be:</p>
135c1278adef96d36fd421c536b1acc54a341cfbsf
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<highlight language="config">
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar&lt;Location "/"&gt;
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh AllowMethods GET POST OPTIONS
bb5f5fcc4eda30c74b8c63be6c1cadab1c66e10drjung&lt;/Location&gt;
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh</highlight>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf</summary>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf<directivesynopsis>
135c1278adef96d36fd421c536b1acc54a341cfbsf<name>AllowMethods</name>
6eb57493b38ce140653ca90aeac5f43ff4891e06rjung<description>Restrict access to the listed HTTP methods</description>
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<syntax>AllowMethods reset|<em>HTTP-method</em>
135c1278adef96d36fd421c536b1acc54a341cfbsf[<em>HTTP-method</em>]...</syntax>
135c1278adef96d36fd421c536b1acc54a341cfbsf<default>AllowMethods reset</default>
135c1278adef96d36fd421c536b1acc54a341cfbsf<contextlist><context>directory</context></contextlist>
135c1278adef96d36fd421c536b1acc54a341cfbsf<status>Experimental</status>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf<usage>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf<p>The HTTP-methods are case sensitive, and are generally as per
bb5f5fcc4eda30c74b8c63be6c1cadab1c66e10drjungRFC given in upper case. The GET and HEAD methods are treated as
bb5f5fcc4eda30c74b8c63be6c1cadab1c66e10drjungequivalent. The <code>reset</code> keyword can be used
135c1278adef96d36fd421c536b1acc54a341cfbsfturn off <module>mod_allowmethods</module> in a deeper nested context:</p>
135c1278adef96d36fd421c536b1acc54a341cfbsf
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh<highlight language="config">
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar&lt;Location "/svn"&gt;
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh AllowMethods reset
135c1278adef96d36fd421c536b1acc54a341cfbsf&lt;/Location&gt;
6f10385908fbdfd4849e4bc50e690ee54c62f2cdhumbedooh</highlight>
135c1278adef96d36fd421c536b1acc54a341cfbsf
aac47fe3b5d59036cde1cc3f680d4cb0784846ebrjung<note><title>Caution</title>
aac47fe3b5d59036cde1cc3f680d4cb0784846ebrjung <p>The TRACE method can not be denied by this module,
aac47fe3b5d59036cde1cc3f680d4cb0784846ebrjung use <directive module="core">TraceEnable</directive> instead.</p>
aac47fe3b5d59036cde1cc3f680d4cb0784846ebrjung</note>
aac47fe3b5d59036cde1cc3f680d4cb0784846ebrjung
135c1278adef96d36fd421c536b1acc54a341cfbsf<p><module>mod_allowmethods</module> was written to replace the rather
135c1278adef96d36fd421c536b1acc54a341cfbsfkludgy implementation of <directive module="core">Limit</directive> and
135c1278adef96d36fd421c536b1acc54a341cfbsf<directive module="core">LimitExcept</directive>.</p>
135c1278adef96d36fd421c536b1acc54a341cfbsf</usage>
135c1278adef96d36fd421c536b1acc54a341cfbsf</directivesynopsis>
135c1278adef96d36fd421c536b1acc54a341cfbsf
135c1278adef96d36fd421c536b1acc54a341cfbsf</modulesynopsis>
135c1278adef96d36fd421c536b1acc54a341cfbsf