Apache Reference: mod_auth_dbm, AuthDBMGroupFile

AuthDBMGroupFile

DBM File with Groups for Authentication
Syntax: AuthDBMGroupFile A
Example: AuthDBMGroupFile /etc/www-groups.dbm
Since: Apache 1.0

This directive specifies the DBM file containing the list of user groups for user authentication. The file argument consists of the absolute path to the group file, which keyed on the user name. The value for a user is a comma-separated list of the groups to which the user belongs. No whitespace can appear within the value, nor any colons. In some cases, it is easier to manage a single database that contains both the password and group details for each user. This approach simplifies any necessary support programs; they must then deal with writing to and locking only a single DBM file. This task can be accomplished by setting the group and password files to point to the same DBM, with the key for the single DBM being the user name. The value then consists of a password section containing the UNIX crypt(3) password, followed by a colon and the comma-separated list of groups. Other data may optionally appear in the DBM file after another colon; the authentication module ignores this information.