2 Unix SMB/CIFS implementation.
4 interface functions for the sam database
6 Copyright (C) Andrew Tridgell 2004
7 Copyright (C) Volker Lendecke 2004
8 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2006
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 2 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 #include "librpc/gen_ndr/ndr_netlogon.h"
27 #include "librpc/gen_ndr/ndr_misc.h"
28 #include "librpc/gen_ndr/ndr_security.h"
29 #include "lib/ldb/include/ldb.h"
30 #include "lib/ldb/include/ldb_errors.h"
31 #include "libcli/security/security.h"
32 #include "auth/credentials/credentials.h"
33 #include "libcli/auth/proto.h"
34 #include "libcli/ldap/ldap.h"
35 #include "system/time.h"
36 #include "system/filesys.h"
38 #include "dsdb/samdb/samdb.h"
39 #include "dsdb/common/flags.h"
42 connect to the SAM database
43 return an opaque context pointer on success, or NULL on failure
45 struct ldb_context *samdb_connect(TALLOC_CTX *mem_ctx,
46 struct auth_session_info *session_info)
48 struct ldb_context *ldb;
49 ldb = ldb_wrap_connect(mem_ctx, lp_sam_url(), session_info,
58 search the sam for the specified attributes in a specific domain, filter on
59 objectSid being in domain_sid.
61 int samdb_search_domain(struct ldb_context *sam_ldb,
63 const struct ldb_dn *basedn,
64 struct ldb_message ***res,
65 const char * const *attrs,
66 const struct dom_sid *domain_sid,
67 const char *format, ...) _PRINTF_ATTRIBUTE(7,8)
73 count = gendb_search_v(sam_ldb, mem_ctx, basedn,
74 res, attrs, format, ap);
80 struct dom_sid *entry_sid;
82 entry_sid = samdb_result_dom_sid(mem_ctx, (*res)[i], "objectSid");
84 if ((entry_sid == NULL) ||
85 (!dom_sid_in_domain(domain_sid, entry_sid))) {
86 /* Delete that entry from the result set */
87 (*res)[i] = (*res)[count-1];
89 talloc_free(entry_sid);
92 talloc_free(entry_sid);
100 search the sam for a single string attribute in exactly 1 record
102 const char *samdb_search_string_v(struct ldb_context *sam_ldb,
104 const struct ldb_dn *basedn,
105 const char *attr_name,
106 const char *format, va_list ap) _PRINTF_ATTRIBUTE(5,0)
109 const char *attrs[2] = { NULL, NULL };
110 struct ldb_message **res = NULL;
112 attrs[0] = attr_name;
114 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
116 DEBUG(1,("samdb: search for %s %s not single valued (count=%d)\n",
117 attr_name, format, count));
124 return samdb_result_string(res[0], attr_name, NULL);
129 search the sam for a single string attribute in exactly 1 record
131 const char *samdb_search_string(struct ldb_context *sam_ldb,
133 const struct ldb_dn *basedn,
134 const char *attr_name,
135 const char *format, ...) _PRINTF_ATTRIBUTE(5,6)
140 va_start(ap, format);
141 str = samdb_search_string_v(sam_ldb, mem_ctx, basedn, attr_name, format, ap);
147 struct ldb_dn *samdb_search_dn(struct ldb_context *sam_ldb,
149 const struct ldb_dn *basedn,
150 const char *format, ...) _PRINTF_ATTRIBUTE(4,5)
154 struct ldb_message **res = NULL;
157 va_start(ap, format);
158 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, NULL, format, ap);
161 if (count != 1) return NULL;
163 ret = talloc_steal(mem_ctx, res[0]->dn);
170 search the sam for a dom_sid attribute in exactly 1 record
172 struct dom_sid *samdb_search_dom_sid(struct ldb_context *sam_ldb,
174 const struct ldb_dn *basedn,
175 const char *attr_name,
176 const char *format, ...) _PRINTF_ATTRIBUTE(5,6)
180 struct ldb_message **res;
181 const char *attrs[2] = { NULL, NULL };
184 attrs[0] = attr_name;
186 va_start(ap, format);
187 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
190 DEBUG(1,("samdb: search for %s %s not single valued (count=%d)\n",
191 attr_name, format, count));
197 sid = samdb_result_dom_sid(mem_ctx, res[0], attr_name);
203 return the count of the number of records in the sam matching the query
205 int samdb_search_count(struct ldb_context *sam_ldb,
207 const struct ldb_dn *basedn,
208 const char *format, ...) _PRINTF_ATTRIBUTE(4,5)
211 struct ldb_message **res;
212 const char * const attrs[] = { NULL };
215 va_start(ap, format);
216 ret = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
224 search the sam for a single integer attribute in exactly 1 record
226 uint_t samdb_search_uint(struct ldb_context *sam_ldb,
228 uint_t default_value,
229 const struct ldb_dn *basedn,
230 const char *attr_name,
231 const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
235 struct ldb_message **res;
236 const char *attrs[2] = { NULL, NULL };
238 attrs[0] = attr_name;
240 va_start(ap, format);
241 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
245 return default_value;
248 return samdb_result_uint(res[0], attr_name, default_value);
252 search the sam for a single signed 64 bit integer attribute in exactly 1 record
254 int64_t samdb_search_int64(struct ldb_context *sam_ldb,
256 int64_t default_value,
257 const struct ldb_dn *basedn,
258 const char *attr_name,
259 const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
263 struct ldb_message **res;
264 const char *attrs[2] = { NULL, NULL };
266 attrs[0] = attr_name;
268 va_start(ap, format);
269 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
273 return default_value;
276 return samdb_result_int64(res[0], attr_name, default_value);
280 search the sam for multipe records each giving a single string attribute
281 return the number of matches, or -1 on error
283 int samdb_search_string_multiple(struct ldb_context *sam_ldb,
285 const struct ldb_dn *basedn,
287 const char *attr_name,
288 const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
292 const char *attrs[2] = { NULL, NULL };
293 struct ldb_message **res = NULL;
295 attrs[0] = attr_name;
297 va_start(ap, format);
298 count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
305 /* make sure its single valued */
306 for (i=0;i<count;i++) {
307 if (res[i]->num_elements != 1) {
308 DEBUG(1,("samdb: search for %s %s not single valued\n",
315 *strs = talloc_array(mem_ctx, const char *, count+1);
321 for (i=0;i<count;i++) {
322 (*strs)[i] = samdb_result_string(res[i], attr_name, NULL);
324 (*strs)[count] = NULL;
330 pull a uint from a result set.
332 uint_t samdb_result_uint(const struct ldb_message *msg, const char *attr, uint_t default_value)
334 return ldb_msg_find_attr_as_uint(msg, attr, default_value);
338 pull a (signed) int64 from a result set.
340 int64_t samdb_result_int64(const struct ldb_message *msg, const char *attr, int64_t default_value)
342 return ldb_msg_find_attr_as_int64(msg, attr, default_value);
346 pull a string from a result set.
348 const char *samdb_result_string(const struct ldb_message *msg, const char *attr,
349 const char *default_value)
351 return ldb_msg_find_attr_as_string(msg, attr, default_value);
354 struct ldb_dn *samdb_result_dn(TALLOC_CTX *mem_ctx, const struct ldb_message *msg,
355 const char *attr, struct ldb_dn *default_value)
357 const char *string = samdb_result_string(msg, attr, NULL);
358 if (string == NULL) return default_value;
359 return ldb_dn_explode(mem_ctx, string);
363 pull a rid from a objectSid in a result set.
365 uint32_t samdb_result_rid_from_sid(TALLOC_CTX *mem_ctx, const struct ldb_message *msg,
366 const char *attr, uint32_t default_value)
371 sid = samdb_result_dom_sid(mem_ctx, msg, attr);
373 return default_value;
375 rid = sid->sub_auths[sid->num_auths-1];
381 pull a dom_sid structure from a objectSid in a result set.
383 struct dom_sid *samdb_result_dom_sid(TALLOC_CTX *mem_ctx, const struct ldb_message *msg,
386 const struct ldb_val *v;
389 v = ldb_msg_find_ldb_val(msg, attr);
393 sid = talloc(mem_ctx, struct dom_sid);
397 status = ndr_pull_struct_blob(v, sid, sid,
398 (ndr_pull_flags_fn_t)ndr_pull_dom_sid);
399 if (!NT_STATUS_IS_OK(status)) {
407 pull a guid structure from a objectGUID in a result set.
409 struct GUID samdb_result_guid(const struct ldb_message *msg, const char *attr)
411 const struct ldb_val *v;
418 v = ldb_msg_find_ldb_val(msg, attr);
421 mem_ctx = talloc_named_const(NULL, 0, "samdb_result_guid");
422 if (!mem_ctx) return guid;
423 status = ndr_pull_struct_blob(v, mem_ctx, &guid,
424 (ndr_pull_flags_fn_t)ndr_pull_GUID);
425 talloc_free(mem_ctx);
426 if (!NT_STATUS_IS_OK(status)) {
434 pull a sid prefix from a objectSid in a result set.
435 this is used to find the domain sid for a user
437 struct dom_sid *samdb_result_sid_prefix(TALLOC_CTX *mem_ctx, const struct ldb_message *msg,
440 struct dom_sid *sid = samdb_result_dom_sid(mem_ctx, msg, attr);
441 if (!sid || sid->num_auths < 1) return NULL;
447 pull a NTTIME in a result set.
449 NTTIME samdb_result_nttime(struct ldb_message *msg, const char *attr, NTTIME default_value)
451 const char *str = ldb_msg_find_attr_as_string(msg, attr, NULL);
452 if (!str) return default_value;
453 return nttime_from_string(str);
457 pull a uint64_t from a result set.
459 uint64_t samdb_result_uint64(struct ldb_message *msg, const char *attr, uint64_t default_value)
461 return ldb_msg_find_attr_as_uint64(msg, attr, default_value);
466 construct the allow_password_change field from the PwdLastSet attribute and the
467 domain password settings
469 NTTIME samdb_result_allow_password_change(struct ldb_context *sam_ldb,
471 const struct ldb_dn *domain_dn,
472 struct ldb_message *msg,
475 uint64_t attr_time = samdb_result_uint64(msg, attr, 0);
478 if (attr_time == 0) {
482 minPwdAge = samdb_search_int64(sam_ldb, mem_ctx, 0, domain_dn, "minPwdAge", NULL);
484 /* yes, this is a -= not a += as minPwdAge is stored as the negative
485 of the number of 100-nano-seconds */
486 attr_time -= minPwdAge;
492 construct the force_password_change field from the PwdLastSet attribute and the
493 domain password settings
495 NTTIME samdb_result_force_password_change(struct ldb_context *sam_ldb,
497 const struct ldb_dn *domain_dn,
498 struct ldb_message *msg)
500 uint64_t attr_time = samdb_result_uint64(msg, "pwdLastSet", 0);
501 uint32_t user_flags = samdb_result_uint64(msg, "userAccountControl", 0);
504 if (user_flags & UF_DONT_EXPIRE_PASSWD) {
505 return 0x7FFFFFFFFFFFFFFFULL;
508 if (attr_time == 0) {
512 maxPwdAge = samdb_search_int64(sam_ldb, mem_ctx, 0, domain_dn, "maxPwdAge", NULL);
513 if (maxPwdAge == 0) {
516 attr_time -= maxPwdAge;
523 pull a samr_Password structutre from a result set.
525 struct samr_Password *samdb_result_hash(TALLOC_CTX *mem_ctx, struct ldb_message *msg, const char *attr)
527 struct samr_Password *hash = NULL;
528 const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
529 if (val && (val->length >= sizeof(hash->hash))) {
530 hash = talloc(mem_ctx, struct samr_Password);
531 memcpy(hash->hash, val->data, MIN(val->length, sizeof(hash->hash)));
537 pull an array of samr_Password structutres from a result set.
539 uint_t samdb_result_hashes(TALLOC_CTX *mem_ctx, struct ldb_message *msg,
540 const char *attr, struct samr_Password **hashes)
543 const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
550 count = val->length / 16;
555 *hashes = talloc_array(mem_ctx, struct samr_Password, count);
560 for (i=0;i<count;i++) {
561 memcpy((*hashes)[i].hash, (i*16)+(char *)val->data, 16);
567 NTSTATUS samdb_result_passwords(TALLOC_CTX *mem_ctx, struct ldb_message *msg,
568 struct samr_Password **lm_pwd, struct samr_Password **nt_pwd)
570 struct samr_Password *lmPwdHash, *ntPwdHash;
573 num_nt = samdb_result_hashes(mem_ctx, msg, "ntPwdHash", &ntPwdHash);
576 } else if (num_nt > 1) {
577 return NT_STATUS_INTERNAL_DB_CORRUPTION;
579 *nt_pwd = &ntPwdHash[0];
584 num_lm = samdb_result_hashes(mem_ctx, msg, "lmPwdHash", &lmPwdHash);
587 } else if (num_lm > 1) {
588 return NT_STATUS_INTERNAL_DB_CORRUPTION;
590 *lm_pwd = &lmPwdHash[0];
597 pull a samr_LogonHours structutre from a result set.
599 struct samr_LogonHours samdb_result_logon_hours(TALLOC_CTX *mem_ctx, struct ldb_message *msg, const char *attr)
601 struct samr_LogonHours hours;
602 const int units_per_week = 168;
603 const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
605 hours.bits = talloc_array(mem_ctx, uint8_t, units_per_week);
609 hours.units_per_week = units_per_week;
610 memset(hours.bits, 0xFF, units_per_week);
612 memcpy(hours.bits, val->data, MIN(val->length, units_per_week));
618 pull a set of account_flags from a result set.
620 uint16_t samdb_result_acct_flags(struct ldb_message *msg, const char *attr)
622 uint_t userAccountControl = ldb_msg_find_attr_as_uint(msg, attr, 0);
623 return samdb_uf2acb(userAccountControl);
627 /* Find an attribute, with a particular value */
628 struct ldb_message_element *samdb_find_attribute(struct ldb_context *ldb,
629 const struct ldb_message *msg,
630 const char *name, const char *value)
633 struct ldb_message_element *el = ldb_msg_find_element(msg, name);
636 v.data = discard_const_p(uint8_t, value);
637 v.length = strlen(value);
643 for (i=0;i<el->num_values;i++) {
644 if (strcasecmp(value, (char *)el->values[i].data) == 0) {
652 int samdb_find_or_add_value(struct ldb_context *ldb, struct ldb_message *msg, const char *name, const char *set_value)
654 if (samdb_find_attribute(ldb, msg, name, set_value) == NULL) {
655 return samdb_msg_add_string(ldb, msg, msg, name, set_value);
660 int samdb_find_or_add_attribute(struct ldb_context *ldb, struct ldb_message *msg, const char *name, const char *set_value)
662 struct ldb_message_element *el;
664 el = ldb_msg_find_element(msg, name);
669 return samdb_msg_add_string(ldb, msg, msg, name, set_value);
674 copy from a template record to a message
676 int samdb_copy_template(struct ldb_context *ldb,
677 struct ldb_message *msg, const char *filter,
678 const char **errstring)
680 struct ldb_result *res;
681 struct ldb_message *t;
683 struct ldb_dn *basedn = ldb_dn_explode(ldb, "cn=Templates");
687 /* pull the template record */
688 ret = ldb_search(ldb, basedn, LDB_SCOPE_SUBTREE, filter, NULL, &res);
690 if (ret != LDB_SUCCESS) {
691 *errstring = talloc_steal(msg, ldb_errstring(ldb));
694 if (res->count != 1) {
695 *errstring = talloc_asprintf(msg, "samdb_copy_template: ERROR: template '%s' matched %d records, expected 1\n", filter,
698 return LDB_ERR_OPERATIONS_ERROR;
702 for (i = 0; i < t->num_elements; i++) {
703 struct ldb_message_element *el = &t->elements[i];
704 /* some elements should not be copied from the template */
705 if (strcasecmp(el->name, "cn") == 0 ||
706 strcasecmp(el->name, "name") == 0 ||
707 strcasecmp(el->name, "sAMAccountName") == 0 ||
708 strcasecmp(el->name, "sAMAccountName") == 0 ||
709 strcasecmp(el->name, "distinguishedName") == 0 ||
710 strcasecmp(el->name, "objectGUID") == 0) {
713 for (j = 0; j < el->num_values; j++) {
714 if (strcasecmp(el->name, "objectClass") == 0) {
715 if (strcasecmp((char *)el->values[j].data, "Template") == 0 ||
716 strcasecmp((char *)el->values[j].data, "userTemplate") == 0 ||
717 strcasecmp((char *)el->values[j].data, "groupTemplate") == 0 ||
718 strcasecmp((char *)el->values[j].data, "foreignSecurityPrincipalTemplate") == 0 ||
719 strcasecmp((char *)el->values[j].data, "aliasTemplate") == 0 ||
720 strcasecmp((char *)el->values[j].data, "trustedDomainTemplate") == 0 ||
721 strcasecmp((char *)el->values[j].data, "secretTemplate") == 0) {
724 ret = samdb_find_or_add_value(ldb, msg, el->name,
725 (char *)el->values[j].data);
727 *errstring = talloc_asprintf(msg, "Adding objectClass %s failed.\n", el->values[j].data);
732 ret = samdb_find_or_add_attribute(ldb, msg, el->name,
733 (char *)el->values[j].data);
735 *errstring = talloc_asprintf(msg, "Adding attribute %s failed.\n", el->name);
750 add a string element to a message
752 int samdb_msg_add_string(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
753 const char *attr_name, const char *str)
755 char *s = talloc_strdup(mem_ctx, str);
756 char *a = talloc_strdup(mem_ctx, attr_name);
757 if (s == NULL || a == NULL) {
758 return LDB_ERR_OPERATIONS_ERROR;
760 return ldb_msg_add_string(msg, a, s);
764 add a dom_sid element to a message
766 int samdb_msg_add_dom_sid(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
767 const char *attr_name, struct dom_sid *sid)
771 status = ndr_push_struct_blob(&v, mem_ctx, sid,
772 (ndr_push_flags_fn_t)ndr_push_dom_sid);
773 if (!NT_STATUS_IS_OK(status)) {
776 return ldb_msg_add_value(msg, attr_name, &v);
781 add a delete element operation to a message
783 int samdb_msg_add_delete(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
784 const char *attr_name)
786 /* we use an empty replace rather than a delete, as it allows for
787 samdb_replace() to be used everywhere */
788 return ldb_msg_add_empty(msg, attr_name, LDB_FLAG_MOD_REPLACE);
792 add a add attribute value to a message
794 int samdb_msg_add_addval(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
795 const char *attr_name, const char *value)
797 struct ldb_message_element *el;
800 a = talloc_strdup(mem_ctx, attr_name);
803 v = talloc_strdup(mem_ctx, value);
806 ret = ldb_msg_add_string(msg, a, v);
809 el = ldb_msg_find_element(msg, a);
812 el->flags = LDB_FLAG_MOD_ADD;
817 add a delete attribute value to a message
819 int samdb_msg_add_delval(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
820 const char *attr_name, const char *value)
822 struct ldb_message_element *el;
825 a = talloc_strdup(mem_ctx, attr_name);
828 v = talloc_strdup(mem_ctx, value);
831 ret = ldb_msg_add_string(msg, a, v);
834 el = ldb_msg_find_element(msg, a);
837 el->flags = LDB_FLAG_MOD_DELETE;
842 add a int element to a message
844 int samdb_msg_add_int(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
845 const char *attr_name, int v)
847 const char *s = talloc_asprintf(mem_ctx, "%d", v);
848 return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
852 add a uint_t element to a message
854 int samdb_msg_add_uint(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
855 const char *attr_name, uint_t v)
857 const char *s = talloc_asprintf(mem_ctx, "%u", v);
858 return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
862 add a (signed) int64_t element to a message
864 int samdb_msg_add_int64(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
865 const char *attr_name, int64_t v)
867 const char *s = talloc_asprintf(mem_ctx, "%lld", (long long)v);
868 return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
872 add a uint64_t element to a message
874 int samdb_msg_add_uint64(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
875 const char *attr_name, uint64_t v)
877 const char *s = talloc_asprintf(mem_ctx, "%llu", (unsigned long long)v);
878 return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
882 add a samr_Password element to a message
884 int samdb_msg_add_hash(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
885 const char *attr_name, struct samr_Password *hash)
888 val.data = talloc_memdup(mem_ctx, hash->hash, 16);
893 return ldb_msg_add_value(msg, attr_name, &val);
897 add a samr_Password array to a message
899 int samdb_msg_add_hashes(TALLOC_CTX *mem_ctx, struct ldb_message *msg,
900 const char *attr_name, struct samr_Password *hashes, uint_t count)
904 val.data = talloc_array_size(mem_ctx, 16, count);
905 val.length = count*16;
909 for (i=0;i<count;i++) {
910 memcpy(i*16 + (char *)val.data, hashes[i].hash, 16);
912 return ldb_msg_add_value(msg, attr_name, &val);
916 add a acct_flags element to a message
918 int samdb_msg_add_acct_flags(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
919 const char *attr_name, uint32_t v)
921 return samdb_msg_add_uint(sam_ldb, mem_ctx, msg, attr_name, samdb_acb2uf(v));
925 add a logon_hours element to a message
927 int samdb_msg_add_logon_hours(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
928 const char *attr_name, struct samr_LogonHours *hours)
931 val.length = hours->units_per_week / 8;
932 val.data = hours->bits;
933 return ldb_msg_add_value(msg, attr_name, &val);
937 add a general value element to a message
939 int samdb_msg_add_value(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
940 const char *attr_name, const struct ldb_val *val)
942 return ldb_msg_add_value(msg, attr_name, val);
946 sets a general value element to a message
948 int samdb_msg_set_value(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
949 const char *attr_name, const struct ldb_val *val)
951 struct ldb_message_element *el;
953 el = ldb_msg_find_element(msg, attr_name);
957 return ldb_msg_add_value(msg, attr_name, val);
961 set a string element in a message
963 int samdb_msg_set_string(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
964 const char *attr_name, const char *str)
966 struct ldb_message_element *el;
968 el = ldb_msg_find_element(msg, attr_name);
972 return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, str);
978 int samdb_add(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
980 return ldb_add(sam_ldb, msg);
986 int samdb_delete(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, const struct ldb_dn *dn)
988 return ldb_delete(sam_ldb, dn);
994 int samdb_modify(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
996 return ldb_modify(sam_ldb, msg);
1000 replace elements in a record
1002 int samdb_replace(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
1006 /* mark all the message elements as LDB_FLAG_MOD_REPLACE */
1007 for (i=0;i<msg->num_elements;i++) {
1008 msg->elements[i].flags = LDB_FLAG_MOD_REPLACE;
1011 /* modify the samdb record */
1012 return samdb_modify(sam_ldb, mem_ctx, msg);
1016 return a default security descriptor
1018 struct security_descriptor *samdb_default_security_descriptor(TALLOC_CTX *mem_ctx)
1020 struct security_descriptor *sd;
1022 sd = security_descriptor_initialise(mem_ctx);
1027 const struct ldb_dn *samdb_base_dn(struct ldb_context *sam_ctx)
1029 return ldb_get_default_basedn(sam_ctx);
1033 const struct ldb_dn *samdb_partitions_dn(struct ldb_context *sam_ctx,
1034 TALLOC_CTX *mem_ctx)
1036 return ldb_dn_string_compose(mem_ctx, samdb_base_dn(sam_ctx),
1037 "CN=Partitions,CN=Configuration");
1042 work out the domain sid for the current open ldb
1044 const struct dom_sid *samdb_domain_sid(struct ldb_context *ldb)
1046 const char *attrs[] = { "rootDomainNamingContext", NULL };
1048 struct ldb_result *res = NULL;
1049 TALLOC_CTX *tmp_ctx;
1050 struct dom_sid *domain_sid;
1051 const char *basedn_s;
1052 struct ldb_dn *basedn;
1054 /* see if we have a cached copy */
1055 domain_sid = ldb_get_opaque(ldb, "cache.domain_sid");
1060 tmp_ctx = talloc_new(ldb);
1061 if (tmp_ctx == NULL) {
1065 basedn = ldb_dn_explode(tmp_ctx, "");
1066 if (basedn == NULL) {
1070 /* find the basedn of the domain from the rootdse */
1071 ret = ldb_search(ldb, basedn, LDB_SCOPE_BASE, NULL, attrs, &res);
1072 talloc_steal(tmp_ctx, res);
1073 if (ret != LDB_SUCCESS || res->count != 1) {
1077 basedn_s = ldb_msg_find_attr_as_string(res->msgs[0], "rootDomainNamingContext", NULL);
1078 if (basedn_s == NULL) {
1082 basedn = ldb_dn_explode(tmp_ctx, basedn_s);
1083 if (basedn == NULL) {
1087 /* find the domain_sid */
1088 domain_sid = samdb_search_dom_sid(ldb, tmp_ctx, basedn,
1089 "objectSid", "objectClass=domainDNS");
1090 if (domain_sid == NULL) {
1094 /* cache the domain_sid in the ldb */
1095 if (ldb_set_opaque(ldb, "cache.domain_sid", domain_sid) != LDB_SUCCESS) {
1099 talloc_steal(ldb, domain_sid);
1100 talloc_free(tmp_ctx);
1105 DEBUG(1,("Failed to find domain_sid for open ldb\n"));
1106 talloc_free(tmp_ctx);
1111 check that a password is sufficiently complex
1113 static BOOL samdb_password_complexity_ok(const char *pass)
1115 return check_password_quality(pass);
1121 set the user password using plaintext, obeying any user or domain
1122 password restrictions
1124 note that this function doesn't actually store the result in the
1125 database, it just fills in the "mod" structure with ldb modify
1126 elements to setup the correct change when samdb_replace() is
1127 called. This allows the caller to combine the change with other
1128 changes (as is needed by some of the set user info levels)
1130 The caller should probably have a transaction wrapping this
1132 _PUBLIC_ NTSTATUS samdb_set_password(struct ldb_context *ctx, TALLOC_CTX *mem_ctx,
1133 const struct ldb_dn *user_dn,
1134 const struct ldb_dn *domain_dn,
1135 struct ldb_message *mod,
1136 const char *new_pass,
1137 struct samr_Password *lmNewHash,
1138 struct samr_Password *ntNewHash,
1141 enum samr_RejectReason *reject_reason,
1142 struct samr_DomInfo1 **_dominfo)
1144 const char * const user_attrs[] = { "userAccountControl", "sambaLMPwdHistory",
1145 "sambaNTPwdHistory",
1146 "lmPwdHash", "ntPwdHash",
1148 "pwdLastSet", NULL };
1149 const char * const domain_attrs[] = { "pwdProperties", "pwdHistoryLength",
1150 "maxPwdAge", "minPwdAge",
1151 "minPwdLength", NULL };
1154 uint_t minPwdLength, pwdProperties, pwdHistoryLength;
1155 uint_t userAccountControl;
1156 struct samr_Password *sambaLMPwdHistory, *sambaNTPwdHistory, *lmPwdHash, *ntPwdHash;
1157 struct samr_Password local_lmNewHash, local_ntNewHash;
1158 int sambaLMPwdHistory_len, sambaNTPwdHistory_len;
1159 struct dom_sid *domain_sid;
1160 struct ldb_message **res;
1162 time_t now = time(NULL);
1166 /* we need to know the time to compute password age */
1167 unix_to_nt_time(&now_nt, now);
1169 /* pull all the user parameters */
1170 count = gendb_search_dn(ctx, mem_ctx, user_dn, &res, user_attrs);
1172 return NT_STATUS_INTERNAL_DB_CORRUPTION;
1174 userAccountControl = samdb_result_uint(res[0], "userAccountControl", 0);
1175 sambaLMPwdHistory_len = samdb_result_hashes(mem_ctx, res[0],
1176 "sambaLMPwdHistory", &sambaLMPwdHistory);
1177 sambaNTPwdHistory_len = samdb_result_hashes(mem_ctx, res[0],
1178 "sambaNTPwdHistory", &sambaNTPwdHistory);
1179 lmPwdHash = samdb_result_hash(mem_ctx, res[0], "lmPwdHash");
1180 ntPwdHash = samdb_result_hash(mem_ctx, res[0], "ntPwdHash");
1181 pwdLastSet = samdb_result_uint64(res[0], "pwdLastSet", 0);
1184 /* pull the domain parameters */
1185 count = gendb_search_dn(ctx, mem_ctx, domain_dn, &res, domain_attrs);
1187 DEBUG(2, ("samdb_set_password: Domain DN %s is invalid, for user %s\n",
1188 ldb_dn_linearize(mem_ctx, domain_dn),
1189 ldb_dn_linearize(mem_ctx, user_dn)));
1190 return NT_STATUS_NO_SUCH_DOMAIN;
1193 /* work out the domain sid, and pull the domain from there */
1194 domain_sid = samdb_result_sid_prefix(mem_ctx, res[0], "objectSid");
1195 if (domain_sid == NULL) {
1196 return NT_STATUS_INTERNAL_DB_CORRUPTION;
1199 count = gendb_search(ctx, mem_ctx, NULL, &res, domain_attrs,
1201 ldap_encode_ndr_dom_sid(mem_ctx, domain_sid));
1203 DEBUG(2, ("samdb_set_password: Could not find domain to match SID: %s, for user %s\n",
1204 dom_sid_string(mem_ctx, domain_sid),
1205 ldb_dn_linearize(mem_ctx, user_dn)));
1206 return NT_STATUS_NO_SUCH_DOMAIN;
1210 pwdProperties = samdb_result_uint(res[0], "pwdProperties", 0);
1211 pwdHistoryLength = samdb_result_uint(res[0], "pwdHistoryLength", 0);
1212 minPwdLength = samdb_result_uint(res[0], "minPwdLength", 0);
1213 minPwdAge = samdb_result_int64(res[0], "minPwdAge", 0);
1216 struct samr_DomInfo1 *dominfo;
1217 /* on failure we need to fill in the reject reasons */
1218 dominfo = talloc(mem_ctx, struct samr_DomInfo1);
1219 if (dominfo == NULL) {
1220 return NT_STATUS_NO_MEMORY;
1222 dominfo->min_password_length = minPwdLength;
1223 dominfo->password_properties = pwdProperties;
1224 dominfo->password_history_length = pwdHistoryLength;
1225 dominfo->max_password_age = minPwdAge;
1226 dominfo->min_password_age = minPwdAge;
1227 *_dominfo = dominfo;
1231 /* check the various password restrictions */
1232 if (restrictions && minPwdLength > strlen_m(new_pass)) {
1233 if (reject_reason) {
1234 *reject_reason = SAMR_REJECT_TOO_SHORT;
1236 return NT_STATUS_PASSWORD_RESTRICTION;
1239 /* possibly check password complexity */
1240 if (restrictions && pwdProperties & DOMAIN_PASSWORD_COMPLEX &&
1241 !samdb_password_complexity_ok(new_pass)) {
1242 if (reject_reason) {
1243 *reject_reason = SAMR_REJECT_COMPLEXITY;
1245 return NT_STATUS_PASSWORD_RESTRICTION;
1248 /* compute the new nt and lm hashes */
1249 if (E_deshash(new_pass, local_lmNewHash.hash)) {
1250 lmNewHash = &local_lmNewHash;
1252 if (!E_md4hash(new_pass, local_ntNewHash.hash)) {
1253 /* If we can't convert this password to UCS2, then we should not accept it */
1254 if (reject_reason) {
1255 *reject_reason = SAMR_REJECT_OTHER;
1257 return NT_STATUS_PASSWORD_RESTRICTION;
1259 ntNewHash = &local_ntNewHash;
1262 if (restrictions && user_change) {
1263 /* are all password changes disallowed? */
1264 if (pwdProperties & DOMAIN_REFUSE_PASSWORD_CHANGE) {
1265 if (reject_reason) {
1266 *reject_reason = SAMR_REJECT_OTHER;
1268 return NT_STATUS_PASSWORD_RESTRICTION;
1271 /* can this user change password? */
1272 if (userAccountControl & UF_PASSWD_CANT_CHANGE) {
1273 if (reject_reason) {
1274 *reject_reason = SAMR_REJECT_OTHER;
1276 return NT_STATUS_PASSWORD_RESTRICTION;
1279 /* yes, this is a minus. The ages are in negative 100nsec units! */
1280 if (pwdLastSet - minPwdAge > now_nt) {
1281 if (reject_reason) {
1282 *reject_reason = SAMR_REJECT_OTHER;
1284 return NT_STATUS_PASSWORD_RESTRICTION;
1287 /* check the immediately past password */
1288 if (pwdHistoryLength > 0) {
1289 if (lmNewHash && lmPwdHash && memcmp(lmNewHash->hash, lmPwdHash->hash, 16) == 0) {
1290 if (reject_reason) {
1291 *reject_reason = SAMR_REJECT_IN_HISTORY;
1293 return NT_STATUS_PASSWORD_RESTRICTION;
1295 if (ntNewHash && ntPwdHash && memcmp(ntNewHash->hash, ntPwdHash->hash, 16) == 0) {
1296 if (reject_reason) {
1297 *reject_reason = SAMR_REJECT_IN_HISTORY;
1299 return NT_STATUS_PASSWORD_RESTRICTION;
1303 /* check the password history */
1304 sambaLMPwdHistory_len = MIN(sambaLMPwdHistory_len, pwdHistoryLength);
1305 sambaNTPwdHistory_len = MIN(sambaNTPwdHistory_len, pwdHistoryLength);
1307 for (i=0; lmNewHash && i<sambaLMPwdHistory_len;i++) {
1308 if (memcmp(lmNewHash->hash, sambaLMPwdHistory[i].hash, 16) == 0) {
1309 if (reject_reason) {
1310 *reject_reason = SAMR_REJECT_IN_HISTORY;
1312 return NT_STATUS_PASSWORD_RESTRICTION;
1315 for (i=0; ntNewHash && i<sambaNTPwdHistory_len;i++) {
1316 if (memcmp(ntNewHash->hash, sambaNTPwdHistory[i].hash, 16) == 0) {
1317 if (reject_reason) {
1318 *reject_reason = SAMR_REJECT_IN_HISTORY;
1320 return NT_STATUS_PASSWORD_RESTRICTION;
1325 #define CHECK_RET(x) do { if (x != 0) return NT_STATUS_NO_MEMORY; } while(0)
1327 /* the password is acceptable. Start forming the new fields */
1329 /* if we know the cleartext, then only set it.
1330 * Modules in ldb will set all the appropriate
1332 CHECK_RET(samdb_msg_add_string(ctx, mem_ctx, mod,
1333 "sambaPassword", new_pass));
1335 /* We don't have the cleartext, so delete the old one
1336 * and set what we have of the hashes */
1337 CHECK_RET(samdb_msg_add_delete(ctx, mem_ctx, mod, "sambaPassword"));
1340 CHECK_RET(samdb_msg_add_hash(ctx, mem_ctx, mod, "lmPwdHash", lmNewHash));
1342 CHECK_RET(samdb_msg_add_delete(ctx, mem_ctx, mod, "lmPwdHash"));
1346 CHECK_RET(samdb_msg_add_hash(ctx, mem_ctx, mod, "ntPwdHash", ntNewHash));
1348 CHECK_RET(samdb_msg_add_delete(ctx, mem_ctx, mod, "ntPwdHash"));
1352 return NT_STATUS_OK;
1357 set the user password using plaintext, obeying any user or domain
1358 password restrictions
1360 This wrapper function takes a SID as input, rather than a user DN,
1361 and actually performs the password change
1364 _PUBLIC_ NTSTATUS samdb_set_password_sid(struct ldb_context *ctx, TALLOC_CTX *mem_ctx,
1365 const struct dom_sid *user_sid,
1366 const char *new_pass,
1367 struct samr_Password *lmNewHash,
1368 struct samr_Password *ntNewHash,
1371 enum samr_RejectReason *reject_reason,
1372 struct samr_DomInfo1 **_dominfo)
1375 struct ldb_dn *user_dn;
1376 struct ldb_message *msg;
1379 ret = ldb_transaction_start(ctx);
1381 DEBUG(1, ("Failed to start transaction: %s\n", ldb_errstring(ctx)));
1382 return NT_STATUS_TRANSACTION_ABORTED;
1385 user_dn = samdb_search_dn(ctx, mem_ctx, NULL,
1386 "(&(objectSid=%s)(objectClass=user))",
1387 ldap_encode_ndr_dom_sid(mem_ctx, user_sid));
1389 ldb_transaction_cancel(ctx);
1390 DEBUG(3, ("samdb_set_password_sid: SID %s not found in samdb, returning NO_SUCH_USER\n",
1391 dom_sid_string(mem_ctx, user_sid)));
1392 return NT_STATUS_NO_SUCH_USER;
1395 msg = ldb_msg_new(mem_ctx);
1397 ldb_transaction_cancel(ctx);
1398 return NT_STATUS_NO_MEMORY;
1401 msg->dn = ldb_dn_copy(msg, user_dn);
1403 ldb_transaction_cancel(ctx);
1404 return NT_STATUS_NO_MEMORY;
1407 nt_status = samdb_set_password(ctx, mem_ctx,
1410 lmNewHash, ntNewHash,
1411 user_change, /* This is a password set, not change */
1412 restrictions, /* run restriction tests */
1413 reject_reason, _dominfo);
1414 if (!NT_STATUS_IS_OK(nt_status)) {
1415 ldb_transaction_cancel(ctx);
1419 /* modify the samdb record */
1420 ret = samdb_replace(ctx, mem_ctx, msg);
1422 ldb_transaction_cancel(ctx);
1423 return NT_STATUS_ACCESS_DENIED;
1426 ret = ldb_transaction_commit(ctx);
1428 DEBUG(0,("Failed to commit transaction to change password on %s: %s\n",
1429 ldb_dn_linearize(mem_ctx, msg->dn),
1430 ldb_errstring(ctx)));
1431 return NT_STATUS_TRANSACTION_ABORTED;
1433 return NT_STATUS_OK;
1436 /****************************************************************************
1437 Create the SID list for this user.
1438 ****************************************************************************/
1439 NTSTATUS security_token_create(TALLOC_CTX *mem_ctx,
1440 struct dom_sid *user_sid,
1441 struct dom_sid *group_sid,
1443 struct dom_sid **groupSIDs,
1444 BOOL is_authenticated,
1445 struct security_token **token)
1447 struct security_token *ptoken;
1451 ptoken = security_token_initialise(mem_ctx);
1452 NT_STATUS_HAVE_NO_MEMORY(ptoken);
1454 ptoken->sids = talloc_array(ptoken, struct dom_sid *, n_groupSIDs + 5);
1455 NT_STATUS_HAVE_NO_MEMORY(ptoken->sids);
1457 ptoken->user_sid = talloc_reference(ptoken, user_sid);
1458 ptoken->group_sid = talloc_reference(ptoken, group_sid);
1459 ptoken->privilege_mask = 0;
1461 ptoken->sids[0] = ptoken->user_sid;
1462 ptoken->sids[1] = ptoken->group_sid;
1465 * Finally add the "standard" SIDs.
1466 * The only difference between guest and "anonymous"
1467 * is the addition of Authenticated_Users.
1469 ptoken->sids[2] = dom_sid_parse_talloc(ptoken->sids, SID_WORLD);
1470 NT_STATUS_HAVE_NO_MEMORY(ptoken->sids[2]);
1471 ptoken->sids[3] = dom_sid_parse_talloc(ptoken->sids, SID_NT_NETWORK);
1472 NT_STATUS_HAVE_NO_MEMORY(ptoken->sids[3]);
1473 ptoken->num_sids = 4;
1475 if (is_authenticated) {
1476 ptoken->sids[4] = dom_sid_parse_talloc(ptoken->sids, SID_NT_AUTHENTICATED_USERS);
1477 NT_STATUS_HAVE_NO_MEMORY(ptoken->sids[4]);
1481 for (i = 0; i < n_groupSIDs; i++) {
1482 size_t check_sid_idx;
1483 for (check_sid_idx = 1;
1484 check_sid_idx < ptoken->num_sids;
1486 if (dom_sid_equal(ptoken->sids[check_sid_idx], groupSIDs[i])) {
1491 if (check_sid_idx == ptoken->num_sids) {
1492 ptoken->sids[ptoken->num_sids++] = talloc_reference(ptoken->sids, groupSIDs[i]);
1496 /* setup the privilege mask for this token */
1497 status = samdb_privilege_setup(ptoken);
1498 if (!NT_STATUS_IS_OK(status)) {
1499 talloc_free(ptoken);
1503 security_token_debug(10, ptoken);
1507 return NT_STATUS_OK;
1511 NTSTATUS samdb_create_foreign_security_principal(struct ldb_context *sam_ctx, TALLOC_CTX *mem_ctx,
1512 struct dom_sid *sid, struct ldb_dn **ret_dn)
1514 struct ldb_message *msg;
1515 struct ldb_dn *basedn;
1519 sidstr = dom_sid_string(mem_ctx, sid);
1520 NT_STATUS_HAVE_NO_MEMORY(sidstr);
1522 /* We might have to create a ForeignSecurityPrincipal, even if this user
1523 * is in our own domain */
1525 msg = ldb_msg_new(mem_ctx);
1527 return NT_STATUS_NO_MEMORY;
1530 /* TODO: Hmmm. This feels wrong. How do I find the base dn to
1531 * put the ForeignSecurityPrincipals? d_state->domain_dn does
1532 * not work, this is wrong for the Builtin domain, there's no
1533 * cn=For...,cn=Builtin,dc={BASEDN}. -- vl
1536 basedn = samdb_search_dn(sam_ctx, mem_ctx, NULL,
1537 "(&(objectClass=container)(cn=ForeignSecurityPrincipals))");
1539 if (basedn == NULL) {
1540 DEBUG(0, ("Failed to find DN for "
1541 "ForeignSecurityPrincipal container\n"));
1542 return NT_STATUS_INTERNAL_DB_CORRUPTION;
1545 /* add core elements to the ldb_message for the alias */
1546 msg->dn = ldb_dn_build_child(mem_ctx, "CN", sidstr, basedn);
1547 if (msg->dn == NULL)
1548 return NT_STATUS_NO_MEMORY;
1550 samdb_msg_add_string(sam_ctx, mem_ctx, msg,
1552 "foreignSecurityPrincipal");
1554 /* create the alias */
1555 ret = samdb_add(sam_ctx, mem_ctx, msg);
1557 DEBUG(0,("Failed to create foreignSecurityPrincipal "
1559 ldb_dn_linearize(mem_ctx, msg->dn),
1560 ldb_errstring(sam_ctx)));
1561 return NT_STATUS_INTERNAL_DB_CORRUPTION;
1564 return NT_STATUS_OK;