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/>.
27 #define PRIVPREFIX "PRIV_"
41 static bool get_privileges( const struct dom_sid *sid, uint64_t *mask )
43 struct db_context *db = get_account_pol_db();
47 /* Fail if the admin has not enable privileges */
49 if ( !lp_enable_privileges() ) {
56 /* PRIV_<SID> (NULL terminated) as the key */
58 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
60 data = dbwrap_fetch_bystring( db, talloc_tos(), keystr );
63 DEBUG(3, ("get_privileges: No privileges assigned to SID "
64 "[%s]\n", sid_string_dbg(sid)));
68 if (data.dsize == 4*4) {
69 DEBUG(3, ("get_privileges: Should not have obtained old-style privileges record for SID "
70 "[%s]\n", sid_string_dbg(sid)));
74 if (data.dsize != sizeof( uint64_t ) ) {
75 DEBUG(3, ("get_privileges: Invalid privileges record assigned to SID "
76 "[%s]\n", sid_string_dbg(sid)));
80 *mask = BVAL(data.dptr, 0);
82 TALLOC_FREE(data.dptr);
87 /***************************************************************************
88 Store the privilege mask (set) for a given SID
89 ****************************************************************************/
91 static bool set_privileges( const struct dom_sid *sid, uint64_t *mask )
93 struct db_context *db = get_account_pol_db();
98 if ( !lp_enable_privileges() )
104 if ( !sid || (sid->num_auths == 0) ) {
105 DEBUG(0,("set_privileges: Refusing to store empty SID!\n"));
109 /* PRIV_<SID> (NULL terminated) as the key */
111 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
113 /* This writes the 64 bit bitmask out in little endian format */
114 SBVAL(privbuf,0,*mask);
116 data.dptr = (uint8 *)mask;
117 data.dsize = sizeof(uint64_t);
119 return NT_STATUS_IS_OK(dbwrap_store_bystring(db, keystr, data,
123 /*********************************************************************
124 get a list of all privileges for all sids in the list
125 *********************************************************************/
127 bool get_privileges_for_sids(uint64_t *privileges, struct dom_sid *slist, int scount)
133 se_priv_copy( privileges, &se_priv_none );
135 for ( i=0; i<scount; i++ ) {
136 /* don't add unless we actually have a privilege assigned */
138 if ( !get_privileges( &slist[i], &mask ) )
141 DEBUG(5,("get_privileges_for_sids: sid = %s\nPrivilege "
142 "set:\n", sid_string_dbg(&slist[i])));
143 dump_se_priv( DBGC_ALL, 5, &mask );
145 se_priv_add( privileges, &mask );
153 /*********************************************************************
154 traversal functions for privilege_enumerate_accounts
155 *********************************************************************/
157 static int priv_traverse_fn(struct db_record *rec, void *state)
159 PRIV_SID_LIST *priv = (PRIV_SID_LIST *)state;
160 int prefixlen = strlen(PRIVPREFIX);
164 /* easy check first */
166 if (rec->value.dsize != sizeof(uint64_t) )
169 /* check we have a PRIV_+SID entry */
171 if ( strncmp((char *)rec->key.dptr, PRIVPREFIX, prefixlen) != 0)
174 /* check to see if we are looking for a particular privilege */
176 if ( !se_priv_equal(&priv->privilege, &se_priv_none) ) {
179 se_priv_copy( &mask, (uint64_t*)rec->value.dptr );
181 /* if the SID does not have the specified privilege
184 if ( !is_privilege_assigned( &mask, &priv->privilege) )
188 fstrcpy( sid_string, (char *)&(rec->key.dptr[strlen(PRIVPREFIX)]) );
190 /* this is a last ditch safety check to preventing returning
191 and invalid SID (i've somehow run into this on development branches) */
193 if ( strcmp( "S-0-0", sid_string ) == 0 )
196 if ( !string_to_sid(&sid, sid_string) ) {
197 DEBUG(0,("travsersal_fn_enum__acct: Could not convert SID [%s]\n",
202 if (!NT_STATUS_IS_OK(add_sid_to_array(priv->mem_ctx, &sid,
212 /*********************************************************************
213 Retreive list of privileged SIDs (for _lsa_enumerate_accounts()
214 *********************************************************************/
216 NTSTATUS privilege_enumerate_accounts(struct dom_sid **sids, int *num_sids)
218 struct db_context *db = get_account_pol_db();
222 return NT_STATUS_ACCESS_DENIED;
227 se_priv_copy( &priv.privilege, &se_priv_none );
229 db->traverse_read(db, priv_traverse_fn, &priv);
231 /* give the memory away; caller will free */
233 *sids = priv.sids.list;
234 *num_sids = priv.sids.count;
239 /*********************************************************************
240 Retrieve list of SIDs granted a particular privilege
241 *********************************************************************/
243 NTSTATUS privilege_enum_sids(const uint64_t *mask, TALLOC_CTX *mem_ctx,
244 struct dom_sid **sids, int *num_sids)
246 struct db_context *db = get_account_pol_db();
250 return NT_STATUS_ACCESS_DENIED;
255 se_priv_copy(&priv.privilege, mask);
256 priv.mem_ctx = mem_ctx;
258 db->traverse_read(db, priv_traverse_fn, &priv);
260 /* give the memory away; caller will free */
262 *sids = priv.sids.list;
263 *num_sids = priv.sids.count;
268 /***************************************************************************
270 ****************************************************************************/
272 bool grant_privilege(const struct dom_sid *sid, const uint64_t *priv_mask)
274 uint64_t old_mask, new_mask;
276 ZERO_STRUCT( old_mask );
277 ZERO_STRUCT( new_mask );
279 if ( get_privileges( sid, &old_mask ) )
280 se_priv_copy( &new_mask, &old_mask );
282 se_priv_copy( &new_mask, &se_priv_none );
284 se_priv_add( &new_mask, priv_mask );
286 DEBUG(10,("grant_privilege: %s\n", sid_string_dbg(sid)));
288 DEBUGADD( 10, ("original privilege mask:\n"));
289 dump_se_priv( DBGC_ALL, 10, &old_mask );
291 DEBUGADD( 10, ("new privilege mask:\n"));
292 dump_se_priv( DBGC_ALL, 10, &new_mask );
294 return set_privileges( sid, &new_mask );
297 /*********************************************************************
298 Add a privilege based on its name
299 *********************************************************************/
301 bool grant_privilege_by_name(struct dom_sid *sid, const char *name)
305 if (! se_priv_from_name(name, &mask)) {
306 DEBUG(3, ("grant_privilege_by_name: "
307 "No Such Privilege Found (%s)\n", name));
311 return grant_privilege( sid, &mask );
314 /***************************************************************************
315 Remove privilege from sid
316 ****************************************************************************/
318 bool revoke_privilege(const struct dom_sid *sid, const uint64_t *priv_mask)
322 /* if the user has no privileges, then we can't revoke any */
324 if ( !get_privileges( sid, &mask ) )
327 DEBUG(10,("revoke_privilege: %s\n", sid_string_dbg(sid)));
329 DEBUGADD( 10, ("original privilege mask:\n"));
330 dump_se_priv( DBGC_ALL, 10, &mask );
332 se_priv_remove( &mask, priv_mask );
334 DEBUGADD( 10, ("new privilege mask:\n"));
335 dump_se_priv( DBGC_ALL, 10, &mask );
337 return set_privileges( sid, &mask );
340 /*********************************************************************
341 Revoke all privileges
342 *********************************************************************/
344 bool revoke_all_privileges( struct dom_sid *sid )
346 return revoke_privilege( sid, &se_priv_all );
349 /*********************************************************************
350 Add a privilege based on its name
351 *********************************************************************/
353 bool revoke_privilege_by_name(struct dom_sid *sid, const char *name)
357 if (! se_priv_from_name(name, &mask)) {
358 DEBUG(3, ("revoke_privilege_by_name: "
359 "No Such Privilege Found (%s)\n", name));
363 return revoke_privilege(sid, &mask);
367 /***************************************************************************
368 Retrieve the SIDs assigned to a given privilege
369 ****************************************************************************/
371 NTSTATUS privilege_create_account(const struct dom_sid *sid )
373 return ( grant_privilege(sid, &se_priv_none) ? NT_STATUS_OK : NT_STATUS_UNSUCCESSFUL);
376 /***************************************************************************
377 Delete a privileged account
378 ****************************************************************************/
380 NTSTATUS privilege_delete_account(const struct dom_sid *sid)
382 struct db_context *db = get_account_pol_db();
385 if (!lp_enable_privileges()) {
390 return NT_STATUS_INVALID_HANDLE;
393 if (!sid || (sid->num_auths == 0)) {
394 return NT_STATUS_INVALID_SID;
397 /* PRIV_<SID> (NULL terminated) as the key */
399 fstr_sprintf(keystr, "%s%s", PRIVPREFIX, sid_to_fstring(tmp, sid));
401 return dbwrap_delete_bystring(db, keystr);
404 /****************************************************************************
405 initialise a privilege list and set the talloc context
406 ****************************************************************************/
408 NTSTATUS privilege_set_init(PRIVILEGE_SET *priv_set)
412 ZERO_STRUCTP( priv_set );
414 mem_ctx = talloc_init("privilege set");
416 DEBUG(0,("privilege_set_init: failed to initialize talloc ctx!\n"));
417 return NT_STATUS_NO_MEMORY;
420 priv_set->mem_ctx = mem_ctx;
425 /****************************************************************************
426 initialise a privilege list and with someone else's talloc context
427 ****************************************************************************/
429 NTSTATUS privilege_set_init_by_ctx(TALLOC_CTX *mem_ctx, PRIVILEGE_SET *priv_set)
431 ZERO_STRUCTP( priv_set );
433 priv_set->mem_ctx = mem_ctx;
434 priv_set->ext_ctx = True;
439 /****************************************************************************
440 Free all memory used by a PRIVILEGE_SET
441 ****************************************************************************/
443 void privilege_set_free(PRIVILEGE_SET *priv_set)
448 if ( !( priv_set->ext_ctx ) )
449 talloc_destroy( priv_set->mem_ctx );
451 ZERO_STRUCTP( priv_set );
454 /****************************************************************************
455 duplicate alloc luid_attr
456 ****************************************************************************/
458 NTSTATUS dup_luid_attr(TALLOC_CTX *mem_ctx, struct lsa_LUIDAttribute **new_la, struct lsa_LUIDAttribute *old_la, int count)
466 *new_la = TALLOC_ARRAY(mem_ctx, struct lsa_LUIDAttribute, count);
468 DEBUG(0,("dup_luid_attr: failed to alloc new struct lsa_LUIDAttribute array [%d]\n", count));
469 return NT_STATUS_NO_MEMORY;
475 for (i=0; i<count; i++) {
476 (*new_la)[i].luid.high = old_la[i].luid.high;
477 (*new_la)[i].luid.low = old_la[i].luid.low;
478 (*new_la)[i].attribute = old_la[i].attribute;
484 /*******************************************************************
485 *******************************************************************/
487 bool is_privileged_sid( const struct dom_sid *sid )
491 return get_privileges( sid, &mask );
494 /*******************************************************************
495 *******************************************************************/
497 bool grant_all_privileges( const struct dom_sid *sid )
501 if (!se_priv_put_all_privileges(&mask)) {
505 return grant_privilege( sid, &mask );