35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<?xml version="1.0"?>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd<!-- $LastChangedRevision$ -->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd<!--
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding Licensed to the Apache Software Foundation (ASF) under one or more
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding contributor license agreements. See the NOTICE file distributed with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding this work for additional information regarding copyright ownership.
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding The ASF licenses this file to You under the Apache License, Version 2.0
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding (the "License"); you may not use this file except in compliance with
db479b48bd4d75423ed4a45e15b75089d1a8ad72fielding the License. You may obtain a copy of the License at
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd http://www.apache.org/licenses/LICENSE-2.0
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd Unless required by applicable law or agreed to in writing, software
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd distributed under the License is distributed on an "AS IS" BASIS,
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd See the License for the specific language governing permissions and
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd limitations under the License.
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd-->
d5d794fc2f4cc9ca6d6da17cfa2cdcd8d244bacdnd
7db9f691a00ead175b03335457ca296a33ddf31bnd<modulesynopsis metafile="mod_authz_user.xml.meta">
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd
860b4efe27e7c1c9a2bf5c872b29c90f76849b51jim<name>mod_authz_user</name>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<description>User Authorization</description>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<status>Base</status>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<sourcefile>mod_authz_user.c</sourcefile>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<identifier>authz_user_module</identifier>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<summary>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd <p>This module provides authorization capabilities so that
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd authenticated users can be allowed or denied access to portions
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd of the web site. <module>mod_authz_user</module> grants
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd access if the authenticated user is listed in a <code>Require user</code>
5140e49bf921295ad107d1a161d7e276eb3a209bnoodl directive. Alternatively <code>Require valid-user</code> can be used to
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd grant access to all successfully authenticated users.</p>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd</summary>
9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6noodl<seealso><directive module="mod_authz_core">Require</directive></seealso>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd
194c1e226415b5f34251d249ffe2f8b96c835637minfrin<section id="requiredirectives"><title>The Require Directives</title>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <p>Apache's <directive module="mod_authz_core">Require</directive>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin directives are used during the authorization phase to ensure that
194c1e226415b5f34251d249ffe2f8b96c835637minfrin a user is allowed to access a resource. mod_authz_user extends the
194c1e226415b5f34251d249ffe2f8b96c835637minfrin authorization types with <code>user</code> and <code>valid-user</code>.
194c1e226415b5f34251d249ffe2f8b96c835637minfrin </p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
9a2b3982c53d51e2d2df29b6f94cc25e2ed134bcjailletc <p>Since v2.4.8, <a href="/expr.html">expressions</a> are supported
194c1e226415b5f34251d249ffe2f8b96c835637minfrin within the user require directives.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin<section id="requser"><title>Require user</title>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <p>This directive specifies a list of users that are allowed to gain
194c1e226415b5f34251d249ffe2f8b96c835637minfrin access.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <highlight language="config">
194c1e226415b5f34251d249ffe2f8b96c835637minfrin Require user john paul george ringo
194c1e226415b5f34251d249ffe2f8b96c835637minfrin </highlight>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin</section>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin<section id="reqvaliduser"><title>Require valid-user</title>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <p>When this directive is specified, any successfully authenticated
194c1e226415b5f34251d249ffe2f8b96c835637minfrin user will be allowed to gain access.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <highlight language="config">
194c1e226415b5f34251d249ffe2f8b96c835637minfrin Require valid-user
194c1e226415b5f34251d249ffe2f8b96c835637minfrin </highlight>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin</section>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
194c1e226415b5f34251d249ffe2f8b96c835637minfrin</section>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd</modulesynopsis>