Public release of pam_groupuser
[pam-groupuser.git] / README
1 This tiny PAM module makes possible to authenticate to group user accounts,
2 where
3
4 - the group user has got an own group with the same name as its username
5 - the group members are real users, who want to access the resources
6   (email, files) of the group user
7
8 The pam_groupuser.so module must be referred two times in the PAM
9 configuration for the given service/resources, i.e.
10
11 auth required pam_groupuser.so
12 <all normal auth modules>
13 auth required pam_groupuser.so second-pass
14
15 The users must use the username "groupusername*realusername" and the
16 password belonging to "realusername". The first call to pam_groupusers.so
17 sets the username for PAM to "realusername", so the authentication modules
18 will use the real username for authentication. The second call to
19 pam_groupusers.so sets the username for PAM to "groupusername", so the
20 account and session environment is set up according to groupusername.
21
22 The applications which supports this kind of setups:
23
24 - dovecot POP/IMAP server
25 - vsfptd FTP server
26
27 Jozsef Kadlecsik <kadlec@blackhole.kfki.hu>