mod_authz_groupfile.xml revision 9cd3b05d7b70f07a742bbaf548fa4fa2bdbe5ce6
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<?xml version="1.0"?>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<!-- $LastChangedRevision$ -->
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<!--
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync Licensed to the Apache Software Foundation (ASF) under one or more
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync contributor license agreements. See the NOTICE file distributed with
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync this work for additional information regarding copyright ownership.
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync The ASF licenses this file to You under the Apache License, Version 2.0
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync (the "License"); you may not use this file except in compliance with
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync the License. You may obtain a copy of the License at
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync http://www.apache.org/licenses/LICENSE-2.0
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync Unless required by applicable law or agreed to in writing, software
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync distributed under the License is distributed on an "AS IS" BASIS,
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync See the License for the specific language governing permissions and
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync limitations under the License.
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync-->
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<modulesynopsis metafile="mod_authz_groupfile.xml.meta">
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<name>mod_authz_groupfile</name>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<description>Group authorization using plaintext files</description>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<status>Base</status>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<sourcefile>mod_authz_groupfile.c</sourcefile>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<identifier>authz_groupfile_module</identifier>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<compatibility>Available in Apache 2.1 and later</compatibility>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<summary>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <p>This module provides authorization capabilities so that
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync authenticated users can be allowed or denied access to portions
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync of the web site by group membership. Similar functionality is
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync provided by <module>mod_authz_dbm</module>.</p>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync</summary>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<seealso><directive module="mod_authz_core">Require</directive></seealso>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<directivesynopsis>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<name>AuthGroupFile</name>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<description>Sets the name of a text file containing the list
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsyncof user groups for authorization</description>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<syntax>AuthGroupFile <var>file-path</var></syntax>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<contextlist><context>directory</context><context>.htaccess</context>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync</contextlist>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<override>AuthConfig</override>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync<usage>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <p>The <directive>AuthGroupFile</directive> directive sets the
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync name of a textual file containing the list of user groups for user
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync authorization. <var>File-path</var> is the path to the group
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync file. If it is not absolute, it is treated as relative to the <directive
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync module="core">ServerRoot</directive>.</p>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <p>Each line of the group file contains a groupname followed by a
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync colon, followed by the member usernames separated by spaces.</p>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <example><title>Example:</title>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync mygroup: bob joe anne
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync </example>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <p>Note that searching large text files is <em>very</em>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync inefficient; <directive module="mod_authz_dbm"
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync >AuthDBMGroupFile</directive> provides a much better performance.</p>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <note type="warning"><title>Security</title>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync <p>Make sure that the <directive>AuthGroupFile</directive> is
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync stored outside the document tree of the web-server; do <em>not</em>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync put it in the directory that it protects. Otherwise, clients may
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync be able to download the <directive>AuthGroupFile</directive>.</p>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync </note>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync</usage>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync</directivesynopsis>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync</modulesynopsis>
a734c64bff58bda2fa48c2795453e092167b0ff7vboxsync