sddl 0.0.19

a library to parse and analyse SDDL Strings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use std::fmt::Display;

use binrw::binrw;
use getset::Getters;

use super::Sid;

/// <https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-sid_identifier_authority>
#[binrw]
#[derive(Eq, PartialEq, Getters, Clone, Copy, Hash)]
#[getset(get = "pub")]
pub struct IdentifierAuthority {
    value: [u8; 6],
}

impl Display for IdentifierAuthority {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let bytes = [
            0u8,
            0u8,
            self.value()[0],
            self.value()[1],
            self.value()[2],
            self.value()[3],
            self.value()[4],
            self.value()[5],
        ];
        u64::from_be_bytes(bytes).fmt(f)
    }
}

macro_rules! predefined_authority {
    ($name: ident, $value: expr) => {
        #[allow(unused)]
        pub const $name: crate::IdentifierAuthority = crate::IdentifierAuthority {
            value: [0, 0, 0, 0, 0, $value],
        };
    };
}

pub mod constants {
    predefined_authority!(SECURITY_NULL_SID_AUTHORITY, 0);
    predefined_authority!(SECURITY_WORLD_SID_AUTHORITY, 1);
    predefined_authority!(SECURITY_LOCAL_SID_AUTHORITY, 2);
    predefined_authority!(SECURITY_CREATOR_SID_AUTHORITY, 3);
    predefined_authority!(SECURITY_NON_UNIQUE_AUTHORITY, 4);
    predefined_authority!(SECURITY_NT_AUTHORITY, 5);
    predefined_authority!(SECURITY_SITE_SERVER_AUTHORITY, 6);
    predefined_authority!(SECURITY_INTERNET_SITE_AUTHORITY, 7);
    predefined_authority!(SECURITY_EXCHANGE_AUTHORITY, 8);
    predefined_authority!(SECURITY_RESOURCE_MANAGER_AUTHORITY, 9);
    predefined_authority!(APPLICATION_PACKAGE_AUTHORITY, 15);
    predefined_authority!(MANDATORY_LABEL_AUTHORITY, 16);
    predefined_authority!(AUTHENTICATION_AUTHORITY, 18);
}

impl IdentifierAuthority {
    pub fn is_well_known(&self) -> bool {
        self.value[0..5] == [0, 0, 0, 0, 0] && (0..=9).contains(&self.value[5])
    }

    pub const fn from(value: u8) -> Self {
        Self {
            value: [0, 0, 0, 0, 0, value],
        }
    }

    pub fn new_sid(&self, rid: &[u32]) -> Sid {
        Sid::new(*self, rid)
    } 
}

impl From<[u8; 6]> for IdentifierAuthority {
    fn from(value: [u8; 6]) -> Self {
        Self { value }
    }
}