s3: Fix bug #9085.
[Samba.git] / source3 / winbindd / idmap.c
blob7aa2853df10c4e556152ea18689b74a7727d81d4
1 /*
2 Unix SMB/CIFS implementation.
3 ID Mapping
4 Copyright (C) Tim Potter 2000
5 Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2003
6 Copyright (C) Simo Sorce 2003-2007
7 Copyright (C) Jeremy Allison 2006
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "includes.h"
24 #include "winbindd.h"
26 #undef DBGC_CLASS
27 #define DBGC_CLASS DBGC_IDMAP
29 static_decl_idmap;
31 /**
32 * Pointer to the backend methods. Modules register themselves here via
33 * smb_register_idmap.
36 struct idmap_backend {
37 const char *name;
38 struct idmap_methods *methods;
39 struct idmap_backend *prev, *next;
41 static struct idmap_backend *backends = NULL;
43 /**
44 * Pointer to the alloc backend methods. Modules register themselves here via
45 * smb_register_idmap_alloc.
47 struct idmap_alloc_backend {
48 const char *name;
49 struct idmap_alloc_methods *methods;
50 struct idmap_alloc_backend *prev, *next;
52 static struct idmap_alloc_backend *alloc_backends = NULL;
54 /**
55 * The idmap alloc context that is configured via "idmap alloc
56 * backend". Defaults to "idmap backend" in case the module (tdb, ldap) also
57 * provides alloc methods.
59 struct idmap_alloc_context {
60 struct idmap_alloc_methods *methods;
62 static struct idmap_alloc_context *idmap_alloc_ctx = NULL;
64 /**
65 * Default idmap domain configured via "idmap backend".
67 static struct idmap_domain *default_idmap_domain;
69 /**
70 * Passdb idmap domain, not configurable. winbind must always give passdb a
71 * chance to map ids.
73 static struct idmap_domain *passdb_idmap_domain;
75 /**
76 * List of specially configured idmap domains. This list is filled on demand
77 * in the winbind idmap child when the parent winbind figures out via the
78 * special range parameter or via the domain SID that a special "idmap config
79 * domain" configuration is present.
81 static struct idmap_domain **idmap_domains = NULL;
82 static int num_domains = 0;
84 static struct idmap_methods *get_methods(const char *name)
86 struct idmap_backend *b;
88 for (b = backends; b; b = b->next) {
89 if (strequal(b->name, name)) {
90 return b->methods;
94 return NULL;
97 static struct idmap_alloc_methods *get_alloc_methods(const char *name)
99 struct idmap_alloc_backend *b;
101 for (b = alloc_backends; b; b = b->next) {
102 if (strequal(b->name, name)) {
103 return b->methods;
107 return NULL;
110 bool idmap_is_offline(void)
112 return ( lp_winbind_offline_logon() &&
113 get_global_winbindd_state_offline() );
116 bool idmap_is_online(void)
118 return !idmap_is_offline();
121 /**********************************************************************
122 Allow a module to register itself as a method.
123 **********************************************************************/
125 NTSTATUS smb_register_idmap(int version, const char *name,
126 struct idmap_methods *methods)
128 struct idmap_backend *entry;
130 if ((version != SMB_IDMAP_INTERFACE_VERSION)) {
131 DEBUG(0, ("Failed to register idmap module.\n"
132 "The module was compiled against "
133 "SMB_IDMAP_INTERFACE_VERSION %d,\n"
134 "current SMB_IDMAP_INTERFACE_VERSION is %d.\n"
135 "Please recompile against the current version "
136 "of samba!\n",
137 version, SMB_IDMAP_INTERFACE_VERSION));
138 return NT_STATUS_OBJECT_TYPE_MISMATCH;
141 if (!name || !name[0] || !methods) {
142 DEBUG(0,("Called with NULL pointer or empty name!\n"));
143 return NT_STATUS_INVALID_PARAMETER;
146 for (entry = backends; entry != NULL; entry = entry->next) {
147 if (strequal(entry->name, name)) {
148 DEBUG(0,("Idmap module %s already registered!\n",
149 name));
150 return NT_STATUS_OBJECT_NAME_COLLISION;
154 entry = talloc(NULL, struct idmap_backend);
155 if ( ! entry) {
156 DEBUG(0,("Out of memory!\n"));
157 TALLOC_FREE(entry);
158 return NT_STATUS_NO_MEMORY;
160 entry->name = talloc_strdup(entry, name);
161 if ( ! entry->name) {
162 DEBUG(0,("Out of memory!\n"));
163 TALLOC_FREE(entry);
164 return NT_STATUS_NO_MEMORY;
166 entry->methods = methods;
168 DLIST_ADD(backends, entry);
169 DEBUG(5, ("Successfully added idmap backend '%s'\n", name));
170 return NT_STATUS_OK;
173 /**********************************************************************
174 Allow a module to register itself as an alloc method.
175 **********************************************************************/
177 NTSTATUS smb_register_idmap_alloc(int version, const char *name,
178 struct idmap_alloc_methods *methods)
180 struct idmap_alloc_methods *test;
181 struct idmap_alloc_backend *entry;
183 if ((version != SMB_IDMAP_INTERFACE_VERSION)) {
184 DEBUG(0, ("Failed to register idmap alloc module.\n"
185 "The module was compiled against "
186 "SMB_IDMAP_INTERFACE_VERSION %d,\n"
187 "current SMB_IDMAP_INTERFACE_VERSION is %d.\n"
188 "Please recompile against the current version "
189 "of samba!\n",
190 version, SMB_IDMAP_INTERFACE_VERSION));
191 return NT_STATUS_OBJECT_TYPE_MISMATCH;
194 if (!name || !name[0] || !methods) {
195 DEBUG(0,("Called with NULL pointer or empty name!\n"));
196 return NT_STATUS_INVALID_PARAMETER;
199 test = get_alloc_methods(name);
200 if (test) {
201 DEBUG(0,("idmap_alloc module %s already registered!\n", name));
202 return NT_STATUS_OBJECT_NAME_COLLISION;
205 entry = talloc(NULL, struct idmap_alloc_backend);
206 if ( ! entry) {
207 DEBUG(0,("Out of memory!\n"));
208 return NT_STATUS_NO_MEMORY;
210 entry->name = talloc_strdup(entry, name);
211 if ( ! entry->name) {
212 DEBUG(0,("Out of memory!\n"));
213 return NT_STATUS_NO_MEMORY;
215 entry->methods = methods;
217 DLIST_ADD(alloc_backends, entry);
218 DEBUG(5, ("Successfully added idmap alloc backend '%s'\n", name));
219 return NT_STATUS_OK;
222 static int close_domain_destructor(struct idmap_domain *dom)
224 NTSTATUS ret;
226 ret = dom->methods->close_fn(dom);
227 if (!NT_STATUS_IS_OK(ret)) {
228 DEBUG(3, ("Failed to close idmap domain [%s]!\n", dom->name));
231 return 0;
234 static bool parse_idmap_module(TALLOC_CTX *mem_ctx, const char *param,
235 char **pmodulename, char **pargs)
237 char *modulename;
238 char *args;
240 if (strncmp(param, "idmap_", 6) == 0) {
241 param += 6;
242 DEBUG(1, ("idmap_init: idmap backend uses deprecated "
243 "'idmap_' prefix. Please replace 'idmap_%s' by "
244 "'%s'\n", param, param));
247 modulename = talloc_strdup(mem_ctx, param);
248 if (modulename == NULL) {
249 return false;
252 args = strchr(modulename, ':');
253 if (args == NULL) {
254 *pmodulename = modulename;
255 *pargs = NULL;
256 return true;
259 *args = '\0';
261 args = talloc_strdup(mem_ctx, args+1);
262 if (args == NULL) {
263 TALLOC_FREE(modulename);
264 return false;
267 *pmodulename = modulename;
268 *pargs = args;
269 return true;
273 * Initialize a domain structure
274 * @param[in] mem_ctx memory context for the result
275 * @param[in] domainname which domain is this for
276 * @param[in] modulename which backend module
277 * @param[in] params parameter to pass to the init function
278 * @result The initialized structure
280 static struct idmap_domain *idmap_init_domain(TALLOC_CTX *mem_ctx,
281 const char *domainname,
282 const char *modulename,
283 const char *params)
285 struct idmap_domain *result;
286 NTSTATUS status;
288 result = talloc_zero(mem_ctx, struct idmap_domain);
289 if (result == NULL) {
290 DEBUG(0, ("talloc failed\n"));
291 return NULL;
294 result->name = talloc_strdup(result, domainname);
295 if (result->name == NULL) {
296 DEBUG(0, ("talloc failed\n"));
297 goto fail;
300 result->methods = get_methods(modulename);
301 if (result->methods == NULL) {
302 DEBUG(3, ("idmap backend %s not found\n", modulename));
304 status = smb_probe_module("idmap", modulename);
305 if (!NT_STATUS_IS_OK(status)) {
306 DEBUG(3, ("Could not probe idmap module %s\n",
307 modulename));
308 goto fail;
311 result->methods = get_methods(modulename);
313 if (result->methods == NULL) {
314 DEBUG(1, ("idmap backend %s not found\n", modulename));
315 goto fail;
318 status = result->methods->init(result, params);
319 if (!NT_STATUS_IS_OK(status)) {
320 DEBUG(1, ("idmap initialization returned %s\n",
321 nt_errstr(status)));
322 goto fail;
325 talloc_set_destructor(result, close_domain_destructor);
327 return result;
329 fail:
330 TALLOC_FREE(result);
331 return NULL;
335 * Initialize the default domain structure
336 * @param[in] mem_ctx memory context for the result
337 * @result The default domain structure
339 * This routine takes the module name from the "idmap backend" parameter,
340 * passing a possible parameter like ldap:ldap://ldap-url/ to the module.
343 static struct idmap_domain *idmap_init_default_domain(TALLOC_CTX *mem_ctx)
345 struct idmap_domain *result;
346 char *modulename;
347 char *params;
349 DEBUG(10, ("idmap_init_default_domain: calling static_init_idmap\n"));
351 static_init_idmap;
353 if (!parse_idmap_module(talloc_tos(), lp_idmap_backend(), &modulename,
354 &params)) {
355 DEBUG(1, ("parse_idmap_module failed\n"));
356 return NULL;
359 DEBUG(3, ("idmap_init: using '%s' as remote backend\n", modulename));
361 result = idmap_init_domain(mem_ctx, "*", modulename, params);
362 if (result == NULL) {
363 goto fail;
366 TALLOC_FREE(modulename);
367 TALLOC_FREE(params);
368 return result;
370 fail:
371 TALLOC_FREE(modulename);
372 TALLOC_FREE(params);
373 TALLOC_FREE(result);
374 return NULL;
378 * Initialize a named domain structure
379 * @param[in] mem_ctx memory context for the result
380 * @param[in] domname the domain name
381 * @result The default domain structure
383 * This routine looks at the "idmap config <domname>" parameters to figure out
384 * the configuration.
387 static struct idmap_domain *idmap_init_named_domain(TALLOC_CTX *mem_ctx,
388 const char *domname)
390 struct idmap_domain *result = NULL;
391 char *config_option;
392 const char *backend;
394 config_option = talloc_asprintf(talloc_tos(), "idmap config %s",
395 domname);
396 if (config_option == NULL) {
397 DEBUG(0, ("talloc failed\n"));
398 goto fail;
401 backend = lp_parm_const_string(-1, config_option, "backend", NULL);
402 if (backend == NULL) {
403 DEBUG(1, ("no backend defined for %s\n", config_option));
404 goto fail;
407 result = idmap_init_domain(mem_ctx, domname, backend, NULL);
408 if (result == NULL) {
409 goto fail;
412 TALLOC_FREE(config_option);
413 return result;
415 fail:
416 TALLOC_FREE(config_option);
417 TALLOC_FREE(result);
418 return NULL;
422 * Initialize the passdb domain structure
423 * @param[in] mem_ctx memory context for the result
424 * @result The default domain structure
426 * No config, passdb has its own configuration.
429 static struct idmap_domain *idmap_init_passdb_domain(TALLOC_CTX *mem_ctx)
432 * Always init the default domain, we can't go without one
434 if (default_idmap_domain == NULL) {
435 default_idmap_domain = idmap_init_default_domain(NULL);
437 if (default_idmap_domain == NULL) {
438 return NULL;
441 if (passdb_idmap_domain != NULL) {
442 return passdb_idmap_domain;
445 passdb_idmap_domain = idmap_init_domain(NULL, get_global_sam_name(),
446 "passdb", NULL);
447 if (passdb_idmap_domain == NULL) {
448 DEBUG(1, ("Could not init passdb idmap domain\n"));
451 return passdb_idmap_domain;
455 * Find a domain struct according to a domain name
456 * @param[in] domname Domain name to get the config for
457 * @result The default domain structure that fits
459 * This is the central routine in the winbindd-idmap child to pick the correct
460 * domain for looking up IDs. If domname is NULL or empty, we use the default
461 * domain. If it contains something, we try to use idmap_init_named_domain()
462 * to fetch the correct backend.
464 * The choice about "domname" is being made by the winbind parent, look at the
465 * "have_idmap_config" of "struct winbindd_domain" which is set in
466 * add_trusted_domain.
469 static struct idmap_domain *idmap_find_domain(const char *domname)
471 struct idmap_domain *result;
472 int i;
474 DEBUG(10, ("idmap_find_domain called for domain '%s'\n",
475 domname?domname:"NULL"));
478 * Always init the default domain, we can't go without one
480 if (default_idmap_domain == NULL) {
481 default_idmap_domain = idmap_init_default_domain(NULL);
483 if (default_idmap_domain == NULL) {
484 return NULL;
487 if ((domname == NULL) || (domname[0] == '\0')) {
488 return default_idmap_domain;
491 for (i=0; i<num_domains; i++) {
492 if (strequal(idmap_domains[i]->name, domname)) {
493 return idmap_domains[i];
497 if (idmap_domains == NULL) {
499 * talloc context for all idmap domains
501 idmap_domains = TALLOC_ARRAY(NULL, struct idmap_domain *, 1);
504 if (idmap_domains == NULL) {
505 DEBUG(0, ("talloc failed\n"));
506 return NULL;
509 result = idmap_init_named_domain(idmap_domains, domname);
510 if (result == NULL) {
512 * Could not init that domain -- try the default one
514 return default_idmap_domain;
517 ADD_TO_ARRAY(idmap_domains, struct idmap_domain *, result,
518 &idmap_domains, &num_domains);
519 return result;
522 void idmap_close(void)
524 if (idmap_alloc_ctx) {
525 idmap_alloc_ctx->methods->close_fn();
526 idmap_alloc_ctx->methods = NULL;
528 alloc_backends = NULL;
529 TALLOC_FREE(default_idmap_domain);
530 TALLOC_FREE(passdb_idmap_domain);
531 TALLOC_FREE(idmap_domains);
532 num_domains = 0;
536 * Initialize the idmap alloc backend
537 * @param[out] ctx Where to put the alloc_ctx?
538 * @result Did it work fine?
540 * This routine first looks at "idmap alloc backend" and if that is not
541 * defined, it uses "idmap backend" for the module name.
543 static NTSTATUS idmap_alloc_init(struct idmap_alloc_context **ctx)
545 const char *backend;
546 char *modulename, *params;
547 NTSTATUS ret = NT_STATUS_NO_MEMORY;;
549 static_init_idmap;
551 if (idmap_alloc_ctx != NULL) {
552 *ctx = idmap_alloc_ctx;
553 return NT_STATUS_OK;
556 idmap_alloc_ctx = talloc(NULL, struct idmap_alloc_context);
557 if (idmap_alloc_ctx == NULL) {
558 DEBUG(0, ("talloc failed\n"));
559 goto fail;
562 backend = lp_idmap_alloc_backend();
563 if ((backend == NULL) || (backend[0] == '\0')) {
564 backend = lp_idmap_backend();
567 if (backend == NULL) {
568 DEBUG(3, ("no idmap alloc backend defined\n"));
569 ret = NT_STATUS_INVALID_PARAMETER;
570 goto fail;
573 if (!parse_idmap_module(idmap_alloc_ctx, backend, &modulename,
574 &params)) {
575 DEBUG(1, ("parse_idmap_module %s failed\n", backend));
576 goto fail;
579 idmap_alloc_ctx->methods = get_alloc_methods(modulename);
581 if (idmap_alloc_ctx->methods == NULL) {
582 ret = smb_probe_module("idmap", modulename);
583 if (NT_STATUS_IS_OK(ret)) {
584 idmap_alloc_ctx->methods =
585 get_alloc_methods(modulename);
589 if (idmap_alloc_ctx->methods == NULL) {
590 DEBUG(1, ("could not find idmap alloc module %s\n", backend));
591 ret = NT_STATUS_INVALID_PARAMETER;
592 goto fail;
595 ret = idmap_alloc_ctx->methods->init(params);
597 if (!NT_STATUS_IS_OK(ret)) {
598 DEBUG(0, ("ERROR: Initialization failed for alloc "
599 "backend, deferred!\n"));
600 goto fail;
603 TALLOC_FREE(modulename);
604 TALLOC_FREE(params);
606 *ctx = idmap_alloc_ctx;
607 return NT_STATUS_OK;
609 fail:
610 TALLOC_FREE(idmap_alloc_ctx);
611 return ret;
614 /**************************************************************************
615 idmap allocator interface functions
616 **************************************************************************/
618 NTSTATUS idmap_allocate_uid(struct unixid *id)
620 struct idmap_alloc_context *ctx;
621 NTSTATUS ret;
623 if (!NT_STATUS_IS_OK(ret = idmap_alloc_init(&ctx))) {
624 return ret;
627 id->type = ID_TYPE_UID;
628 return ctx->methods->allocate_id(id);
631 NTSTATUS idmap_allocate_gid(struct unixid *id)
633 struct idmap_alloc_context *ctx;
634 NTSTATUS ret;
636 if (!NT_STATUS_IS_OK(ret = idmap_alloc_init(&ctx))) {
637 return ret;
640 id->type = ID_TYPE_GID;
641 return ctx->methods->allocate_id(id);
644 NTSTATUS idmap_set_uid_hwm(struct unixid *id)
646 struct idmap_alloc_context *ctx;
647 NTSTATUS ret;
649 if (!NT_STATUS_IS_OK(ret = idmap_alloc_init(&ctx))) {
650 return ret;
653 id->type = ID_TYPE_UID;
654 return ctx->methods->set_id_hwm(id);
657 NTSTATUS idmap_set_gid_hwm(struct unixid *id)
659 struct idmap_alloc_context *ctx;
660 NTSTATUS ret;
662 if (!NT_STATUS_IS_OK(ret = idmap_alloc_init(&ctx))) {
663 return ret;
666 id->type = ID_TYPE_GID;
667 return ctx->methods->set_id_hwm(id);
670 NTSTATUS idmap_new_mapping(const struct dom_sid *psid, enum id_type type,
671 struct unixid *pxid)
673 struct dom_sid sid;
674 struct idmap_domain *dom;
675 struct id_map map;
676 NTSTATUS status;
678 dom = idmap_find_domain(NULL);
679 if (dom == NULL) {
680 DEBUG(3, ("no default domain, no place to write\n"));
681 return NT_STATUS_ACCESS_DENIED;
683 if (dom->methods->set_mapping == NULL) {
684 DEBUG(3, ("default domain not writable\n"));
685 return NT_STATUS_MEDIA_WRITE_PROTECTED;
688 sid_copy(&sid, psid);
689 map.sid = &sid;
690 map.xid.type = type;
692 switch (type) {
693 case ID_TYPE_UID:
694 status = idmap_allocate_uid(&map.xid);
695 break;
696 case ID_TYPE_GID:
697 status = idmap_allocate_gid(&map.xid);
698 break;
699 default:
700 status = NT_STATUS_INVALID_PARAMETER;
701 break;
704 if (!NT_STATUS_IS_OK(status)) {
705 DEBUG(3, ("Could not allocate id: %s\n", nt_errstr(status)));
706 return status;
709 map.status = ID_MAPPED;
711 DEBUG(10, ("Setting mapping: %s <-> %s %lu\n",
712 sid_string_dbg(map.sid),
713 (map.xid.type == ID_TYPE_UID) ? "UID" : "GID",
714 (unsigned long)map.xid.id));
716 status = dom->methods->set_mapping(dom, &map);
718 if (NT_STATUS_EQUAL(status, NT_STATUS_OBJECT_NAME_COLLISION)) {
719 struct id_map *ids[2];
720 DEBUG(5, ("Mapping for %s exists - retrying to map sid\n",
721 sid_string_dbg(map.sid)));
722 ids[0] = &map;
723 ids[1] = NULL;
724 status = dom->methods->sids_to_unixids(dom, ids);
727 if (!NT_STATUS_IS_OK(status)) {
728 DEBUG(3, ("Could not store the new mapping: %s\n",
729 nt_errstr(status)));
730 return status;
733 *pxid = map.xid;
735 return NT_STATUS_OK;
738 NTSTATUS idmap_backends_unixid_to_sid(const char *domname, struct id_map *id)
740 struct idmap_domain *dom;
741 struct id_map *maps[2];
743 DEBUG(10, ("idmap_backend_unixid_to_sid: domain = '%s', xid = %d "
744 "(type %d)\n",
745 domname?domname:"NULL", id->xid.id, id->xid.type));
747 maps[0] = id;
748 maps[1] = NULL;
751 * Always give passdb a chance first
754 dom = idmap_init_passdb_domain(NULL);
755 if ((dom != NULL)
756 && NT_STATUS_IS_OK(dom->methods->unixids_to_sids(dom, maps))
757 && id->status == ID_MAPPED) {
758 return NT_STATUS_OK;
761 dom = idmap_find_domain(domname);
762 if (dom == NULL) {
763 return NT_STATUS_NONE_MAPPED;
766 return dom->methods->unixids_to_sids(dom, maps);
769 NTSTATUS idmap_backends_sid_to_unixid(const char *domain, struct id_map *id)
771 struct idmap_domain *dom;
772 struct id_map *maps[2];
774 DEBUG(10, ("idmap_backends_sid_to_unixid: domain = '%s', sid = [%s]\n",
775 domain?domain:"NULL", sid_string_dbg(id->sid)));
777 maps[0] = id;
778 maps[1] = NULL;
780 if (sid_check_is_in_builtin(id->sid)
781 || (sid_check_is_in_our_domain(id->sid))) {
783 dom = idmap_init_passdb_domain(NULL);
784 if (dom == NULL) {
785 return NT_STATUS_NONE_MAPPED;
787 return dom->methods->sids_to_unixids(dom, maps);
790 dom = idmap_find_domain(domain);
791 if (dom == NULL) {
792 return NT_STATUS_NONE_MAPPED;
795 return dom->methods->sids_to_unixids(dom, maps);
798 NTSTATUS idmap_set_mapping(const struct id_map *map)
800 struct idmap_domain *dom;
802 dom = idmap_find_domain(NULL);
803 if (dom == NULL) {
804 DEBUG(3, ("no default domain, no place to write\n"));
805 return NT_STATUS_ACCESS_DENIED;
807 if (dom->methods->set_mapping == NULL) {
808 DEBUG(3, ("default domain not writable\n"));
809 return NT_STATUS_MEDIA_WRITE_PROTECTED;
812 return dom->methods->set_mapping(dom, map);
815 NTSTATUS idmap_remove_mapping(const struct id_map *map)
817 struct idmap_domain *dom;
819 dom = idmap_find_domain(NULL);
820 if (dom == NULL) {
821 DEBUG(3, ("no default domain, no place to write\n"));
822 return NT_STATUS_ACCESS_DENIED;
824 if (dom->methods->remove_mapping == NULL) {
825 DEBUG(3, ("default domain not writable\n"));
826 return NT_STATUS_MEDIA_WRITE_PROTECTED;
829 return dom->methods->remove_mapping(dom, map);