Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SLAPO-SMBK5PWD(5)	      File Formats Manual	     SLAPO-SMBK5PWD(5)

NAME
       slapo-smbk5pwd -	Samba &	Kerberos password sync overlay to slapd

SYNOPSIS
       ETCDIR/slapd.conf

	      include <path to>/krb5-kdc.schema

	      include <path to>/samba.schema

	      moduleload smbk5pwd.so

	       ...

	      database mdb

	       ...

	      overlay smbk5pwd

DESCRIPTION
       The smbk5pwd overlay to 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  attrib-
       utes for	Kerberos, Samba	and/or UNIX user accounts.

       The  Samba support is written using the Samba 3.0 LDAP schema; Kerberos
       support is written for Heimdal using its	hdb-ldap backend.

       Additionally, a new {K5KEY} password hash mechanism is  provided.   For
       krb5KDCEntry objects that have this scheme specifier in their userPass-
       word  attribute,	Simple Binds will be checked against the Kerberos keys
       of the entry.  No data is needed	after the {K5KEY} scheme specifier  in
       the userPassword, it is looked up from the entry	directly.

CONFIGURATION
       The  smbk5pwd  overlay  supports	the following slapd.conf configuration
       options,	which should appear after the overlay directive:

       smbk5pwd-enable <module>
	      can be used to enable only the desired  modules.	 Legal	values
	      for <module> are

	      krb5   If	 the user has the krb5KDCEntry objectclass, update the
		     krb5Key and krb5KeyVersionNumber attributes using the new
		     password in the Password Modify operation,	 provided  the
		     Kerberos account is not expired.  Exiration is determined
		     by	evaluating the krb5ValidEnd attribute.

	      samba  If	 the user is a sambaSamAccount object, synchronize the
		     sambaNTPassword to	the password entered in	 the  Password
		     Modify operation, and update sambaPwdLastSet accordingly.

	      shadow Update  the  attribute shadowLastChange, if the entry has
		     the objectclass shadowAccount.

	      By default all modules compiled in  are  enabled.	  Setting  the
	      config  statement	 restricts the enabled modules to the ones ex-
	      plicitly mentioned.

       smbk5pwd-can-change <seconds>
	      If the samba module is enabled and the  user  is	a  sambaSamAc-
	      count, update the	attribute sambaPwdCanChange to point <seconds>
	      into  the	 future, essentially denying any Samba password	change
	      until then.  A value of 0	disables this feature.

       smbk5pwd-must-change <seconds>
	      If the samba module is enabled and the  user  is	a  sambaSamAc-
	      count,  update  the  attribute sambaPwdMustChange	to point <sec-
	      onds> into the future, essentially setting  the  Samba  password
	      expiration time.	A value	of 0 disables this feature.

       Alternatively,  the  overlay  supports  table-driven configuration, and
       thus can	be run-time loaded and configured via back-config.

EXAMPLE
       The layout of a slapd.d based, table-driven configuration  entry	 looks
       like:

	       # {0}smbk5pwd, {1}mdb, config
	       dn: olcOverlay={0}smbk5pwd,olcDatabase={1}mdb,cn=config
	       objectClass: olcOverlayConfig
	       objectClass: olcSmbK5PwdConfig
	       olcOverlay: {0}smbk5pwd
	       olcSmbK5PwdEnable: krb5
	       olcSmbK5PwdEnable: samba
	       olcSmbK5PwdMustChange: 2592000

       which enables both krb5 and samba modules with a	Samba password expira-
       tion time of 30 days (= 2592000 seconds).

SEE ALSO
       slapd.conf(5), ldappasswd(1), ldap(3),

       "OpenLDAP Administrator's Guide"	(http://www.OpenLDAP.org/doc/admin/)

ACKNOWLEDGEMENTS
       This  manual page has been written by Peter Marschall based on the mod-
       ule's README file written by Howard Chu.

       OpenLDAP	 is  developed	and  maintained	 by   The   OpenLDAP   Project
       (http://www.openldap.org/).   OpenLDAP  is  derived  from University of
       Michigan	LDAP 3.3 Release.

OpenLDAP LDVERSION		  RELEASEDATE		     SLAPO-SMBK5PWD(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=slapo-smbk5pwd&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help