← Back to branch summary

~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to docs/manual/mod/mod_authz_groupfile.html.en

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
http://bugs.debian.org/396265
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/manual/mod/mod_authz_groupfile.html.en
 
1
<?xml version="1.0" encoding="ISO-8859-1"?>
 
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 
3
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
 
4
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 
5
              This file is generated from xml source: DO NOT EDIT
 
6
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 
7
      -->
 
8
<title>mod_authz_groupfile - Apache HTTP Server</title>
 
9
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
 
10
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
 
11
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
 
12
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
 
13
<body>
 
14
<div id="page-header">
 
15
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
 
16
<p class="apache">Apache HTTP Server Version 2.2</p>
 
17
<img alt="" src="../images/feather.gif" /></div>
 
18
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
 
19
<div id="path">
 
20
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.2</a> &gt; <a href="./">Modules</a></div>
 
21
<div id="page-content">
 
22
<div id="preamble"><h1>Apache Module mod_authz_groupfile</h1>
 
23
<div class="toplang">
 
24
<p><span>Available Languages: </span><a href="../en/mod/mod_authz_groupfile.html" title="English">&nbsp;en&nbsp;</a> |
 
25
<a href="../ja/mod/mod_authz_groupfile.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 
26
<a href="../ko/mod/mod_authz_groupfile.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
27
</div>
 
28
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Group authorization using plaintext files</td></tr>
 
29
<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr>
 
30
<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>authz_groupfile_module</td></tr>
 
31
<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_authz_groupfile.c</td></tr>
 
32
<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1 and later</td></tr></table>
 
33
<h3>Summary</h3>
 
34
 
 
35
    <p>This module provides authorization capabilities so that
 
36
    authenticated users can be allowed or denied access to portions
 
37
    of the web site by group membership. Similar functionality is
 
38
    provided by <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>.</p>
 
39
</div>
 
40
<div id="quickview"><h3 class="directives">Directives</h3>
 
41
<ul id="toc">
 
42
<li><img alt="" src="../images/down.gif" /> <a href="#authgroupfile">AuthGroupFile</a></li>
 
43
<li><img alt="" src="../images/down.gif" /> <a href="#authzgroupfileauthoritative">AuthzGroupFileAuthoritative</a></li>
 
44
</ul>
 
45
<h3>See also</h3>
 
46
<ul class="seealso">
 
47
<li><code class="directive"><a href="../mod/core.html#require">Require</a></code></li>
 
48
<li><code class="directive"><a href="../mod/core.html#satisfy">Satisfy</a></code></li>
 
49
</ul></div>
 
50
 
 
51
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 
52
<div class="directive-section"><h2><a name="AuthGroupFile" id="AuthGroupFile">AuthGroupFile</a> <a name="authgroupfile" id="authgroupfile">Directive</a></h2>
 
53
<table class="directive">
 
54
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets the name of a text file containing the list
 
55
of user groups for authorization</td></tr>
 
56
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthGroupFile <var>file-path</var></code></td></tr>
 
57
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
 
58
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 
59
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
 
60
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_groupfile</td></tr>
 
61
</table>
 
62
    <p>The <code class="directive">AuthGroupFile</code> directive sets the
 
63
    name of a textual file containing the list of user groups for user
 
64
    authorization. <var>File-path</var> is the path to the group
 
65
    file. If it is not absolute, it is treated as relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
 
66
 
 
67
    <p>Each line of the group file contains a groupname followed by a
 
68
    colon, followed by the member usernames separated by spaces.</p>
 
69
 
 
70
    <div class="example"><h3>Example:</h3><p><code>
 
71
      mygroup: bob joe anne
 
72
    </code></p></div> 
 
73
 
 
74
    <p>Note that searching large text files is <em>very</em>
 
75
    inefficient; <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> provides a much better performance.</p>
 
76
 
 
77
    <div class="warning"><h3>Security</h3>
 
78
      <p>Make sure that the <code class="directive">AuthGroupFile</code> is
 
79
      stored outside the document tree of the web-server; do <em>not</em>
 
80
      put it in the directory that it protects. Otherwise, clients may
 
81
      be able to download the <code class="directive">AuthGroupFile</code>.</p>
 
82
    </div>
 
83
 
 
84
</div>
 
85
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 
86
<div class="directive-section"><h2><a name="AuthzGroupFileAuthoritative" id="AuthzGroupFileAuthoritative">AuthzGroupFileAuthoritative</a> <a name="authzgroupfileauthoritative" id="authzgroupfileauthoritative">Directive</a></h2>
 
87
<table class="directive">
 
88
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sets whether authorization will be passed on to lower level
 
89
modules</td></tr>
 
90
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>AuthzGroupFileAuthoritative On|Off</code></td></tr>
 
91
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>AuthzGroupFileAuthoritative On</code></td></tr>
 
92
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>directory, .htaccess</td></tr>
 
93
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>AuthConfig</td></tr>
 
94
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Base</td></tr>
 
95
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_groupfile</td></tr>
 
96
</table>
 
97
    <p>Setting the <code class="directive">AuthzGroupFileAuthoritative</code>
 
98
    directive explicitly to <code>Off</code> allows for
 
99
    group authorization to be passed on to lower level modules (as defined
 
100
    in the <code>modules.c</code> files) if there is <strong>no
 
101
    group</strong> matching the supplied userID.</p>
 
102
 
 
103
    <p>By default, control is not passed on and an unknown group
 
104
    will result in an Authentication Required reply. Not
 
105
    setting it thus keeps the system secure and forces an NCSA
 
106
    compliant behaviour.</p>
 
107
 
 
108
    <div class="warning"><h3>Security</h3>
 
109
      <p>Do consider the implications of allowing a user to
 
110
      allow fall-through in his <code>.htaccess</code> file; and verify
 
111
      that this is really what you want; Generally it is easier to just
 
112
      secure a single <code>.htpasswd</code> file, than it is to secure
 
113
      a database which might have more access interfaces.</p>
 
114
    </div>
 
115
 
 
116
</div>
 
117
</div>
 
118
<div class="bottomlang">
 
119
<p><span>Available Languages: </span><a href="../en/mod/mod_authz_groupfile.html" title="English">&nbsp;en&nbsp;</a> |
 
120
<a href="../ja/mod/mod_authz_groupfile.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 
121
<a href="../ko/mod/mod_authz_groupfile.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 
122
</div><div id="footer">
 
123
<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 
124
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
 
125
</body></html>
 
 
b'\\ No newline at end of file'