docs: Fix some typos in the idmap backend section.
[Samba.git] / source3 / lib / util_wellknown.c
bloba3db9ab5b445b5026e4a45ada35b1375eec717ca
1 /*
2 Unix SMB/CIFS implementation.
3 Lookup routines for well-known SIDs
4 Copyright (C) Andrew Tridgell 1992-1998
5 Copyright (C) Luke Kenneth Caseson Leighton 1998-1999
6 Copyright (C) Jeremy Allison 1999
7 Copyright (C) Volker Lendecke 2005
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 "../libcli/security/security.h"
26 struct rid_name_map {
27 uint32_t rid;
28 const char *name;
31 struct sid_name_map_info
33 const struct dom_sid *sid;
34 const char *name;
35 const struct rid_name_map *known_users;
38 static const struct rid_name_map everyone_users[] = {
39 { 0, "Everyone" },
40 { 0, NULL}};
42 static const struct rid_name_map local_authority_users[] = {
43 { 0, "Local" },
44 { 1, "Console Logon" },
45 { 0, NULL}};
47 static const struct rid_name_map creator_owner_users[] = {
48 { 0, "Creator Owner" },
49 { 1, "Creator Group" },
50 { 2, "Creator Owner Server" },
51 { 3, "Creator Group Server" },
52 { 4, "Owner Rights" },
53 { 0, NULL}};
55 static const struct rid_name_map nt_authority_users[] = {
56 { 1, "Dialup" },
57 { 2, "Network"},
58 { 3, "Batch"},
59 { 4, "Interactive"},
60 { 6, "Service"},
61 { 7, "Anonymous Logon"},
62 { 8, "Proxy"},
63 { 9, "Enterprise Domain Controllers"},
64 { 10, "Self"},
65 { 11, "Authenticated Users"},
66 { 12, "Restricted"},
67 { 13, "Terminal Server User"},
68 { 14, "Remote Interactive Logon"},
69 { 15, "This Organization"},
70 { 17, "IUSR"},
71 { 18, "SYSTEM"},
72 { 19, "Local Service"},
73 { 20, "Network Service"},
74 { 0, NULL}};
76 static struct sid_name_map_info special_domains[] = {
77 { &global_sid_World_Domain, "", everyone_users },
78 { &global_sid_Local_Authority, "", local_authority_users },
79 { &global_sid_Creator_Owner_Domain, "", creator_owner_users },
80 { &global_sid_NT_Authority, "NT Authority", nt_authority_users },
81 { NULL, NULL, NULL }};
83 bool sid_check_is_wellknown_domain(const struct dom_sid *sid, const char **name)
85 int i;
87 for (i=0; special_domains[i].sid != NULL; i++) {
88 if (dom_sid_equal(sid, special_domains[i].sid)) {
89 if (name != NULL) {
90 *name = special_domains[i].name;
92 return True;
95 return False;
98 bool sid_check_is_in_wellknown_domain(const struct dom_sid *sid)
100 struct dom_sid dom_sid;
102 sid_copy(&dom_sid, sid);
103 sid_split_rid(&dom_sid, NULL);
105 return sid_check_is_wellknown_domain(&dom_sid, NULL);
108 /**************************************************************************
109 Looks up a known username from one of the known domains.
110 ***************************************************************************/
112 bool lookup_wellknown_sid(TALLOC_CTX *mem_ctx, const struct dom_sid *sid,
113 const char **domain, const char **name)
115 int i;
116 struct dom_sid dom_sid;
117 uint32_t rid;
118 const struct rid_name_map *users = NULL;
120 sid_copy(&dom_sid, sid);
121 if (!sid_split_rid(&dom_sid, &rid)) {
122 DEBUG(2, ("Could not split rid from SID\n"));
123 return False;
126 for (i=0; special_domains[i].sid != NULL; i++) {
127 if (dom_sid_equal(&dom_sid, special_domains[i].sid)) {
128 *domain = talloc_strdup(mem_ctx,
129 special_domains[i].name);
130 users = special_domains[i].known_users;
131 break;
135 if (users == NULL) {
136 DEBUG(10, ("SID %s is no special sid\n", sid_string_dbg(sid)));
137 return False;
140 for (i=0; users[i].name != NULL; i++) {
141 if (rid == users[i].rid) {
142 *name = talloc_strdup(mem_ctx, users[i].name);
143 return True;
147 DEBUG(10, ("RID of special SID %s not found\n", sid_string_dbg(sid)));
149 return False;
152 /**************************************************************************
153 Try and map a name to one of the well known SIDs.
154 ***************************************************************************/
156 bool lookup_wellknown_name(TALLOC_CTX *mem_ctx, const char *name,
157 struct dom_sid *sid, const char **pdomain)
159 int i, j;
160 const char *domain = *pdomain;
162 DEBUG(10,("map_name_to_wellknown_sid: looking up %s\\%s\n", domain, name));
164 for (i=0; special_domains[i].sid != NULL; i++) {
165 const struct rid_name_map *users =
166 special_domains[i].known_users;
168 if (domain[0] != '\0') {
169 if (!strequal(domain, special_domains[i].name)) {
170 continue;
174 if (users == NULL)
175 continue;
177 for (j=0; users[j].name != NULL; j++) {
178 if ( strequal(users[j].name, name) ) {
179 sid_compose(sid, special_domains[i].sid,
180 users[j].rid);
181 *pdomain = talloc_strdup(
182 mem_ctx, special_domains[i].name);
183 return True;
188 return False;