Blame docs/manual/mod/mod_authz_groupfile.html.en

Packit 90a5c9
Packit 90a5c9
Packit 90a5c9
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
Packit 90a5c9
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
Packit 90a5c9
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
              This file is generated from xml source: DO NOT EDIT
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
      -->
Packit 90a5c9
<title>mod_authz_groupfile - Apache HTTP Server Version 2.4</title>
Packit 90a5c9
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
Packit 90a5c9
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
Packit 90a5c9
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
Packit 90a5c9
<script src="../style/scripts/prettify.min.js" type="text/javascript">
Packit 90a5c9
</script>
Packit 90a5c9
Packit 90a5c9
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
Packit 90a5c9
<body>
Packit 90a5c9
Packit 90a5c9

Modules | Directives | FAQ | Glossary | Sitemap

Packit 90a5c9

Apache HTTP Server Version 2.4

Packit 90a5c9
Packit 90a5c9
<-
Packit 90a5c9
Packit 90a5c9
Apache > HTTP Server > Documentation > Version 2.4 > Modules
Packit 90a5c9
Packit 90a5c9

Apache Module mod_authz_groupfile

Packit 90a5c9
Packit 90a5c9

Available Languages:  en  |

Packit 90a5c9
 fr  |
Packit 90a5c9
 ja  |
Packit 90a5c9
 ko 

Packit 90a5c9
Packit 90a5c9
Description:Group authorization using plaintext files
Packit 90a5c9
Status:Base
Packit 90a5c9
Module Identifier:authz_groupfile_module
Packit 90a5c9
Source File:mod_authz_groupfile.c
Packit 90a5c9
Compatibility:Available in Apache 2.1 and later
Packit 90a5c9

Summary

Packit 90a5c9
Packit 90a5c9
    

This module provides authorization capabilities so that

Packit 90a5c9
    authenticated users can be allowed or denied access to portions
Packit 90a5c9
    of the web site by group membership. Similar functionality is
Packit 90a5c9
    provided by mod_authz_dbm.

Packit 90a5c9
Packit 90a5c9
Support Apache!

Topics

Packit 90a5c9
    Packit 90a5c9
  • The Require Directives
  • Packit 90a5c9

    Directives

    Packit 90a5c9
      Packit 90a5c9
    • AuthGroupFile
    • Packit 90a5c9
      Packit 90a5c9

      Bugfix checklist

      See also

      Packit 90a5c9
        Packit 90a5c9
      • Require
      • Packit 90a5c9
      • Comments
      • Packit 90a5c9
        top
        Packit 90a5c9
        Packit 90a5c9

        The Require Directives

        Packit 90a5c9
        Packit 90a5c9
            

        Apache's Require

        Packit 90a5c9
            directives are used during the authorization phase to ensure that
        Packit 90a5c9
            a user is allowed to access a resource.  mod_authz_groupfile extends the
        Packit 90a5c9
            authorization types with group and group-file.
        Packit 90a5c9
            

        Packit 90a5c9
        Packit 90a5c9
            

        Since v2.4.8, expressions are supported

        Packit 90a5c9
            within the groupfile require directives.

        Packit 90a5c9
        Packit 90a5c9

        Require group

        Packit 90a5c9
        Packit 90a5c9
            

        This directive specifies group membership that is required for the

        Packit 90a5c9
            user to gain access.

        Packit 90a5c9
        Packit 90a5c9
            
        Require group admin
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9

        Require file-group

        Packit 90a5c9
        Packit 90a5c9
            

        When this directive is specified, the filesystem permissions on

        Packit 90a5c9
            the file being accessed are consulted. The user must be a member of
        Packit 90a5c9
            a group with the same name as the group that owns the file.
        Packit 90a5c9
            See mod_authz_owner for more
        Packit 90a5c9
            details.

        Packit 90a5c9
        Packit 90a5c9
            
        Require file-group
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        top
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Description:Sets the name of a text file containing the list
        Packit 90a5c9
        of user groups for authorization
        Packit 90a5c9
        Syntax:AuthGroupFile file-path
        Packit 90a5c9
        Context:directory, .htaccess
        Packit 90a5c9
        Override:AuthConfig
        Packit 90a5c9
        Status:Base
        Packit 90a5c9
        Module:mod_authz_groupfile
        Packit 90a5c9
        Packit 90a5c9
            

        The AuthGroupFile directive sets the

        Packit 90a5c9
            name of a textual file containing the list of user groups for user
        Packit 90a5c9
            authorization. File-path is the path to the group
        Packit 90a5c9
            file. If it is not absolute, it is treated as relative to the ServerRoot.

        Packit 90a5c9
        Packit 90a5c9
            

        Each line of the group file contains a groupname followed by a

        Packit 90a5c9
            colon, followed by the member usernames separated by spaces.

        Packit 90a5c9
        Packit 90a5c9
            

        Example:

        Packit 90a5c9
              mygroup: bob joe anne
        Packit 90a5c9
            

        Packit 90a5c9
        Packit 90a5c9
            

        Note that searching large text files is very

        Packit 90a5c9
            inefficient; AuthDBMGroupFile provides a much better performance.

        Packit 90a5c9
        Packit 90a5c9
            

        Security

        Packit 90a5c9
              

        Make sure that the AuthGroupFile is

        Packit 90a5c9
              stored outside the document tree of the web-server; do not
        Packit 90a5c9
              put it in the directory that it protects. Otherwise, clients may
        Packit 90a5c9
              be able to download the AuthGroupFile.

        Packit 90a5c9
            
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9

        Available Languages:  en  |

        Packit 90a5c9
         fr  |
        Packit 90a5c9
         ja  |
        Packit 90a5c9
         ko 

        Packit 90a5c9
        top

        Comments

        Notice:
        This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
        Packit 90a5c9
        <script type="text/javascript">
        Packit 90a5c9
        var comments_shortname = 'httpd';
        Packit 90a5c9
        var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_authz_groupfile.html';
        Packit 90a5c9
        (function(w, d) {
        Packit 90a5c9
            if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
        Packit 90a5c9
                d.write('
        <\/div>');
        Packit 90a5c9
                var s = d.createElement('script');
        Packit 90a5c9
                s.type = 'text/javascript';
        Packit 90a5c9
                s.async = true;
        Packit 90a5c9
                s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
        Packit 90a5c9
                (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
        Packit 90a5c9
            }
        Packit 90a5c9
            else { 
        Packit 90a5c9
                d.write('
        Comments are disabled for this page at the moment.<\/div>');
        Packit 90a5c9
            }
        Packit 90a5c9
        })(window, document);
        Packit 90a5c9
        //--></script>
        Packit 90a5c9

        Copyright 2018 The Apache Software Foundation.
        Licensed under the Apache License, Version 2.0.

        Packit 90a5c9

        Modules | Directives | FAQ | Glossary | Sitemap

        <script type="text/javascript">
        Packit 90a5c9
        if (typeof(prettyPrint) !== 'undefined') {
        Packit 90a5c9
            prettyPrint();
        Packit 90a5c9
        }
        Packit 90a5c9
        //--></script>
        Packit 90a5c9
        </body></html>