56f4659edf8fa4b2a7565c2c5b54277d650c63c3
[sysconfig/dovecot.git] / conf.d / auth-system.conf.ext
1 # Authentication for system users. Included from auth.conf.
2 #
3 # <doc/wiki/PasswordDatabase.txt>
4 # <doc/wiki/UserDatabase.txt>
5
6 # PAM authentication. Preferred nowadays by most systems.
7 # PAM is typically used with either userdb passwd or userdb static.
8 # REMEMBER: You'll need /etc/pam.d/dovecot file created for PAM
9 # authentication to actually work. <doc/wiki/PasswordDatabase.PAM.txt>
10 passdb {
11   driver = pam
12   # [session=yes] [setcred=yes] [failure_show_msg=yes] [max_requests=<n>]
13   # [cache_key=<key>] [<service name>]
14   #args = dovecot
15 }
16
17 # System users (NSS, /etc/passwd, or similiar).
18 # In many systems nowadays this uses Name Service Switch, which is
19 # configured in /etc/nsswitch.conf. <doc/wiki/AuthDatabase.Passwd.txt>
20 #passdb {
21   #driver = passwd
22   # [blocking=no]
23   #args = 
24 #}
25
26 # Shadow passwords for system users (NSS, /etc/shadow or similiar).
27 # Deprecated by PAM nowadays.
28 # <doc/wiki/PasswordDatabase.Shadow.txt>
29 #passdb {
30   #driver = shadow
31   # [blocking=no]
32   #args = 
33 #}
34
35 # PAM-like authentication for OpenBSD.
36 # <doc/wiki/PasswordDatabase.BSDAuth.txt>
37 #passdb {
38   #driver = bsdauth
39   # [blocking=no] [cache_key=<key>]
40   #args =
41 #}
42
43 ##
44 ## User databases
45 ##
46
47 # System users (NSS, /etc/passwd, or similiar). In many systems nowadays this
48 # uses Name Service Switch, which is configured in /etc/nsswitch.conf.
49 userdb {
50   # <doc/wiki/AuthDatabase.Passwd.txt>
51   driver = passwd
52   # [blocking=no]
53   #args = 
54 }
55
56 # Static settings generated from template <doc/wiki/UserDatabase.Static.txt>
57 #userdb {
58   #driver = static
59   # Can return anything a userdb could normally return. For example:
60   #
61   #  args = uid=500 gid=500 home=/var/mail/%u
62   #
63   # LDA and LMTP needs to look up users only from the userdb. This of course
64   # doesn't work with static userdb because there is no list of users.
65   # Normally static userdb handles this by doing a passdb lookup. This works
66   # with most passdbs, with PAM being the most notable exception. If you do
67   # the user verification another way, you can add allow_all_users=yes to
68   # the args in which case the passdb lookup is skipped.
69   #
70   #args =
71 #}