File: slapo-smbk5pwd.5

package info (click to toggle)
openldap 2.4.44+dfsg-5+deb9u3
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 27,140 kB
  • sloc: ansic: 286,761; sh: 42,918; cpp: 11,224; makefile: 2,793; sql: 1,714; perl: 527; tcl: 45
file content (179 lines) | stat: -rw-r--r-- 4,017 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
.TH SLAPO-SMBK5PWD 5 "RELEASEDATE" "OpenLDAP LDVERSION"
.\" Copyright 2015 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH NAME
slapo-smbk5pwd \- Samba & Kerberos password sync overlay to slapd
.SH SYNOPSIS
ETCDIR/slapd.conf
.RS
.LP
include
.B "<path to>/krb5-kdc.schema"
.LP
include
.B "<path to>/samba.schema"
.LP
moduleload
.B smbk5pwd.so
.LP
 ...
.LP
database mdb
.LP
 ...
.LP
overlay
.B smbk5pwd
.RE

.SH DESCRIPTION
.LP
The 
.B smbk5pwd
overlay to
.BR slapd (8)
overloads the Password Modify Extended Operation (RFC 3062) to update
Kerberos keys and Samba password hashes for an LDAP user, as well as
updating password change related attributes for Kerberos, Samba and/or
UNIX user accounts.
.LP
The Samba support is written using the Samba 3.0 LDAP schema;
Kerberos support is written for Heimdal using its hdb-ldap backend.
.LP
Additionally, a new
.B {K5KEY}
password hash mechanism is provided.
For
.B krb5KDCEntry
objects that have this scheme specifier in their
.I userPassword
attribute, Simple Binds will be checked against the Kerberos keys of the entry.
No data is needed after the
.B {K5KEY}
scheme specifier in the
.IR userPassword ,
it is looked up from the entry directly.

.SH CONFIGURATION
The 
.B smbk5pwd
overlay supports the following
.B slapd.conf
configuration options, which should appear after the
.B overlay
directive:
.TP
.BI smbk5pwd-enable " <module>"
can be used to enable only the desired modules.
Legal values for
.I <module>
are
.LP
.RS
.TP
.B krb5
If the user has the
.B krb5KDCEntry
objectclass, update the
.B krb5Key
and
.B krb5KeyVersionNumber
attributes using the new password in the Password Modify operation,
provided the Kerberos account is not expired.
Exiration is determined by evaluating the
.B krb5ValidEnd
attribute.
.TP
.B samba
If the user is a
.B sambaSamAccount
object, synchronize the
.B sambaLMPassword
and
.B sambaNTPassword
to the password entered in the Password Modify operation, and update
.B sambaPwdLastSet
accordingly.
.TP
.B shadow
Update the attribute
.BR shadowLastChange ,
if the entry has the objectclass
.BR shadowAccount .
.LP
By default all modules compiled in are enabled.
Setting the config statement restricts the enabled modules to the ones
explicitly mentioned.
.RE
.TP
.BI smbk5pwd-can-change " <seconds>"
If the
.B samba
module is enabled and the user is a
.BR sambaSamAccount ,
update the attribute
.B sambaPwdCanChange
to point
.I <seconds>
into the future, essentially denying any Samba password change until then.
A value of
.B 0
disables this feature.
.TP
.BI smbk5pwd-must-change " <seconds>"
If the
.B samba
module is enabled and the user is a
.BR sambaSamAccount ,
update the attribute
.B sambaPwdMustChange
to point
.I <seconds>
into the future, essentially setting the Samba password expiration time.
A value of
.B 0
disables this feature.
.LP
Alternatively, the overlay supports table-driven configuration,
and thus can be run-time loaded and configured via back-config.

.SH EXAMPLE
The layout of a slapd.d based, table-driven configuration entry looks like:
.LP
.EX
        # {0}smbk5pwd, {1}bdb, config
        dn: olcOverlay={0}smbk5pwd,olcDatabase={1}mdb,cn=config
        objectClass: olcOverlayConfig
        objectClass: olcSmbK5PwdConfig
        olcOverlay: {0}smbk5pwd
        olcSmbK5PwdEnable: krb5
        olcSmbK5PwdEnable: samba
        olcSmbK5PwdMustChange: 2592000
.EE
.LP
which enables both
.B krb5
and
.B samba
modules with a Samba password expiration time of 30 days (=
.B 2592000
seconds).

.SH SEE ALSO
.BR slapd.conf (5),
.BR ldappasswd (1),
.BR ldap (3),
.LP
"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
.LP

.SH ACKNOWLEDGEMENTS
This manual page has been writen by Peter Marschall based on the
module's README file written by Howard Chu.
.LP
.B OpenLDAP
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
.B OpenLDAP
is derived from University of Michigan LDAP 3.3 Release.