132ee6ac1c26d6e8953836316ba50734eefab47bsf<?xml version="1.0"?>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
132ee6ac1c26d6e8953836316ba50734eefab47bsf<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<!-- $LastChangedRevision$ -->
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<!--
132ee6ac1c26d6e8953836316ba50734eefab47bsf Licensed to the Apache Software Foundation (ASF) under one or more
132ee6ac1c26d6e8953836316ba50734eefab47bsf contributor license agreements. See the NOTICE file distributed with
132ee6ac1c26d6e8953836316ba50734eefab47bsf this work for additional information regarding copyright ownership.
132ee6ac1c26d6e8953836316ba50734eefab47bsf The ASF licenses this file to You under the Apache License, Version 2.0
132ee6ac1c26d6e8953836316ba50734eefab47bsf (the "License"); you may not use this file except in compliance with
132ee6ac1c26d6e8953836316ba50734eefab47bsf the License. You may obtain a copy of the License at
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf http://www.apache.org/licenses/LICENSE-2.0
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf Unless required by applicable law or agreed to in writing, software
132ee6ac1c26d6e8953836316ba50734eefab47bsf distributed under the License is distributed on an "AS IS" BASIS,
132ee6ac1c26d6e8953836316ba50734eefab47bsf WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
132ee6ac1c26d6e8953836316ba50734eefab47bsf See the License for the specific language governing permissions and
132ee6ac1c26d6e8953836316ba50734eefab47bsf limitations under the License.
132ee6ac1c26d6e8953836316ba50734eefab47bsf-->
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<modulesynopsis metafile="mod_allowhandlers.xml.meta">
132ee6ac1c26d6e8953836316ba50734eefab47bsf<name>mod_allowhandlers</name>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<description>Easily restrict what HTTP handlers can be used on the server</description>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<status>Experimental</status>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<sourcefile>mod_allowhandlers.c</sourcefile>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<identifier>allowhandlers_module</identifier>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<summary>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<p>This module makes it easy to restrict which handlers may be used for a
132ee6ac1c26d6e8953836316ba50734eefab47bsfrequest. A possible configuration would be:</p>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<highlight language="config">
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar&lt;Location "/"&gt;
132ee6ac1c26d6e8953836316ba50734eefab47bsf AllowHandlers not server-info server-status balancer-manager ldap-status
132ee6ac1c26d6e8953836316ba50734eefab47bsf&lt;/Location&gt;
132ee6ac1c26d6e8953836316ba50734eefab47bsf</highlight>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<p>It also registers a handler named <code>forbidden</code> that simply
132ee6ac1c26d6e8953836316ba50734eefab47bsfreturns 403 FORBIDDEN to the client. This can be used with directives like
132ee6ac1c26d6e8953836316ba50734eefab47bsf<directive module="mod_mime">AddHandler</directive>.</p>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf</summary>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<seealso><directive module="core">SetHandler</directive></seealso>
a6fc6b44b7f8ad7390864b3555341d3abf867f7end<seealso><directive module="mod_mime">AddHandler</directive></seealso>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<directivesynopsis>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<name>AllowHandlers</name>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<description>Restrict access to the listed handlers</description>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<syntax>AllowHandlers [not] none|<em>handler-name</em>
132ee6ac1c26d6e8953836316ba50734eefab47bsf[none|<em>handler-name</em>]...</syntax>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<default>AllowHandlers all</default>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<contextlist><context>directory</context></contextlist>
132ee6ac1c26d6e8953836316ba50734eefab47bsf<status>Experimental</status>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<usage>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<p>The handler names are case sensitive. The special name
132ee6ac1c26d6e8953836316ba50734eefab47bsf<code>none</code> can be used to match the case where no handler has been
132ee6ac1c26d6e8953836316ba50734eefab47bsfset. The special vallue <code>all</code> can be used to allow all
132ee6ac1c26d6e8953836316ba50734eefab47bsfhandlers again in a later config section, even if some headers were denied
132ee6ac1c26d6e8953836316ba50734eefab47bsfearlier in the configuration merge order:</p>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf<highlight language="config">
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar&lt;Location "/server-status"&gt;
132ee6ac1c26d6e8953836316ba50734eefab47bsf AllowHandlers all
132ee6ac1c26d6e8953836316ba50734eefab47bsf SetHandler server-status
132ee6ac1c26d6e8953836316ba50734eefab47bsf&lt;/Location&gt;
132ee6ac1c26d6e8953836316ba50734eefab47bsf</highlight>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf</usage>
132ee6ac1c26d6e8953836316ba50734eefab47bsf</directivesynopsis>
132ee6ac1c26d6e8953836316ba50734eefab47bsf
132ee6ac1c26d6e8953836316ba50734eefab47bsf</modulesynopsis>