Apache Reference: mod_auth_db, AuthDBGroupFile

AuthDBGroupFile

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

This directive specifies the DB file containing the list of user groups for user authentication. The file argument consists of the absolute path to the group file, which is 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 DB file. This task can be accomplished by first setting the group and password files to point to the same DB, with the key for the single DB being the username. 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 DB file after another colon; the authentication module ignores this information.