2 Unix SMB/CIFS implementation.
3 Privileges handling functions
4 Copyright (C) Jean François Micouleau 1998-2001
5 Copyright (C) Simo Sorce 2002-2003
6 Copyright (C) Gerald (Jerry) Carter 2005
7 Copyright (C) Michael Adam 2007
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/>.
26 #include "libcli/security/privileges_private.h"
27 #include "../libcli/security/security.h"
30 #define PRIVPREFIX "PRIV_"
44 interpret an old style SE_PRIV structure
46 static uint64_t map_old_SE_PRIV(unsigned char *dptr)
48 uint32_t *old_masks = (uint32_t *)dptr;
50 * the old privileges code only ever used up to 0x800, except
51 * for a special case of 'SE_ALL_PRIVS' which was 0xFFFFFFFF
53 if (old_masks[0] == 0xFFFFFFFF) {
54 /* they set all privileges */
58 /* the old code used the machine byte order, but we don't know
59 * the byte order of the machine that wrote it. However we can
60 * tell what byte order it was by taking advantage of the fact
61 * that it only ever use up to 0x800
63 if (dptr[0] || dptr[1]) {
64 /* it was little endian */
68 /* it was either zero or big-endian */
69 return RIVAL(dptr, 0);
73 static bool get_privileges( const struct dom_sid *sid, uint64_t *mask )
75 struct db_context *db = get_account_pol_db();
79 /* Fail if the admin has not enable privileges */
81 if ( !lp_enable_privileges() ) {
88 /* PRIV_<SID> (NULL terminated) as the key */
90 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
92 data = dbwrap_fetch_bystring( db, talloc_tos(), keystr );
95 DEBUG(4, ("get_privileges: No privileges assigned to SID "
96 "[%s]\n", sid_string_dbg(sid)));
100 if (data.dsize == 4*4) {
101 /* it's an old style SE_PRIV structure. */
102 *mask = map_old_SE_PRIV(data.dptr);
104 if (data.dsize != sizeof( uint64_t ) ) {
105 DEBUG(3, ("get_privileges: Invalid privileges record assigned to SID "
106 "[%s]\n", sid_string_dbg(sid)));
110 *mask = BVAL(data.dptr, 0);
113 TALLOC_FREE(data.dptr);
118 /***************************************************************************
119 Store the privilege mask (set) for a given SID
120 ****************************************************************************/
122 static bool set_privileges( const struct dom_sid *sid, uint64_t mask )
124 struct db_context *db = get_account_pol_db();
129 if ( !lp_enable_privileges() )
135 if ( !sid || (sid->num_auths == 0) ) {
136 DEBUG(0,("set_privileges: Refusing to store empty SID!\n"));
140 /* PRIV_<SID> (NULL terminated) as the key */
142 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
144 /* This writes the 64 bit bitmask out in little endian format */
145 SBVAL(privbuf,0,mask);
148 data.dsize = sizeof(privbuf);
150 return NT_STATUS_IS_OK(dbwrap_store_bystring(db, keystr, data,
154 /*********************************************************************
155 get a list of all privileges for all sids in the list
156 *********************************************************************/
158 bool get_privileges_for_sids(uint64_t *privileges, struct dom_sid *slist, int scount)
166 for ( i=0; i<scount; i++ ) {
167 /* don't add unless we actually have a privilege assigned */
169 if ( !get_privileges( &slist[i], &mask ) )
172 DEBUG(5,("get_privileges_for_sids: sid = %s\nPrivilege "
173 "set: 0x%llx\n", sid_string_dbg(&slist[i]),
174 (unsigned long long)mask));
183 NTSTATUS get_privileges_for_sid_as_set(TALLOC_CTX *mem_ctx, PRIVILEGE_SET **privileges, struct dom_sid *sid)
186 if (!get_privileges(sid, &mask)) {
187 return NT_STATUS_OBJECT_NAME_NOT_FOUND;
190 *privileges = talloc_zero(mem_ctx, PRIVILEGE_SET);
192 return NT_STATUS_NO_MEMORY;
195 if (!se_priv_to_privilege_set(*privileges, mask)) {
196 return NT_STATUS_NO_MEMORY;
201 /*********************************************************************
202 traversal functions for privilege_enumerate_accounts
203 *********************************************************************/
205 static int priv_traverse_fn(struct db_record *rec, void *state)
207 PRIV_SID_LIST *priv = (PRIV_SID_LIST *)state;
208 int prefixlen = strlen(PRIVPREFIX);
212 /* check we have a PRIV_+SID entry */
214 if ( strncmp((char *)rec->key.dptr, PRIVPREFIX, prefixlen) != 0)
217 /* check to see if we are looking for a particular privilege */
219 fstrcpy( sid_string, (char *)&(rec->key.dptr[strlen(PRIVPREFIX)]) );
221 if (priv->privilege != 0) {
224 if (rec->value.dsize == 4*4) {
225 mask = map_old_SE_PRIV(rec->value.dptr);
227 if (rec->value.dsize != sizeof( uint64_t ) ) {
228 DEBUG(3, ("get_privileges: Invalid privileges record assigned to SID "
229 "[%s]\n", sid_string));
232 mask = BVAL(rec->value.dptr, 0);
235 /* if the SID does not have the specified privilege
238 if ((mask & priv->privilege) == 0) {
243 /* this is a last ditch safety check to preventing returning
244 and invalid SID (i've somehow run into this on development branches) */
246 if ( strcmp( "S-0-0", sid_string ) == 0 )
249 if ( !string_to_sid(&sid, sid_string) ) {
250 DEBUG(0,("travsersal_fn_enum__acct: Could not convert SID [%s]\n",
255 if (!NT_STATUS_IS_OK(add_sid_to_array(priv->mem_ctx, &sid,
265 /*********************************************************************
266 Retreive list of privileged SIDs (for _lsa_enumerate_accounts()
267 *********************************************************************/
269 NTSTATUS privilege_enumerate_accounts(struct dom_sid **sids, int *num_sids)
271 struct db_context *db = get_account_pol_db();
275 return NT_STATUS_ACCESS_DENIED;
280 db->traverse_read(db, priv_traverse_fn, &priv);
282 /* give the memory away; caller will free */
284 *sids = priv.sids.list;
285 *num_sids = priv.sids.count;
290 /*********************************************************************
291 Retrieve list of SIDs granted a particular privilege
292 *********************************************************************/
294 NTSTATUS privilege_enum_sids(enum sec_privilege privilege, TALLOC_CTX *mem_ctx,
295 struct dom_sid **sids, int *num_sids)
297 struct db_context *db = get_account_pol_db();
301 return NT_STATUS_ACCESS_DENIED;
306 priv.privilege = sec_privilege_mask(privilege);
307 priv.mem_ctx = mem_ctx;
309 db->traverse_read(db, priv_traverse_fn, &priv);
311 /* give the memory away; caller will free */
313 *sids = priv.sids.list;
314 *num_sids = priv.sids.count;
319 /***************************************************************************
321 ****************************************************************************/
323 static bool grant_privilege_bitmap(const struct dom_sid *sid, const uint64_t priv_mask)
325 uint64_t old_mask, new_mask;
327 ZERO_STRUCT( old_mask );
328 ZERO_STRUCT( new_mask );
330 if ( get_privileges( sid, &old_mask ) )
335 new_mask |= priv_mask;
337 DEBUG(10,("grant_privilege: %s\n", sid_string_dbg(sid)));
339 DEBUGADD( 10, ("original privilege mask: 0x%llx\n", (unsigned long long)new_mask));
341 DEBUGADD( 10, ("new privilege mask: 0x%llx\n", (unsigned long long)new_mask));
343 return set_privileges( sid, new_mask );
346 /*********************************************************************
347 Add a privilege based on its name
348 *********************************************************************/
350 bool grant_privilege_by_name(const struct dom_sid *sid, const char *name)
354 if (! se_priv_from_name(name, &mask)) {
355 DEBUG(3, ("grant_privilege_by_name: "
356 "No Such Privilege Found (%s)\n", name));
360 return grant_privilege_bitmap( sid, mask );
363 /***************************************************************************
364 Grant a privilege set (list of LUID values) from a sid
365 ****************************************************************************/
367 bool grant_privilege_set(const struct dom_sid *sid, struct lsa_PrivilegeSet *set)
369 uint64_t privilege_mask;
370 if (!privilege_set_to_se_priv(&privilege_mask, set)) {
373 return grant_privilege_bitmap(sid, privilege_mask);
376 /***************************************************************************
377 Remove privilege from sid
378 ****************************************************************************/
380 static bool revoke_privilege_bitmap(const struct dom_sid *sid, const uint64_t priv_mask)
384 /* if the user has no privileges, then we can't revoke any */
386 if ( !get_privileges( sid, &mask ) )
389 DEBUG(10,("revoke_privilege: %s\n", sid_string_dbg(sid)));
391 DEBUGADD( 10, ("original privilege mask: 0x%llx\n", (unsigned long long)mask));
395 DEBUGADD( 10, ("new privilege mask: 0x%llx\n", (unsigned long long)mask));
397 return set_privileges( sid, mask );
400 /***************************************************************************
401 Remove a privilege set (list of LUID values) from a sid
402 ****************************************************************************/
404 bool revoke_privilege_set(const struct dom_sid *sid, struct lsa_PrivilegeSet *set)
406 uint64_t privilege_mask;
407 if (!privilege_set_to_se_priv(&privilege_mask, set)) {
410 return revoke_privilege_bitmap(sid, privilege_mask);
413 /*********************************************************************
414 Revoke all privileges
415 *********************************************************************/
417 bool revoke_all_privileges( const struct dom_sid *sid )
419 return revoke_privilege_bitmap( sid, SE_ALL_PRIVS);
422 /*********************************************************************
423 Add a privilege based on its name
424 *********************************************************************/
426 bool revoke_privilege_by_name(const struct dom_sid *sid, const char *name)
430 if (! se_priv_from_name(name, &mask)) {
431 DEBUG(3, ("revoke_privilege_by_name: "
432 "No Such Privilege Found (%s)\n", name));
436 return revoke_privilege_bitmap(sid, mask);
440 /***************************************************************************
441 Retrieve the SIDs assigned to a given privilege
442 ****************************************************************************/
444 NTSTATUS privilege_create_account(const struct dom_sid *sid )
446 return ( grant_privilege_bitmap(sid, 0) ? NT_STATUS_OK : NT_STATUS_UNSUCCESSFUL);
449 /***************************************************************************
450 Delete a privileged account
451 ****************************************************************************/
453 NTSTATUS privilege_delete_account(const struct dom_sid *sid)
455 struct db_context *db = get_account_pol_db();
458 if (!lp_enable_privileges()) {
463 return NT_STATUS_INVALID_HANDLE;
466 if (!sid || (sid->num_auths == 0)) {
467 return NT_STATUS_INVALID_SID;
470 /* PRIV_<SID> (NULL terminated) as the key */
472 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
474 return dbwrap_delete_bystring(db, keystr);
477 /*******************************************************************
478 *******************************************************************/
480 bool is_privileged_sid( const struct dom_sid *sid )
484 return get_privileges( sid, &mask );
487 /*******************************************************************
488 *******************************************************************/
490 bool grant_all_privileges( const struct dom_sid *sid )
494 se_priv_put_all_privileges(&mask);
496 return grant_privilege_bitmap( sid, mask );