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