2 Samba4 module loading module
4 Copyright (C) Andrew Bartlett <abartlet@samba.org> 2009
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 * Component: Samba4 module loading module
25 * Description: Implement a single 'module' in the ldb database,
26 * which loads the remaining modules based on 'choice of configuration' attributes
28 * This is to avoid forcing a reprovision of the ldb databases when we change the internal structure of the code
30 * Author: Andrew Bartlett
35 #include <ldb_errors.h>
36 #include <ldb_module.h>
37 #include "dsdb/samdb/ldb_modules/util.h"
38 #include "dsdb/samdb/samdb.h"
39 #include "librpc/ndr/libndr.h"
40 #include "auth/credentials/credentials.h"
41 #include "param/secrets.h"
42 #include "lib/ldb-samba/ldb_wrap.h"
44 static int read_at_rootdse_record(struct ldb_context *ldb, struct ldb_module *module, TALLOC_CTX *mem_ctx,
45 struct ldb_message **msg, struct ldb_request *parent)
48 static const char *rootdse_attrs[] = { "defaultNamingContext", "configurationNamingContext", "schemaNamingContext", NULL };
49 struct ldb_result *rootdse_res;
50 struct ldb_dn *rootdse_dn;
51 TALLOC_CTX *tmp_ctx = talloc_new(mem_ctx);
56 rootdse_dn = ldb_dn_new(tmp_ctx, ldb, "@ROOTDSE");
62 ret = dsdb_module_search_dn(module, tmp_ctx, &rootdse_res, rootdse_dn,
63 rootdse_attrs, DSDB_FLAG_NEXT_MODULE, parent);
64 if (ret != LDB_SUCCESS) {
69 talloc_steal(mem_ctx, rootdse_res->msgs);
70 *msg = rootdse_res->msgs[0];
77 static int prepare_modules_line(struct ldb_context *ldb,
79 const struct ldb_message *rootdse_msg,
80 struct ldb_message *msg, const char *backend_attr,
81 const char *backend_mod, const char **backend_mod_list)
84 const char **backend_full_list;
85 const char *backend_dn;
86 char *mod_list_string;
88 TALLOC_CTX *tmp_ctx = talloc_new(mem_ctx);
94 backend_dn = ldb_msg_find_attr_as_string(rootdse_msg, backend_attr, NULL);
96 ldb_asprintf_errstring(ldb,
98 "unable to read %s from %s:%s",
99 backend_attr, ldb_dn_get_linearized(rootdse_msg->dn),
101 return LDB_ERR_CONSTRAINT_VIOLATION;
108 char **b = str_list_make_single(tmp_ctx, backend_mod);
109 backend_full_list = discard_const_p(const char *, b);
111 char **b = str_list_make_empty(tmp_ctx);
112 backend_full_list = discard_const_p(const char *, b);
114 if (!backend_full_list) {
115 talloc_free(tmp_ctx);
119 backend_full_list = str_list_append_const(backend_full_list, backend_mod_list);
120 if (!backend_full_list) {
121 talloc_free(tmp_ctx);
125 mod_list_string = str_list_join(tmp_ctx, backend_full_list, ',');
126 if (!mod_list_string) {
127 talloc_free(tmp_ctx);
131 full_string = talloc_asprintf(tmp_ctx, "%s:%s", backend_dn, mod_list_string);
132 ret = ldb_msg_add_steal_string(msg, "modules", full_string);
133 talloc_free(tmp_ctx);
138 * Force overwrite of the credentials with those
139 * specified in secrets.ldb, to connect across the
140 * ldapi socket to an LDAP backend
143 static int set_ldap_credentials(struct ldb_context *ldb, bool use_external)
145 const char *secrets_ldb_path, *sam_ldb_path;
146 char *private_dir, *p, *error_string;
147 struct ldb_context *secrets_ldb;
148 struct cli_credentials *cred;
149 struct loadparm_context *lp_ctx = ldb_get_opaque(ldb, "loadparm");
150 TALLOC_CTX *tmp_ctx = talloc_new(ldb);
156 cred = cli_credentials_init(ldb);
158 talloc_free(tmp_ctx);
161 cli_credentials_set_anonymous(cred);
163 cli_credentials_set_forced_sasl_mech(cred, "EXTERNAL");
165 cli_credentials_set_forced_sasl_mech(cred, "DIGEST-MD5");
168 * We don't want to use krb5 to talk to our samdb - recursion
169 * here would be bad, and this account isn't in the KDC
172 cli_credentials_set_kerberos_state(cred, CRED_DONT_USE_KERBEROS);
175 * Work out where *our* secrets.ldb is. It must be in
176 * the same directory as sam.ldb
178 sam_ldb_path = (const char *)ldb_get_opaque(ldb, "ldb_url");
180 talloc_free(tmp_ctx);
181 return ldb_operr(ldb);
183 if (strncmp("tdb://", sam_ldb_path, 6) == 0) {
186 private_dir = talloc_strdup(tmp_ctx, sam_ldb_path);
187 p = strrchr(private_dir, '/');
191 private_dir = talloc_strdup(tmp_ctx, ".");
194 secrets_ldb_path = talloc_asprintf(private_dir, "tdb://%s/secrets.ldb",
197 if (!secrets_ldb_path) {
198 talloc_free(tmp_ctx);
203 * Now that we have found the location, connect to
204 * secrets.ldb so we can read the SamDB Credentials
207 secrets_ldb = ldb_wrap_connect(tmp_ctx, NULL, lp_ctx, secrets_ldb_path,
210 if (!NT_STATUS_IS_OK(cli_credentials_set_secrets(cred, NULL, secrets_ldb, NULL,
211 SECRETS_LDAP_FILTER, &error_string))) {
212 ldb_asprintf_errstring(ldb, "Failed to read LDAP backend password from %s", secrets_ldb_path);
213 talloc_free(tmp_ctx);
214 return LDB_ERR_STRONG_AUTH_REQUIRED;
219 * Finally overwrite any supplied credentials with
220 * these ones, as only secrets.ldb contains the magic
221 * credentials to talk on the ldapi socket
223 if (ldb_set_opaque(ldb, "credentials", cred)) {
224 talloc_free(tmp_ctx);
225 return ldb_operr(ldb);
227 talloc_free(tmp_ctx);
231 static int samba_dsdb_init(struct ldb_module *module)
233 struct ldb_context *ldb = ldb_module_get_ctx(module);
235 TALLOC_CTX *tmp_ctx = talloc_new(module);
236 struct ldb_result *res;
237 struct ldb_message *rootdse_msg = NULL, *partition_msg;
238 struct ldb_dn *samba_dsdb_dn, *partition_dn;
239 struct ldb_module *backend_module, *module_chain;
240 const char **final_module_list, **reverse_module_list;
242 Add modules to the list to activate them by default
243 beware often order is important
245 Some Known ordering constraints:
246 - rootdse must be first, as it makes redirects from "" -> cn=rootdse
247 - extended_dn_in must be before objectclass.c, as it resolves the DN
248 - objectclass must be before password_hash and samldb since these LDB
249 modules require the expanded "objectClass" list
250 - objectclass must be before descriptor and acl, as both assume that
251 objectClass values are sorted
252 - objectclass_attrs must be behind operational in order to see all
253 attributes (the operational module protects and therefore
254 suppresses per default some important ones)
255 - partition must be last
256 - each partition has its own module list then
258 The list is presented here as a set of declarations to show the
259 stack visually - the code below then handles the creation of the list
260 based on the parameters loaded from the database.
262 static const char *modules_list1[] = {"resolve_oids",
276 /* extended_dn_in or extended_dn_in_openldap goes here */
277 static const char *modules_list1a[] = {"objectclass",
278 "tombstone_reanimate",
288 const char **link_modules;
289 static const char *fedora_ds_modules[] = {
291 static const char *openldap_modules[] = {
293 static const char *tdb_modules_list[] = {
302 const char *extended_dn_module;
303 const char *extended_dn_module_ldb = "extended_dn_out_ldb";
304 const char *extended_dn_module_fds = "extended_dn_out_fds";
305 const char *extended_dn_module_openldap = "extended_dn_out_openldap";
306 const char *extended_dn_in_module = "extended_dn_in";
308 static const char *modules_list2[] = {"dns_notify",
314 const char **backend_modules;
315 static const char *fedora_ds_backend_modules[] = {
316 "dsdb_flags_ignore", "nsuniqueid", "paged_searches", "simple_dn", NULL };
317 static const char *openldap_backend_modules[] = {
318 "dsdb_flags_ignore", "entryuuid", "simple_dn", NULL };
320 static const char *samba_dsdb_attrs[] = { "backendType",
321 SAMBA_COMPATIBLE_FEATURES_ATTR,
322 SAMBA_REQUIRED_FEATURES_ATTR, NULL };
323 static const char *partition_attrs[] = { "ldapBackend", NULL };
324 const char *backendType, *backendUrl;
325 bool use_sasl_external = false;
327 const char *current_supportedFeatures[] = {};
333 ret = ldb_register_samba_handlers(ldb);
334 if (ret != LDB_SUCCESS) {
335 talloc_free(tmp_ctx);
339 samba_dsdb_dn = ldb_dn_new(tmp_ctx, ldb, "@SAMBA_DSDB");
340 if (!samba_dsdb_dn) {
341 talloc_free(tmp_ctx);
345 partition_dn = ldb_dn_new(tmp_ctx, ldb, DSDB_PARTITION_DN);
347 talloc_free(tmp_ctx);
351 #define CHECK_LDB_RET(check_ret) \
353 if (check_ret != LDB_SUCCESS) { \
354 talloc_free(tmp_ctx); \
359 ret = dsdb_module_search_dn(module, tmp_ctx, &res, samba_dsdb_dn,
360 samba_dsdb_attrs, DSDB_FLAG_NEXT_MODULE, NULL);
361 if (ret == LDB_ERR_NO_SUCH_OBJECT) {
363 } else if (ret == LDB_SUCCESS) {
364 struct ldb_message_element *requiredFeatures;
365 struct ldb_message_element *old_compatibleFeatures;
367 backendType = ldb_msg_find_attr_as_string(res->msgs[0], "backendType", "ldb");
369 requiredFeatures = ldb_msg_find_element(res->msgs[0], SAMBA_REQUIRED_FEATURES_ATTR);
370 if (requiredFeatures != NULL) {
371 ldb_set_errstring(ldb, "This Samba database was created with "
372 "a newer Samba version and is marked with "
373 "requiredFeatures in @SAMBA_DSDB. "
374 "This database can not safely be read by this Samba version");
375 return LDB_ERR_OPERATIONS_ERROR;
378 old_compatibleFeatures = ldb_msg_find_element(res->msgs[0],
379 SAMBA_COMPATIBLE_FEATURES_ATTR);
381 if (old_compatibleFeatures) {
382 struct ldb_message *features_msg;
383 struct ldb_message_element *features_el;
385 features_msg = ldb_msg_new(res);
386 if (features_msg == NULL) {
387 return ldb_module_operr(module);
389 features_msg->dn = samba_dsdb_dn;
391 ldb_msg_add_empty(features_msg, SAMBA_COMPATIBLE_FEATURES_ATTR,
392 LDB_FLAG_MOD_DELETE, &features_el);
395 old_compatibleFeatures && i < old_compatibleFeatures->num_values;
398 j < ARRAY_SIZE(current_supportedFeatures); j++) {
399 if (strcmp((char *)old_compatibleFeatures->values[i].data,
400 current_supportedFeatures[j]) == 0) {
404 if (j == ARRAY_SIZE(current_supportedFeatures)) {
406 * Add to list of features to remove
407 * (rather than all features)
409 ret = ldb_msg_add_value(features_msg, SAMBA_COMPATIBLE_FEATURES_ATTR,
410 &old_compatibleFeatures->values[i],
412 if (ret != LDB_SUCCESS) {
417 if (features_el->num_values > 0) {
419 ret = ldb_next_start_trans(module);
420 if (ret != LDB_SUCCESS) {
423 ret = dsdb_module_modify(module, features_msg, DSDB_FLAG_NEXT_MODULE, NULL);
424 if (ret != LDB_SUCCESS) {
425 ldb_next_del_trans(module);
428 ret = ldb_next_end_trans(module);
429 if (ret != LDB_SUCCESS) {
436 talloc_free(tmp_ctx);
440 backend_modules = NULL;
441 if (strcasecmp(backendType, "ldb") == 0) {
442 extended_dn_module = extended_dn_module_ldb;
443 link_modules = tdb_modules_list;
445 struct cli_credentials *cred;
446 bool is_ldapi = false;
448 ret = dsdb_module_search_dn(module, tmp_ctx, &res, partition_dn,
449 partition_attrs, DSDB_FLAG_NEXT_MODULE, NULL);
450 if (ret == LDB_SUCCESS) {
451 backendUrl = ldb_msg_find_attr_as_string(res->msgs[0], "ldapBackend", "ldapi://");
452 if (!strncasecmp(backendUrl, "ldapi://", sizeof("ldapi://")-1)) {
455 } else if (ret != LDB_ERR_NO_SUCH_OBJECT) {
456 talloc_free(tmp_ctx);
459 if (strcasecmp(backendType, "fedora-ds") == 0) {
460 link_modules = fedora_ds_modules;
461 backend_modules = fedora_ds_backend_modules;
462 extended_dn_module = extended_dn_module_fds;
463 } else if (strcasecmp(backendType, "openldap") == 0) {
464 link_modules = openldap_modules;
465 backend_modules = openldap_backend_modules;
466 extended_dn_module = extended_dn_module_openldap;
467 extended_dn_in_module = "extended_dn_in_openldap";
469 use_sasl_external = true;
472 return ldb_error(ldb, LDB_ERR_OPERATIONS_ERROR, "invalid backend type");
474 ret = ldb_set_opaque(ldb, "readOnlySchema", (void*)1);
475 if (ret != LDB_SUCCESS) {
476 ldb_set_errstring(ldb, "Failed to set readOnlySchema opaque");
479 cred = ldb_get_opaque(ldb, "credentials");
480 if (!cred || !cli_credentials_authentication_requested(cred)) {
481 ret = set_ldap_credentials(ldb, use_sasl_external);
482 if (ret != LDB_SUCCESS) {
488 #define CHECK_MODULE_LIST \
490 if (!final_module_list) { \
491 talloc_free(tmp_ctx); \
492 return ldb_oom(ldb); \
496 final_module_list = str_list_copy_const(tmp_ctx, modules_list1);
499 final_module_list = str_list_add_const(final_module_list, extended_dn_in_module);
502 final_module_list = str_list_append_const(final_module_list, modules_list1a);
505 final_module_list = str_list_append_const(final_module_list, link_modules);
508 final_module_list = str_list_add_const(final_module_list, extended_dn_module);
511 final_module_list = str_list_append_const(final_module_list, modules_list2);
515 ret = read_at_rootdse_record(ldb, module, tmp_ctx, &rootdse_msg, NULL);
518 partition_msg = ldb_msg_new(tmp_ctx);
519 partition_msg->dn = ldb_dn_new(partition_msg, ldb, "@" DSDB_OPAQUE_PARTITION_MODULE_MSG_OPAQUE_NAME);
521 ret = prepare_modules_line(ldb, tmp_ctx,
523 partition_msg, "schemaNamingContext",
524 "schema_data", backend_modules);
527 ret = prepare_modules_line(ldb, tmp_ctx,
530 NULL, backend_modules);
533 ret = ldb_set_opaque(ldb, DSDB_OPAQUE_PARTITION_MODULE_MSG_OPAQUE_NAME, partition_msg);
536 talloc_steal(ldb, partition_msg);
538 /* Now prepare the module chain. Oddly, we must give it to ldb_load_modules_list in REVERSE */
539 for (len = 0; final_module_list[len]; len++) { /* noop */};
541 reverse_module_list = talloc_array(tmp_ctx, const char *, len+1);
542 if (!reverse_module_list) {
543 talloc_free(tmp_ctx);
546 for (i=0; i < len; i++) {
547 reverse_module_list[i] = final_module_list[(len - 1) - i];
549 reverse_module_list[i] = NULL;
551 /* The backend (at least until the partitions module
552 * reconfigures things) is the next module in the currently
554 backend_module = ldb_module_next(module);
555 ret = ldb_module_load_list(ldb, reverse_module_list, backend_module, &module_chain);
558 talloc_free(tmp_ctx);
559 /* Set this as the 'next' module, so that we effectivly append it to module chain */
560 ldb_module_set_next(module, module_chain);
562 return ldb_next_init(module);
565 static const struct ldb_module_ops ldb_samba_dsdb_module_ops = {
566 .name = "samba_dsdb",
567 .init_context = samba_dsdb_init,
570 static struct ldb_message *dsdb_flags_ignore_fixup(TALLOC_CTX *mem_ctx,
571 const struct ldb_message *_msg)
573 struct ldb_message *msg = NULL;
576 /* we have to copy the message as the caller might have it as a const */
577 msg = ldb_msg_copy_shallow(mem_ctx, _msg);
582 for (i=0; i < msg->num_elements;) {
583 struct ldb_message_element *e = &msg->elements[i];
585 if (!(e->flags & DSDB_FLAG_INTERNAL_FORCE_META_DATA)) {
590 e->flags &= ~DSDB_FLAG_INTERNAL_FORCE_META_DATA;
592 if (e->num_values != 0) {
597 ldb_msg_remove_element(msg, e);
603 static int dsdb_flags_ignore_add(struct ldb_module *module, struct ldb_request *req)
605 struct ldb_context *ldb = ldb_module_get_ctx(module);
606 struct ldb_request *down_req = NULL;
607 struct ldb_message *msg = NULL;
610 msg = dsdb_flags_ignore_fixup(req, req->op.add.message);
612 return ldb_module_oom(module);
615 ret = ldb_build_add_req(&down_req, ldb, req,
618 req, dsdb_next_callback,
620 LDB_REQ_SET_LOCATION(down_req);
621 if (ret != LDB_SUCCESS) {
625 /* go on with the call chain */
626 return ldb_next_request(module, down_req);
629 static int dsdb_flags_ignore_modify(struct ldb_module *module, struct ldb_request *req)
631 struct ldb_context *ldb = ldb_module_get_ctx(module);
632 struct ldb_request *down_req = NULL;
633 struct ldb_message *msg = NULL;
636 msg = dsdb_flags_ignore_fixup(req, req->op.mod.message);
638 return ldb_module_oom(module);
641 ret = ldb_build_mod_req(&down_req, ldb, req,
644 req, dsdb_next_callback,
646 LDB_REQ_SET_LOCATION(down_req);
647 if (ret != LDB_SUCCESS) {
651 /* go on with the call chain */
652 return ldb_next_request(module, down_req);
655 static const struct ldb_module_ops ldb_dsdb_flags_ignore_module_ops = {
656 .name = "dsdb_flags_ignore",
657 .add = dsdb_flags_ignore_add,
658 .modify = dsdb_flags_ignore_modify,
661 int ldb_samba_dsdb_module_init(const char *version)
664 LDB_MODULE_CHECK_VERSION(version);
665 ret = ldb_register_module(&ldb_samba_dsdb_module_ops);
666 if (ret != LDB_SUCCESS) {
669 ret = ldb_register_module(&ldb_dsdb_flags_ignore_module_ops);
670 if (ret != LDB_SUCCESS) {