1PAM_WINBIND(7) PAM_WINBIND(7)
2
6 pam_winbind - PAM module for Winbind
7
9 This tool is part of the samba(7) suite.
10 pam_winbind is a PAM module that can authenticate users against the
12 local domain by talking to the Winbind daemon.
13
15 pam_winbind supports several options which can either be set in the PAM
16 configuration files or in the pam_winbind configuration file situated
17 at /etc/security/pam_winbind.conf. Options from the PAM configuration
18 file take precedence to those from the configuration file.
19 debug
21 Gives debugging output to syslog.
22 debug_state
24 Gives detailed PAM state debugging output to syslog.
25 require_membership_of=[SID or NAME]
27 If this option is set, pam_winbind will only succeed if the user is
28 a member of the given SID or NAME. A SID can be either a group-SID,
29 a alias-SID or even a user-SID. It is also possible to give a NAME
30 instead of the SID. That name must have the form: MYDOMAIN\mygroup
31 or MYDOMAIN\myuser. pam_winbind will, in that case, lookup the SID
32 internally. Note that NAME may not contain any spaces. It is thus
33 recommended to only use SIDs. You can verify the list of SIDs a user
34 is a member of with wbinfo --user-sids=SID.
35 try_first_pass
37 use_first_pass
40 By default, pam_winbind tries to get the authentication token from a
41 previous module. If no token is available it asks the user for the
42 old password. With this option, pam_winbind aborts with an error if
43 no authentication token from a previous module is available.
44 use_authtok
46 Set the new password to the one provided by the previously stacked
47 password module. If this option is not set pam_winbind will ask the
48 user for the new password.
49 krb5_auth
51 pam_winbind can authenticate using Kerberos when winbindd is talking
52 to an Active Directory domain controller. Kerberos authentication
53 must be enabled with this parameter. When Kerberos authentication
54 can not succeed (e.g. due to clock skew), winbindd will fallback to
55 samlogon authentication over MSRPC. When this parameter is used in
56 conjunction with winbind refresh tickets, winbind will keep your
57 Ticket Granting Ticket (TGT) uptodate by refreshing it whenever nec‐
58 essary.
59 krb5_ccache_type=[type]
61 When pam_winbind is configured to try kerberos authentication by
62 enabling the krb5_auth option, it can store the retrieved Ticket
63 Granting Ticket (TGT) in a credential cache. The type of credential
64 cache can be set with this option. Currently the only supported
65 value is: FILE. In that case a credential cache in the form of
66 /tmp/krb5cc_UID will be created, where UID is replaced with the
67 numeric user id. Leave empty to just do kerberos authentication
68 without having a ticket cache after the logon has succeeded.
69 cached_login
71 Winbind allows to logon using cached credentials when winbind off‐
72 line logon is enabled. To use this feature from the PAM module this
73 option must be set.
74 silent
76 Do not emit any messages.
77
80 wbinfo(1), winbindd(8), smb.conf(5)
81
83 This man page is correct for version 3.0 of Samba.
84
86 The original Samba software and related utilities were created by
87 Andrew Tridgell. Samba is now developed by the Samba Team as an Open
88 Source project similar to the way the Linux kernel is developed.
89 This manpage was written by Jelmer Vernooij and Guenther Deschner.
91 PAM_WINBIND(7)