mod_authz_user.xml revision 194c1e226415b5f34251d249ffe2f8b96c835637
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
5f5d1b4cc970b7f06ff8ef6526128e9a27303d88nd<!-- $LastChangedRevision$ -->
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 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.
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd <p>This module provides authorization capabilities so that
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd authenticated users can be allowed or denied access to portions
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>
9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6noodl<seealso><directive module="mod_authz_core">Require</directive></seealso>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin<section id="requiredirectives"><title>The Require Directives</title>
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>Since v2.5.0, <a href="/expr.html">expressions</a> are supported
194c1e226415b5f34251d249ffe2f8b96c835637minfrin within the user require directives.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <p>This directive specifies a list of users that are allowed to gain
194c1e226415b5f34251d249ffe2f8b96c835637minfrin access.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin Require user john paul george ringo
194c1e226415b5f34251d249ffe2f8b96c835637minfrin </highlight>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin<section id="reqvaliduser"><title>Require valid-user</title>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin <p>When this directive is specified, any successfully authenticated
194c1e226415b5f34251d249ffe2f8b96c835637minfrin user will be allowed to gain access.</p>
194c1e226415b5f34251d249ffe2f8b96c835637minfrin Require valid-user
194c1e226415b5f34251d249ffe2f8b96c835637minfrin </highlight>
35ffb30f57f777dbf3f17c5a5ddf706559942c16nd</modulesynopsis>