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 #define PRIVPREFIX "PRIV_"
40 static bool get_privileges( const DOM_SID *sid, SE_PRIV *mask )
42 TDB_CONTEXT *tdb = get_account_pol_tdb();
46 /* Fail if the admin has not enable privileges */
48 if ( !lp_enable_privileges() ) {
55 /* PRIV_<SID> (NULL terminated) as the key */
57 fstr_sprintf( keystr, "%s%s", PRIVPREFIX, sid_string_static(sid) );
59 data = tdb_fetch_bystring( tdb, keystr );
62 DEBUG(3, ("get_privileges: No privileges assigned to SID "
63 "[%s]\n", sid_string_dbg(sid)));
67 SMB_ASSERT( data.dsize == sizeof( SE_PRIV ) );
69 se_priv_copy( mask, (SE_PRIV*)data.dptr );
75 /***************************************************************************
76 Store the privilege mask (set) for a given SID
77 ****************************************************************************/
79 static bool set_privileges( const DOM_SID *sid, SE_PRIV *mask )
81 TDB_CONTEXT *tdb = get_account_pol_tdb();
85 if ( !lp_enable_privileges() )
91 if ( !sid || (sid->num_auths == 0) ) {
92 DEBUG(0,("set_privileges: Refusing to store empty SID!\n"));
96 /* PRIV_<SID> (NULL terminated) as the key */
98 fstr_sprintf( keystr, "%s%s", PRIVPREFIX, sid_string_static(sid) );
100 /* no packing. static size structure, just write it out */
102 data.dptr = (uint8 *)mask;
103 data.dsize = sizeof(SE_PRIV);
105 return ( tdb_store_bystring(tdb, keystr, data, TDB_REPLACE) != -1 );
108 /*********************************************************************
109 get a list of all privileges for all sids in the list
110 *********************************************************************/
112 bool get_privileges_for_sids(SE_PRIV *privileges, DOM_SID *slist, int scount)
118 se_priv_copy( privileges, &se_priv_none );
120 for ( i=0; i<scount; i++ ) {
121 /* don't add unless we actually have a privilege assigned */
123 if ( !get_privileges( &slist[i], &mask ) )
126 DEBUG(5,("get_privileges_for_sids: sid = %s\nPrivilege "
127 "set:\n", sid_string_dbg(&slist[i])));
128 dump_se_priv( DBGC_ALL, 5, &mask );
130 se_priv_add( privileges, &mask );
138 /*********************************************************************
139 travseral functions for privilege_enumerate_accounts
140 *********************************************************************/
142 static int priv_traverse_fn(TDB_CONTEXT *t, TDB_DATA key, TDB_DATA data, void *state)
144 PRIV_SID_LIST *priv = (PRIV_SID_LIST *)state;
145 int prefixlen = strlen(PRIVPREFIX);
149 /* easy check first */
151 if ( data.dsize != sizeof(SE_PRIV) )
154 /* check we have a PRIV_+SID entry */
156 if ( strncmp((const char *)key.dptr, PRIVPREFIX, prefixlen) != 0)
159 /* check to see if we are looking for a particular privilege */
161 if ( !se_priv_equal(&priv->privilege, &se_priv_none) ) {
164 se_priv_copy( &mask, (SE_PRIV*)data.dptr );
166 /* if the SID does not have the specified privilege
169 if ( !is_privilege_assigned( &mask, &priv->privilege) )
173 fstrcpy( sid_string, (const char *)&key.dptr[strlen(PRIVPREFIX)] );
175 /* this is a last ditch safety check to preventing returning
176 and invalid SID (i've somehow run into this on development branches) */
178 if ( strcmp( "S-0-0", sid_string ) == 0 )
181 if ( !string_to_sid(&sid, sid_string) ) {
182 DEBUG(0,("travsersal_fn_enum__acct: Could not convert SID [%s]\n",
187 if (!add_sid_to_array( priv->mem_ctx, &sid, &priv->sids.list,
188 &priv->sids.count )) {
195 /*********************************************************************
196 Retreive list of privileged SIDs (for _lsa_enumerate_accounts()
197 *********************************************************************/
199 NTSTATUS privilege_enumerate_accounts(DOM_SID **sids, int *num_sids)
201 TDB_CONTEXT *tdb = get_account_pol_tdb();
205 return NT_STATUS_ACCESS_DENIED;
210 se_priv_copy( &priv.privilege, &se_priv_none );
212 tdb_traverse( tdb, priv_traverse_fn, &priv);
214 /* give the memory away; caller will free */
216 *sids = priv.sids.list;
217 *num_sids = priv.sids.count;
222 /*********************************************************************
223 Retrieve list of SIDs granted a particular privilege
224 *********************************************************************/
226 NTSTATUS privilege_enum_sids(const SE_PRIV *mask, TALLOC_CTX *mem_ctx,
227 DOM_SID **sids, int *num_sids)
229 TDB_CONTEXT *tdb = get_account_pol_tdb();
233 return NT_STATUS_ACCESS_DENIED;
238 se_priv_copy(&priv.privilege, mask);
239 priv.mem_ctx = mem_ctx;
241 tdb_traverse( tdb, priv_traverse_fn, &priv);
243 /* give the memory away; caller will free */
245 *sids = priv.sids.list;
246 *num_sids = priv.sids.count;
251 /***************************************************************************
253 ****************************************************************************/
255 bool grant_privilege(const DOM_SID *sid, const SE_PRIV *priv_mask)
257 SE_PRIV old_mask, new_mask;
259 ZERO_STRUCT( old_mask );
260 ZERO_STRUCT( new_mask );
262 if ( get_privileges( sid, &old_mask ) )
263 se_priv_copy( &new_mask, &old_mask );
265 se_priv_copy( &new_mask, &se_priv_none );
267 se_priv_add( &new_mask, priv_mask );
269 DEBUG(10,("grant_privilege: %s\n", sid_string_dbg(sid)));
271 DEBUGADD( 10, ("original privilege mask:\n"));
272 dump_se_priv( DBGC_ALL, 10, &old_mask );
274 DEBUGADD( 10, ("new privilege mask:\n"));
275 dump_se_priv( DBGC_ALL, 10, &new_mask );
277 return set_privileges( sid, &new_mask );
280 /*********************************************************************
281 Add a privilege based on its name
282 *********************************************************************/
284 bool grant_privilege_by_name(DOM_SID *sid, const char *name)
288 if (! se_priv_from_name(name, &mask)) {
289 DEBUG(3, ("grant_privilege_by_name: "
290 "No Such Privilege Found (%s)\n", name));
294 return grant_privilege( sid, &mask );
297 /***************************************************************************
298 Remove privilege from sid
299 ****************************************************************************/
301 bool revoke_privilege(const DOM_SID *sid, const SE_PRIV *priv_mask)
305 /* if the user has no privileges, then we can't revoke any */
307 if ( !get_privileges( sid, &mask ) )
310 DEBUG(10,("revoke_privilege: %s\n", sid_string_dbg(sid)));
312 DEBUGADD( 10, ("original privilege mask:\n"));
313 dump_se_priv( DBGC_ALL, 10, &mask );
315 se_priv_remove( &mask, priv_mask );
317 DEBUGADD( 10, ("new privilege mask:\n"));
318 dump_se_priv( DBGC_ALL, 10, &mask );
320 return set_privileges( sid, &mask );
323 /*********************************************************************
324 Revoke all privileges
325 *********************************************************************/
327 bool revoke_all_privileges( DOM_SID *sid )
329 return revoke_privilege( sid, &se_priv_all );
332 /*********************************************************************
333 Add a privilege based on its name
334 *********************************************************************/
336 bool revoke_privilege_by_name(DOM_SID *sid, const char *name)
340 if (! se_priv_from_name(name, &mask)) {
341 DEBUG(3, ("revoke_privilege_by_name: "
342 "No Such Privilege Found (%s)\n", name));
346 return revoke_privilege(sid, &mask);
350 /***************************************************************************
351 Retrieve the SIDs assigned to a given privilege
352 ****************************************************************************/
354 NTSTATUS privilege_create_account(const DOM_SID *sid )
356 return ( grant_privilege(sid, &se_priv_none) ? NT_STATUS_OK : NT_STATUS_UNSUCCESSFUL);
359 /****************************************************************************
360 initialise a privilege list and set the talloc context
361 ****************************************************************************/
363 NTSTATUS privilege_set_init(PRIVILEGE_SET *priv_set)
367 ZERO_STRUCTP( priv_set );
369 mem_ctx = talloc_init("privilege set");
371 DEBUG(0,("privilege_set_init: failed to initialize talloc ctx!\n"));
372 return NT_STATUS_NO_MEMORY;
375 priv_set->mem_ctx = mem_ctx;
380 /****************************************************************************
381 initialise a privilege list and with someone else's talloc context
382 ****************************************************************************/
384 NTSTATUS privilege_set_init_by_ctx(TALLOC_CTX *mem_ctx, PRIVILEGE_SET *priv_set)
386 ZERO_STRUCTP( priv_set );
388 priv_set->mem_ctx = mem_ctx;
389 priv_set->ext_ctx = True;
394 /****************************************************************************
395 Free all memory used by a PRIVILEGE_SET
396 ****************************************************************************/
398 void privilege_set_free(PRIVILEGE_SET *priv_set)
403 if ( !( priv_set->ext_ctx ) )
404 talloc_destroy( priv_set->mem_ctx );
406 ZERO_STRUCTP( priv_set );
409 /****************************************************************************
410 duplicate alloc luid_attr
411 ****************************************************************************/
413 NTSTATUS dup_luid_attr(TALLOC_CTX *mem_ctx, LUID_ATTR **new_la, LUID_ATTR *old_la, int count)
421 *new_la = TALLOC_ARRAY(mem_ctx, LUID_ATTR, count);
423 DEBUG(0,("dup_luid_attr: failed to alloc new LUID_ATTR array [%d]\n", count));
424 return NT_STATUS_NO_MEMORY;
430 for (i=0; i<count; i++) {
431 (*new_la)[i].luid.high = old_la[i].luid.high;
432 (*new_la)[i].luid.low = old_la[i].luid.low;
433 (*new_la)[i].attr = old_la[i].attr;
439 /*******************************************************************
440 *******************************************************************/
442 bool is_privileged_sid( const DOM_SID *sid )
446 return get_privileges( sid, &mask );
449 /*******************************************************************
450 *******************************************************************/
452 bool grant_all_privileges( const DOM_SID *sid )
456 if (!se_priv_put_all_privileges(&mask)) {
460 return grant_privilege( sid, &mask );