3 # Unix SMB/CIFS implementation.
4 # Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007-2010
5 # Copyright (C) Matthias Dieter Wallnoefer 2009
7 # Based on the original in EJS:
8 # Copyright (C) Andrew Tridgell <tridge@samba.org> 2005
9 # Copyright (C) Giampaolo Lauria <lauria2@yahoo.com> 2011
11 # This program is free software; you can redistribute it and/or modify
12 # it under the terms of the GNU General Public License as published by
13 # the Free Software Foundation; either version 3 of the License, or
14 # (at your option) any later version.
16 # This program is distributed in the hope that it will be useful,
17 # but WITHOUT ANY WARRANTY; without even the implied warranty of
18 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 # GNU General Public License for more details.
21 # You should have received a copy of the GNU General Public License
22 # along with this program. If not, see <http://www.gnu.org/licenses/>.
25 """Convenience functions for using the SAM."""
32 from samba
import dsdb
33 from samba
.ndr
import ndr_unpack
, ndr_pack
34 from samba
.dcerpc
import drsblobs
, misc
35 from samba
.common
import normalise_int32
37 __docformat__
= "restructuredText"
40 class SamDB(samba
.Ldb
):
41 """The SAM database."""
45 def __init__(self
, url
=None, lp
=None, modules_dir
=None, session_info
=None,
46 credentials
=None, flags
=0, options
=None, global_schema
=True,
47 auto_connect
=True, am_rodc
=None):
51 elif url
is None and lp
is not None:
56 super(SamDB
, self
).__init
__(url
=url
, lp
=lp
, modules_dir
=modules_dir
,
57 session_info
=session_info
, credentials
=credentials
, flags
=flags
,
61 dsdb
._dsdb
_set
_global
_schema
(self
)
63 if am_rodc
is not None:
64 dsdb
._dsdb
_set
_am
_rodc
(self
, am_rodc
)
66 def connect(self
, url
=None, flags
=0, options
=None):
67 '''connect to the database'''
68 if self
.lp
is not None and not os
.path
.exists(url
):
69 url
= self
.lp
.private_path(url
)
72 super(SamDB
, self
).connect(url
=url
, flags
=flags
,
76 '''return True if we are an RODC'''
77 return dsdb
._am
_rodc
(self
)
80 '''return the domain DN'''
81 return str(self
.get_default_basedn())
83 def disable_account(self
, search_filter
):
84 """Disables an account
86 :param search_filter: LDAP filter to find the user (eg
90 flags
= samba
.dsdb
.UF_ACCOUNTDISABLE
91 self
.toggle_userAccountFlags(search_filter
, flags
, on
=True)
93 def enable_account(self
, search_filter
):
96 :param search_filter: LDAP filter to find the user (eg
100 flags
= samba
.dsdb
.UF_ACCOUNTDISABLE | samba
.dsdb
.UF_PASSWD_NOTREQD
101 self
.toggle_userAccountFlags(search_filter
, flags
, on
=False)
103 def toggle_userAccountFlags(self
, search_filter
, flags
, flags_str
=None,
104 on
=True, strict
=False):
105 """toggle_userAccountFlags
107 :param search_filter: LDAP filter to find the user (eg
109 :flags: samba.dsdb.UF_* flags
110 :on: on=True (default) => set, on=False => unset
111 :strict: strict=False (default) ignore if no action is needed
112 strict=True raises an Exception if...
114 res
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
115 expression
=search_filter
, attrs
=["userAccountControl"])
117 raise Exception("Unable to find account where '%s'" % search_filter
)
118 assert(len(res
) == 1)
119 account_dn
= res
[0].dn
121 old_uac
= int(res
[0]["userAccountControl"][0])
123 if strict
and (old_uac
& flags
):
124 error
= "Account flag(s) '%s' already set" % flags_str
125 raise Exception(error
)
127 new_uac
= old_uac | flags
129 if strict
and not (old_uac
& flags
):
130 error
= "Account flag(s) '%s' already unset" % flags_str
131 raise Exception(error
)
133 new_uac
= old_uac
& ~flags
135 if old_uac
== new_uac
:
141 delete: userAccountControl
142 userAccountControl: %u
143 add: userAccountControl
144 userAccountControl: %u
145 """ % (account_dn
, old_uac
, new_uac
)
146 self
.modify_ldif(mod
)
148 def force_password_change_at_next_login(self
, search_filter
):
149 """Forces a password change at next login
151 :param search_filter: LDAP filter to find the user (eg
154 res
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
155 expression
=search_filter
, attrs
=[])
157 raise Exception('Unable to find user "%s"' % search_filter
)
158 assert(len(res
) == 1)
167 self
.modify_ldif(mod
)
169 def newgroup(self
, groupname
, groupou
=None, grouptype
=None,
170 description
=None, mailaddress
=None, notes
=None, sd
=None):
171 """Adds a new group with additional parameters
173 :param groupname: Name of the new group
174 :param grouptype: Type of the new group
175 :param description: Description of the new group
176 :param mailaddress: Email address of the new group
177 :param notes: Notes of the new group
178 :param sd: security descriptor of the object
181 group_dn
= "CN=%s,%s,%s" % (groupname
, (groupou
or "CN=Users"), self
.domain_dn())
183 # The new user record. Note the reliance on the SAMLDB module which
184 # fills in the default informations
185 ldbmessage
= {"dn": group_dn
,
186 "sAMAccountName": groupname
,
187 "objectClass": "group"}
189 if grouptype
is not None:
190 ldbmessage
["groupType"] = normalise_int32(grouptype
)
192 if description
is not None:
193 ldbmessage
["description"] = description
195 if mailaddress
is not None:
196 ldbmessage
["mail"] = mailaddress
198 if notes
is not None:
199 ldbmessage
["info"] = notes
202 ldbmessage
["nTSecurityDescriptor"] = ndr_pack(sd
)
206 def deletegroup(self
, groupname
):
209 :param groupname: Name of the target group
212 groupfilter
= "(&(sAMAccountName=%s)(objectCategory=%s,%s))" % (ldb
.binary_encode(groupname
), "CN=Group,CN=Schema,CN=Configuration", self
.domain_dn())
213 self
.transaction_start()
215 targetgroup
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
216 expression
=groupfilter
, attrs
=[])
217 if len(targetgroup
) == 0:
218 raise Exception('Unable to find group "%s"' % groupname
)
219 assert(len(targetgroup
) == 1)
220 self
.delete(targetgroup
[0].dn
)
222 self
.transaction_cancel()
225 self
.transaction_commit()
227 def add_remove_group_members(self
, groupname
, listofmembers
,
228 add_members_operation
=True):
229 """Adds or removes group members
231 :param groupname: Name of the target group
232 :param listofmembers: Comma-separated list of group members
233 :param add_members_operation: Defines if its an add or remove
237 groupfilter
= "(&(sAMAccountName=%s)(objectCategory=%s,%s))" % (
238 ldb
.binary_encode(groupname
), "CN=Group,CN=Schema,CN=Configuration", self
.domain_dn())
239 groupmembers
= listofmembers
.split(',')
241 self
.transaction_start()
243 targetgroup
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
244 expression
=groupfilter
, attrs
=['member'])
245 if len(targetgroup
) == 0:
246 raise Exception('Unable to find group "%s"' % groupname
)
247 assert(len(targetgroup
) == 1)
251 addtargettogroup
= """
254 """ % (str(targetgroup
[0].dn
))
256 for member
in groupmembers
:
257 targetmember
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
258 expression
="(|(sAMAccountName=%s)(CN=%s))" % (
259 ldb
.binary_encode(member
), ldb
.binary_encode(member
)), attrs
=[])
261 if len(targetmember
) != 1:
264 if add_members_operation
is True and (targetgroup
[0].get('member') is None or str(targetmember
[0].dn
) not in targetgroup
[0]['member']):
266 addtargettogroup
+= """add: member
268 """ % (str(targetmember
[0].dn
))
270 elif add_members_operation
is False and (targetgroup
[0].get('member') is not None and str(targetmember
[0].dn
) in targetgroup
[0]['member']):
272 addtargettogroup
+= """delete: member
274 """ % (str(targetmember
[0].dn
))
277 self
.modify_ldif(addtargettogroup
)
280 self
.transaction_cancel()
283 self
.transaction_commit()
285 def newuser(self
, username
, password
,
286 force_password_change_at_next_login_req
=False,
287 useusernameascn
=False, userou
=None, surname
=None, givenname
=None,
288 initials
=None, profilepath
=None, scriptpath
=None, homedrive
=None,
289 homedirectory
=None, jobtitle
=None, department
=None, company
=None,
290 description
=None, mailaddress
=None, internetaddress
=None,
291 telephonenumber
=None, physicaldeliveryoffice
=None, sd
=None,
293 """Adds a new user with additional parameters
295 :param username: Name of the new user
296 :param password: Password for the new user
297 :param force_password_change_at_next_login_req: Force password change
298 :param useusernameascn: Use username as cn rather that firstname +
300 :param userou: Object container (without domainDN postfix) for new user
301 :param surname: Surname of the new user
302 :param givenname: First name of the new user
303 :param initials: Initials of the new user
304 :param profilepath: Profile path of the new user
305 :param scriptpath: Logon script path of the new user
306 :param homedrive: Home drive of the new user
307 :param homedirectory: Home directory of the new user
308 :param jobtitle: Job title of the new user
309 :param department: Department of the new user
310 :param company: Company of the new user
311 :param description: of the new user
312 :param mailaddress: Email address of the new user
313 :param internetaddress: Home page of the new user
314 :param telephonenumber: Phone number of the new user
315 :param physicaldeliveryoffice: Office location of the new user
316 :param sd: security descriptor of the object
317 :param setpassword: optionally disable password reset
321 if givenname
is not None:
322 displayname
+= givenname
324 if initials
is not None:
325 displayname
+= ' %s.' % initials
327 if surname
is not None:
328 displayname
+= ' %s' % surname
331 if useusernameascn
is None and displayname
is not "":
334 user_dn
= "CN=%s,%s,%s" % (cn
, (userou
or "CN=Users"), self
.domain_dn())
336 dnsdomain
= ldb
.Dn(self
, self
.domain_dn()).canonical_str().replace("/", "")
337 user_principal_name
= "%s@%s" % (username
, dnsdomain
)
338 # The new user record. Note the reliance on the SAMLDB module which
339 # fills in the default informations
340 ldbmessage
= {"dn": user_dn
,
341 "sAMAccountName": username
,
342 "userPrincipalName": user_principal_name
,
343 "objectClass": "user"}
345 if surname
is not None:
346 ldbmessage
["sn"] = surname
348 if givenname
is not None:
349 ldbmessage
["givenName"] = givenname
351 if displayname
is not "":
352 ldbmessage
["displayName"] = displayname
353 ldbmessage
["name"] = displayname
355 if initials
is not None:
356 ldbmessage
["initials"] = '%s.' % initials
358 if profilepath
is not None:
359 ldbmessage
["profilePath"] = profilepath
361 if scriptpath
is not None:
362 ldbmessage
["scriptPath"] = scriptpath
364 if homedrive
is not None:
365 ldbmessage
["homeDrive"] = homedrive
367 if homedirectory
is not None:
368 ldbmessage
["homeDirectory"] = homedirectory
370 if jobtitle
is not None:
371 ldbmessage
["title"] = jobtitle
373 if department
is not None:
374 ldbmessage
["department"] = department
376 if company
is not None:
377 ldbmessage
["company"] = company
379 if description
is not None:
380 ldbmessage
["description"] = description
382 if mailaddress
is not None:
383 ldbmessage
["mail"] = mailaddress
385 if internetaddress
is not None:
386 ldbmessage
["wWWHomePage"] = internetaddress
388 if telephonenumber
is not None:
389 ldbmessage
["telephoneNumber"] = telephonenumber
391 if physicaldeliveryoffice
is not None:
392 ldbmessage
["physicalDeliveryOfficeName"] = physicaldeliveryoffice
395 ldbmessage
["nTSecurityDescriptor"] = ndr_pack(sd
)
397 self
.transaction_start()
401 # Sets the password for it
403 self
.setpassword("(samAccountName=%s)" % ldb
.binary_encode(username
), password
,
404 force_password_change_at_next_login_req
)
406 self
.transaction_cancel()
409 self
.transaction_commit()
412 def deleteuser(self
, username
):
415 :param username: Name of the target user
418 filter = "(&(sAMAccountName=%s)(objectCategory=%s,%s))" % (ldb
.binary_encode(username
), "CN=Person,CN=Schema,CN=Configuration", self
.domain_dn())
419 self
.transaction_start()
421 target
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
422 expression
=filter, attrs
=[])
424 raise Exception('Unable to find user "%s"' % username
)
425 assert(len(target
) == 1)
426 self
.delete(target
[0].dn
)
428 self
.transaction_cancel()
431 self
.transaction_commit()
434 def setpassword(self
, search_filter
, password
,
435 force_change_at_next_login
=False, username
=None):
436 """Sets the password for a user
438 :param search_filter: LDAP filter to find the user (eg
440 :param password: Password for the user
441 :param force_change_at_next_login: Force password change
443 self
.transaction_start()
445 res
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
446 expression
=search_filter
, attrs
=[])
448 raise Exception('Unable to find user "%s"' % (username
or search_filter
))
450 raise Exception('Matched %u multiple users with filter "%s"' % (len(res
), search_filter
))
457 """ % (user_dn
, base64
.b64encode(("\"" + password
+ "\"").encode('utf-16-le')))
459 self
.modify_ldif(setpw
)
461 if force_change_at_next_login
:
462 self
.force_password_change_at_next_login(
463 "(dn=" + str(user_dn
) + ")")
465 # modify the userAccountControl to remove the disabled bit
466 self
.enable_account(search_filter
)
468 self
.transaction_cancel()
471 self
.transaction_commit()
473 def setexpiry(self
, search_filter
, expiry_seconds
, no_expiry_req
=False):
474 """Sets the account expiry for a user
476 :param search_filter: LDAP filter to find the user (eg
478 :param expiry_seconds: expiry time from now in seconds
479 :param no_expiry_req: if set, then don't expire password
481 self
.transaction_start()
483 res
= self
.search(base
=self
.domain_dn(), scope
=ldb
.SCOPE_SUBTREE
,
484 expression
=search_filter
,
485 attrs
=["userAccountControl", "accountExpires"])
487 raise Exception('Unable to find user "%s"' % search_filter
)
488 assert(len(res
) == 1)
491 userAccountControl
= int(res
[0]["userAccountControl"][0])
492 accountExpires
= int(res
[0]["accountExpires"][0])
494 userAccountControl
= userAccountControl |
0x10000
497 userAccountControl
= userAccountControl
& ~
0x10000
498 accountExpires
= samba
.unix2nttime(expiry_seconds
+ int(time
.time()))
503 replace: userAccountControl
504 userAccountControl: %u
505 replace: accountExpires
507 """ % (user_dn
, userAccountControl
, accountExpires
)
509 self
.modify_ldif(setexp
)
511 self
.transaction_cancel()
514 self
.transaction_commit()
516 def set_domain_sid(self
, sid
):
517 """Change the domain SID used by this LDB.
519 :param sid: The new domain sid to use.
521 dsdb
._samdb
_set
_domain
_sid
(self
, sid
)
523 def get_domain_sid(self
):
524 """Read the domain SID used by this LDB. """
525 return dsdb
._samdb
_get
_domain
_sid
(self
)
527 domain_sid
= property(get_domain_sid
, set_domain_sid
,
528 "SID for the domain")
530 def set_invocation_id(self
, invocation_id
):
531 """Set the invocation id for this SamDB handle.
533 :param invocation_id: GUID of the invocation id.
535 dsdb
._dsdb
_set
_ntds
_invocation
_id
(self
, invocation_id
)
537 def get_invocation_id(self
):
538 """Get the invocation_id id"""
539 return dsdb
._samdb
_ntds
_invocation
_id
(self
)
541 invocation_id
= property(get_invocation_id
, set_invocation_id
,
542 "Invocation ID GUID")
544 def get_oid_from_attid(self
, attid
):
545 return dsdb
._dsdb
_get
_oid
_from
_attid
(self
, attid
)
547 def get_attid_from_lDAPDisplayName(self
, ldap_display_name
,
549 '''return the attribute ID for a LDAP attribute as an integer as found in DRSUAPI'''
550 return dsdb
._dsdb
_get
_attid
_from
_lDAPDisplayName
(self
,
551 ldap_display_name
, is_schema_nc
)
553 def get_syntax_oid_from_lDAPDisplayName(self
, ldap_display_name
):
554 '''return the syntax OID for a LDAP attribute as a string'''
555 return dsdb
._dsdb
_get
_syntax
_oid
_from
_lDAPDisplayName
(self
, ldap_display_name
)
557 def get_systemFlags_from_lDAPDisplayName(self
, ldap_display_name
):
558 '''return the systemFlags for a LDAP attribute as a integer'''
559 return dsdb
._dsdb
_get
_systemFlags
_from
_lDAPDisplayName
(self
, ldap_display_name
)
561 def get_linkId_from_lDAPDisplayName(self
, ldap_display_name
):
562 '''return the linkID for a LDAP attribute as a integer'''
563 return dsdb
._dsdb
_get
_linkId
_from
_lDAPDisplayName
(self
, ldap_display_name
)
565 def get_lDAPDisplayName_by_attid(self
, attid
):
566 '''return the lDAPDisplayName from an integer DRS attribute ID'''
567 return dsdb
._dsdb
_get
_lDAPDisplayName
_by
_attid
(self
, attid
)
569 def get_backlink_from_lDAPDisplayName(self
, ldap_display_name
):
570 '''return the attribute name of the corresponding backlink from the name
571 of a forward link attribute. If there is no backlink return None'''
572 return dsdb
._dsdb
_get
_backlink
_from
_lDAPDisplayName
(self
, ldap_display_name
)
574 def set_ntds_settings_dn(self
, ntds_settings_dn
):
575 """Set the NTDS Settings DN, as would be returned on the dsServiceName
578 This allows the DN to be set before the database fully exists
580 :param ntds_settings_dn: The new DN to use
582 dsdb
._samdb
_set
_ntds
_settings
_dn
(self
, ntds_settings_dn
)
584 def get_ntds_GUID(self
):
585 """Get the NTDS objectGUID"""
586 return dsdb
._samdb
_ntds
_objectGUID
(self
)
588 def server_site_name(self
):
589 """Get the server site name"""
590 return dsdb
._samdb
_server
_site
_name
(self
)
592 def host_dns_name(self
):
593 """return the DNS name of this host"""
594 res
= self
.search(base
='', scope
=ldb
.SCOPE_BASE
, attrs
=['dNSHostName'])
595 return res
[0]['dNSHostName'][0]
597 def domain_dns_name(self
):
598 """return the DNS name of the domain root"""
599 domain_dn
= self
.get_default_basedn()
600 return domain_dn
.canonical_str().split('/')[0]
602 def forest_dns_name(self
):
603 """return the DNS name of the forest root"""
604 forest_dn
= self
.get_root_basedn()
605 return forest_dn
.canonical_str().split('/')[0]
607 def load_partition_usn(self
, base_dn
):
608 return dsdb
._dsdb
_load
_partition
_usn
(self
, base_dn
)
610 def set_schema(self
, schema
):
611 self
.set_schema_from_ldb(schema
.ldb
)
613 def set_schema_from_ldb(self
, ldb_conn
):
614 dsdb
._dsdb
_set
_schema
_from
_ldb
(self
, ldb_conn
)
616 def dsdb_DsReplicaAttribute(self
, ldb
, ldap_display_name
, ldif_elements
):
617 '''convert a list of attribute values to a DRSUAPI DsReplicaAttribute'''
618 return dsdb
._dsdb
_DsReplicaAttribute
(ldb
, ldap_display_name
, ldif_elements
)
620 def dsdb_normalise_attributes(self
, ldb
, ldap_display_name
, ldif_elements
):
621 '''normalise a list of attribute values'''
622 return dsdb
._dsdb
_normalise
_attributes
(ldb
, ldap_display_name
, ldif_elements
)
624 def get_attribute_from_attid(self
, attid
):
625 """ Get from an attid the associated attribute
627 :param attid: The attribute id for searched attribute
628 :return: The name of the attribute associated with this id
630 if len(self
.hash_oid_name
.keys()) == 0:
631 self
._populate
_oid
_attid
()
632 if self
.hash_oid_name
.has_key(self
.get_oid_from_attid(attid
)):
633 return self
.hash_oid_name
[self
.get_oid_from_attid(attid
)]
637 def _populate_oid_attid(self
):
638 """Populate the hash hash_oid_name.
640 This hash contains the oid of the attribute as a key and
641 its display name as a value
643 self
.hash_oid_name
= {}
644 res
= self
.search(expression
="objectClass=attributeSchema",
645 controls
=["search_options:1:2"],
646 attrs
=["attributeID",
650 strDisplay
= str(e
.get("lDAPDisplayName"))
651 self
.hash_oid_name
[str(e
.get("attributeID"))] = strDisplay
653 def get_attribute_replmetadata_version(self
, dn
, att
):
654 """Get the version field trom the replPropertyMetaData for
657 :param dn: The on which we want to get the version
658 :param att: The name of the attribute
659 :return: The value of the version field in the replPropertyMetaData
660 for the given attribute. None if the attribute is not replicated
663 res
= self
.search(expression
="dn=%s" % dn
,
664 scope
=ldb
.SCOPE_SUBTREE
,
665 controls
=["search_options:1:2"],
666 attrs
=["replPropertyMetaData"])
670 repl
= ndr_unpack(drsblobs
.replPropertyMetaDataBlob
,
671 str(res
[0]["replPropertyMetaData"]))
673 if len(self
.hash_oid_name
.keys()) == 0:
674 self
._populate
_oid
_attid
()
676 # Search for Description
677 att_oid
= self
.get_oid_from_attid(o
.attid
)
678 if self
.hash_oid_name
.has_key(att_oid
) and\
679 att
.lower() == self
.hash_oid_name
[att_oid
].lower():
683 def set_attribute_replmetadata_version(self
, dn
, att
, value
,
684 addifnotexist
=False):
685 res
= self
.search(expression
="dn=%s" % dn
,
686 scope
=ldb
.SCOPE_SUBTREE
,
687 controls
=["search_options:1:2"],
688 attrs
=["replPropertyMetaData"])
692 repl
= ndr_unpack(drsblobs
.replPropertyMetaDataBlob
,
693 str(res
[0]["replPropertyMetaData"]))
695 now
= samba
.unix2nttime(int(time
.time()))
697 if len(self
.hash_oid_name
.keys()) == 0:
698 self
._populate
_oid
_attid
()
700 # Search for Description
701 att_oid
= self
.get_oid_from_attid(o
.attid
)
702 if self
.hash_oid_name
.has_key(att_oid
) and\
703 att
.lower() == self
.hash_oid_name
[att_oid
].lower():
705 seq
= self
.sequence_number(ldb
.SEQ_NEXT
)
707 o
.originating_change_time
= now
708 o
.originating_invocation_id
= misc
.GUID(self
.get_invocation_id())
709 o
.originating_usn
= seq
712 if not found
and addifnotexist
and len(ctr
.array
) >0:
713 o2
= drsblobs
.replPropertyMetaData1()
715 att_oid
= self
.get_oid_from_attid(o2
.attid
)
716 seq
= self
.sequence_number(ldb
.SEQ_NEXT
)
718 o2
.originating_change_time
= now
719 o2
.originating_invocation_id
= misc
.GUID(self
.get_invocation_id())
720 o2
.originating_usn
= seq
725 ctr
.count
= ctr
.count
+ 1
729 replBlob
= ndr_pack(repl
)
732 msg
["replPropertyMetaData"] = ldb
.MessageElement(replBlob
,
733 ldb
.FLAG_MOD_REPLACE
,
734 "replPropertyMetaData")
735 self
.modify(msg
, ["local_oid:1.3.6.1.4.1.7165.4.3.14:0"])
737 def write_prefixes_from_schema(self
):
738 dsdb
._dsdb
_write
_prefixes
_from
_schema
_to
_ldb
(self
)
740 def get_partitions_dn(self
):
741 return dsdb
._dsdb
_get
_partitions
_dn
(self
)
743 def set_minPwdAge(self
, value
):
745 m
.dn
= ldb
.Dn(self
, self
.domain_dn())
746 m
["minPwdAge"] = ldb
.MessageElement(value
, ldb
.FLAG_MOD_REPLACE
, "minPwdAge")
749 def get_minPwdAge(self
):
750 res
= self
.search(self
.domain_dn(), scope
=ldb
.SCOPE_BASE
, attrs
=["minPwdAge"])
753 elif not "minPwdAge" in res
[0]:
756 return res
[0]["minPwdAge"][0]
758 def set_minPwdLength(self
, value
):
760 m
.dn
= ldb
.Dn(self
, self
.domain_dn())
761 m
["minPwdLength"] = ldb
.MessageElement(value
, ldb
.FLAG_MOD_REPLACE
, "minPwdLength")
764 def get_minPwdLength(self
):
765 res
= self
.search(self
.domain_dn(), scope
=ldb
.SCOPE_BASE
, attrs
=["minPwdLength"])
768 elif not "minPwdLength" in res
[0]:
771 return res
[0]["minPwdLength"][0]
773 def set_pwdProperties(self
, value
):
775 m
.dn
= ldb
.Dn(self
, self
.domain_dn())
776 m
["pwdProperties"] = ldb
.MessageElement(value
, ldb
.FLAG_MOD_REPLACE
, "pwdProperties")
779 def get_pwdProperties(self
):
780 res
= self
.search(self
.domain_dn(), scope
=ldb
.SCOPE_BASE
, attrs
=["pwdProperties"])
783 elif not "pwdProperties" in res
[0]:
786 return res
[0]["pwdProperties"][0]
788 def set_dsheuristics(self
, dsheuristics
):
790 m
.dn
= ldb
.Dn(self
, "CN=Directory Service,CN=Windows NT,CN=Services,%s"
791 % self
.get_config_basedn().get_linearized())
792 if dsheuristics
is not None:
793 m
["dSHeuristics"] = ldb
.MessageElement(dsheuristics
,
794 ldb
.FLAG_MOD_REPLACE
, "dSHeuristics")
796 m
["dSHeuristics"] = ldb
.MessageElement([], ldb
.FLAG_MOD_DELETE
,
800 def get_dsheuristics(self
):
801 res
= self
.search("CN=Directory Service,CN=Windows NT,CN=Services,%s"
802 % self
.get_config_basedn().get_linearized(),
803 scope
=ldb
.SCOPE_BASE
, attrs
=["dSHeuristics"])
806 elif "dSHeuristics" in res
[0]:
807 dsheuristics
= res
[0]["dSHeuristics"][0]
813 def create_ou(self
, ou_dn
, description
=None, name
=None, sd
=None):
814 """Creates an organizationalUnit object
815 :param ou_dn: dn of the new object
816 :param description: description attribute
817 :param name: name atttribute
818 :param sd: security descriptor of the object, can be
819 an SDDL string or security.descriptor type
822 "objectClass": "organizationalUnit"}
825 m
["description"] = description
830 m
["nTSecurityDescriptor"] = ndr_pack(sd
)
833 def sequence_number(self
, seq_type
):
834 """Returns the value of the sequence number according to the requested type
835 :param seq_type: type of sequence number
837 self
.transaction_start()
839 seq
= super(SamDB
, self
).sequence_number(seq_type
)
841 self
.transaction_cancel()
844 self
.transaction_commit()