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/>.
25 #include "lib/privileges.h"
26 #include "dbwrap/dbwrap.h"
27 #include "libcli/security/privileges_private.h"
28 #include "../libcli/security/security.h"
30 #include "lib/util/string_wrappers.h"
32 #define PRIVPREFIX "PRIV_"
46 interpret an old style SE_PRIV structure
48 static uint64_t map_old_SE_PRIV(unsigned char *dptr
)
50 uint32_t *old_masks
= (uint32_t *)dptr
;
52 * the old privileges code only ever used up to 0x800, except
53 * for a special case of 'SE_ALL_PRIVS' which was 0xFFFFFFFF
55 if (old_masks
[0] == 0xFFFFFFFF) {
56 /* they set all privileges */
60 /* the old code used the machine byte order, but we don't know
61 * the byte order of the machine that wrote it. However we can
62 * tell what byte order it was by taking advantage of the fact
63 * that it only ever use up to 0x800
65 if (dptr
[0] || dptr
[1]) {
66 /* it was little endian */
70 /* it was either zero or big-endian */
71 return RIVAL(dptr
, 0);
75 static bool get_privileges( const struct dom_sid
*sid
, uint64_t *mask
)
77 struct db_context
*db
= get_account_pol_db();
78 struct dom_sid_buf tmp
;
83 /* Fail if the admin has not enable privileges */
85 if ( !lp_enable_privileges() ) {
92 /* PRIV_<SID> (NULL terminated) as the key */
94 fstr_sprintf(keystr
, "%s%s", PRIVPREFIX
, dom_sid_str_buf(sid
, &tmp
));
96 status
= dbwrap_fetch_bystring(db
, talloc_tos(), keystr
, &data
);
98 if (!NT_STATUS_IS_OK(status
)) {
99 DEBUG(4, ("get_privileges: No privileges assigned to SID "
104 if (data
.dsize
== 4*4) {
105 /* it's an old style SE_PRIV structure. */
106 *mask
= map_old_SE_PRIV(data
.dptr
);
108 if (data
.dsize
!= sizeof( uint64_t ) ) {
109 DEBUG(3, ("get_privileges: Invalid privileges record assigned to SID "
114 *mask
= BVAL(data
.dptr
, 0);
117 TALLOC_FREE(data
.dptr
);
122 /***************************************************************************
123 Store the privilege mask (set) for a given SID
124 ****************************************************************************/
126 static bool set_privileges( const struct dom_sid
*sid
, uint64_t mask
)
128 struct db_context
*db
= get_account_pol_db();
130 struct dom_sid_buf tmp
;
132 TDB_DATA data
= { .dptr
= privbuf
, .dsize
= sizeof(privbuf
), };
134 if ( !lp_enable_privileges() )
140 if ( !sid
|| (sid
->num_auths
== 0) ) {
141 DEBUG(0,("set_privileges: Refusing to store empty SID!\n"));
145 /* PRIV_<SID> (NULL terminated) as the key */
147 fstr_sprintf(keystr
, "%s%s", PRIVPREFIX
, dom_sid_str_buf(sid
, &tmp
));
149 /* This writes the 64 bit bitmask out in little endian format */
150 SBVAL(privbuf
,0,mask
);
152 return NT_STATUS_IS_OK(dbwrap_store_bystring(db
, keystr
, data
,
156 /*********************************************************************
157 get a list of all privileges for all sids in the list
158 *********************************************************************/
160 bool get_privileges_for_sids(uint64_t *privileges
, struct dom_sid
*slist
, int scount
)
168 for ( i
=0; i
<scount
; i
++ ) {
169 struct dom_sid_buf buf
;
171 /* don't add unless we actually have a privilege assigned */
173 if ( !get_privileges( &slist
[i
], &mask
) )
176 DBG_INFO("sid = %s\nPrivilege set: 0x%"PRIx64
"\n",
177 dom_sid_str_buf(&slist
[i
], &buf
),
187 NTSTATUS
get_privileges_for_sid_as_set(TALLOC_CTX
*mem_ctx
, PRIVILEGE_SET
**privileges
, struct dom_sid
*sid
)
190 if (!get_privileges(sid
, &mask
)) {
191 return NT_STATUS_OBJECT_NAME_NOT_FOUND
;
194 *privileges
= talloc_zero(mem_ctx
, PRIVILEGE_SET
);
196 return NT_STATUS_NO_MEMORY
;
199 if (!se_priv_to_privilege_set(*privileges
, mask
)) {
200 return NT_STATUS_NO_MEMORY
;
205 /*********************************************************************
206 traversal functions for privilege_enumerate_accounts
207 *********************************************************************/
209 static int priv_traverse_fn(struct db_record
*rec
, void *state
)
211 PRIV_SID_LIST
*priv
= (PRIV_SID_LIST
*)state
;
212 int prefixlen
= strlen(PRIVPREFIX
);
217 key
= dbwrap_record_get_key(rec
);
219 /* check we have a PRIV_+SID entry */
221 if (strncmp((char *)key
.dptr
, PRIVPREFIX
, prefixlen
) != 0)
224 /* check to see if we are looking for a particular privilege */
226 fstrcpy( sid_string
, (char *)&(key
.dptr
[strlen(PRIVPREFIX
)]) );
228 if (priv
->privilege
!= 0) {
232 value
= dbwrap_record_get_value(rec
);
234 if (value
.dsize
== 4*4) {
235 mask
= map_old_SE_PRIV(value
.dptr
);
237 if (value
.dsize
!= sizeof( uint64_t ) ) {
238 DEBUG(3, ("get_privileges: Invalid privileges record assigned to SID "
239 "[%s]\n", sid_string
));
242 mask
= BVAL(value
.dptr
, 0);
245 /* if the SID does not have the specified privilege
248 if ((mask
& priv
->privilege
) == 0) {
253 /* this is a last ditch safety check to preventing returning
254 and invalid SID (i've somehow run into this on development branches) */
256 if ( strcmp( "S-0-0", sid_string
) == 0 )
259 if ( !string_to_sid(&sid
, sid_string
) ) {
260 DBG_WARNING("Could not convert SID [%s]\n", sid_string
);
264 if (!NT_STATUS_IS_OK(add_sid_to_array(priv
->mem_ctx
, &sid
,
274 /*********************************************************************
275 Retrieve list of privileged SIDs (for _lsa_enumerate_accounts()
276 *********************************************************************/
278 NTSTATUS
privilege_enumerate_accounts(struct dom_sid
**sids
, int *num_sids
)
280 struct db_context
*db
= get_account_pol_db();
285 return NT_STATUS_ACCESS_DENIED
;
290 status
= dbwrap_traverse_read(db
, priv_traverse_fn
, &priv
, NULL
);
291 if (!NT_STATUS_IS_OK(status
)) {
295 /* give the memory away; caller will free */
297 *sids
= priv
.sids
.list
;
298 *num_sids
= priv
.sids
.count
;
303 /*********************************************************************
304 Retrieve list of SIDs granted a particular privilege
305 *********************************************************************/
307 NTSTATUS
privilege_enum_sids(enum sec_privilege privilege
, TALLOC_CTX
*mem_ctx
,
308 struct dom_sid
**sids
, int *num_sids
)
310 struct db_context
*db
= get_account_pol_db();
315 return NT_STATUS_ACCESS_DENIED
;
320 priv
.privilege
= sec_privilege_mask(privilege
);
321 priv
.mem_ctx
= mem_ctx
;
323 status
= dbwrap_traverse_read(db
, priv_traverse_fn
, &priv
, NULL
);
324 if (!NT_STATUS_IS_OK(status
)) {
328 /* give the memory away; caller will free */
330 *sids
= priv
.sids
.list
;
331 *num_sids
= priv
.sids
.count
;
336 /***************************************************************************
338 ****************************************************************************/
340 static bool grant_privilege_bitmap(const struct dom_sid
*sid
, const uint64_t priv_mask
)
342 uint64_t old_mask
= 0, new_mask
= 0;
343 struct dom_sid_buf buf
;
345 if ( get_privileges( sid
, &old_mask
) ) {
349 new_mask
|= priv_mask
;
352 "original privilege mask: 0x%"PRIx64
"\n"
353 "new privilege mask: 0x%"PRIx64
"\n",
354 dom_sid_str_buf(sid
, &buf
),
358 return set_privileges( sid
, new_mask
);
361 /*********************************************************************
362 Add a privilege based on its name
363 *********************************************************************/
365 bool grant_privilege_by_name(const struct dom_sid
*sid
, const char *name
)
369 if (! se_priv_from_name(name
, &mask
)) {
370 DEBUG(3, ("grant_privilege_by_name: "
371 "No Such Privilege Found (%s)\n", name
));
375 return grant_privilege_bitmap( sid
, mask
);
378 /***************************************************************************
379 Grant a privilege set (list of LUID values) from a sid
380 ****************************************************************************/
382 bool grant_privilege_set(const struct dom_sid
*sid
, struct lsa_PrivilegeSet
*set
)
384 uint64_t privilege_mask
;
385 if (!privilege_set_to_se_priv(&privilege_mask
, set
)) {
388 return grant_privilege_bitmap(sid
, privilege_mask
);
391 /***************************************************************************
392 Remove privilege from sid
393 ****************************************************************************/
395 static bool revoke_privilege_bitmap(const struct dom_sid
*sid
, const uint64_t priv_mask
)
398 struct dom_sid_buf buf
;
400 /* if the user has no privileges, then we can't revoke any */
402 if ( !get_privileges( sid
, &mask
) )
405 DEBUG(10,("revoke_privilege: %s\n", dom_sid_str_buf(sid
, &buf
)));
407 DEBUGADD( 10, ("original privilege mask: 0x%llx\n", (unsigned long long)mask
));
411 DEBUGADD( 10, ("new privilege mask: 0x%llx\n", (unsigned long long)mask
));
413 return set_privileges( sid
, mask
);
416 /***************************************************************************
417 Remove a privilege set (list of LUID values) from a sid
418 ****************************************************************************/
420 bool revoke_privilege_set(const struct dom_sid
*sid
, struct lsa_PrivilegeSet
*set
)
422 uint64_t privilege_mask
;
423 if (!privilege_set_to_se_priv(&privilege_mask
, set
)) {
426 return revoke_privilege_bitmap(sid
, privilege_mask
);
429 /*********************************************************************
430 Revoke all privileges
431 *********************************************************************/
433 bool revoke_all_privileges( const struct dom_sid
*sid
)
435 return revoke_privilege_bitmap( sid
, SE_ALL_PRIVS
);
438 /*********************************************************************
439 Add a privilege based on its name
440 *********************************************************************/
442 bool revoke_privilege_by_name(const struct dom_sid
*sid
, const char *name
)
446 if (! se_priv_from_name(name
, &mask
)) {
447 DEBUG(3, ("revoke_privilege_by_name: "
448 "No Such Privilege Found (%s)\n", name
));
452 return revoke_privilege_bitmap(sid
, mask
);
456 /***************************************************************************
457 Retrieve the SIDs assigned to a given privilege
458 ****************************************************************************/
460 NTSTATUS
privilege_create_account(const struct dom_sid
*sid
)
462 return ( grant_privilege_bitmap(sid
, 0) ? NT_STATUS_OK
: NT_STATUS_UNSUCCESSFUL
);
465 /***************************************************************************
466 Delete a privileged account
467 ****************************************************************************/
469 NTSTATUS
privilege_delete_account(const struct dom_sid
*sid
)
471 struct db_context
*db
= get_account_pol_db();
472 struct dom_sid_buf tmp
;
475 if (!lp_enable_privileges()) {
480 return NT_STATUS_INVALID_HANDLE
;
483 if (!sid
|| (sid
->num_auths
== 0)) {
484 return NT_STATUS_INVALID_SID
;
487 /* PRIV_<SID> (NULL terminated) as the key */
489 fstr_sprintf(keystr
, "%s%s", PRIVPREFIX
, dom_sid_str_buf(sid
, &tmp
));
491 return dbwrap_delete_bystring(db
, keystr
);
494 /*******************************************************************
495 *******************************************************************/
497 bool is_privileged_sid( const struct dom_sid
*sid
)
501 return get_privileges( sid
, &mask
);
504 /*******************************************************************
505 *******************************************************************/
507 bool grant_all_privileges( const struct dom_sid
*sid
)
511 se_priv_put_all_privileges(&mask
);
513 return grant_privilege_bitmap( sid
, mask
);