pub struct ProtectedBlob {
pub key_identifier: KeyIdentifier,
pub encrypted_key: Vec<u8>,
pub key_wrap_oid: String,
pub content_cipher_oid: String,
pub nonce: Vec<u8>,
pub tag_len: usize,
pub encrypted_content: Vec<u8>,
}Expand description
A parsed DPAPI-NG blob, ready to decrypt once the KEK is known.
Fields§
§key_identifier: KeyIdentifierWhich KDS root key and tree node the content key was wrapped for.
encrypted_key: Vec<u8>The content-encryption key, AES-wrapped under the KEK.
key_wrap_oid: StringOID of the key-wrap algorithm (expected OID_AES256_WRAP).
content_cipher_oid: StringOID of the content cipher (expected OID_AES256_GCM).
nonce: Vec<u8>GCM nonce for the content cipher.
tag_len: usizeAuthentication-tag length in bytes, as declared in the GCM parameters.
encrypted_content: Vec<u8>Ciphertext, tag appended (as CMS stores it).
Implementations§
Source§impl ProtectedBlob
impl ProtectedBlob
Sourcepub fn parse(b: &[u8]) -> Result<ProtectedBlob>
pub fn parse(b: &[u8]) -> Result<ProtectedBlob>
Parse a DPAPI-NG blob — the raw bytes of msLAPS-EncryptedPassword (minus its
16-byte header) or of a gMSA/dMSA protected password.
Examples found in repository?
examples/inspect_blob.rs (line 54)
16fn main() -> ExitCode {
17 let args: Vec<String> = std::env::args().skip(1).collect();
18 let raw_mode = args.iter().any(|a| a == "--raw");
19 let Some(path) = args.iter().find(|a| !a.starts_with("--")) else {
20 eprintln!("usage: inspect_blob [--raw] <blob.bin>");
21 return ExitCode::FAILURE;
22 };
23
24 let bytes = match std::fs::read(path) {
25 Ok(b) => b,
26 Err(e) => {
27 eprintln!("cannot read {path}: {e}");
28 return ExitCode::FAILURE;
29 }
30 };
31
32 let blob_bytes = if raw_mode {
33 bytes
34 } else {
35 match LapsBlob::parse(&bytes) {
36 Ok(l) => {
37 println!(
38 "LAPS header: updated {} (FILETIME {}), {} byte blob",
39 filetime_to_iso(l.update_timestamp),
40 l.update_timestamp,
41 l.blob.len()
42 );
43 l.blob
44 }
45 Err(e) => {
46 eprintln!(
47 "not a LAPS attribute value ({e}); retry with --raw if this is a bare CMS blob"
48 );
49 return ExitCode::FAILURE;
50 }
51 }
52 };
53
54 let blob = match ProtectedBlob::parse(&blob_bytes) {
55 Ok(b) => b,
56 Err(e) => {
57 eprintln!("CMS parse failed: {e}");
58 return ExitCode::FAILURE;
59 }
60 };
61
62 let id = &blob.key_identifier;
63 println!("key identifier");
64 println!(" version {}", id.version);
65 println!(
66 " flags {:#010x}{}",
67 id.flags,
68 if id.is_public_key() {
69 " (public key)"
70 } else {
71 ""
72 }
73 );
74 println!(" root key {}", id.root_key_id);
75 println!(
76 " tree node L0 {} · L1 {} · L2 {}",
77 id.l0, id.l1, id.l2
78 );
79 println!(" kdf {} ", id.kdf_algorithm);
80 match id.hash() {
81 Ok(h) => println!(" kdf hash {}", h.name()),
82 Err(e) => println!(" kdf hash UNPARSED: {e}"),
83 }
84 println!(" secret algorithm {}", id.secret_algorithm);
85 println!(
86 " private/public len {} / {}",
87 id.private_key_length, id.public_key_length
88 );
89 println!(
90 " domain / forest {} / {}",
91 id.domain_name, id.forest_name
92 );
93 println!("content");
94 println!(" key wrap {}", blob.key_wrap_oid);
95 println!(" content cipher {}", blob.content_cipher_oid);
96 println!(
97 " nonce {} ({} bytes)",
98 hex(&blob.nonce),
99 blob.nonce.len()
100 );
101 println!(" tag length {}", blob.tag_len);
102 println!(" wrapped key {} bytes", blob.encrypted_key.len());
103 println!(
104 " ciphertext {} bytes",
105 blob.encrypted_content.len()
106 );
107 println!(
108 "\nTo decrypt: ask a DC for root key {} at L0 {} (MS-GKDI GetKey), then\n\
109 GroupKeyEnvelope::parse(response) and dpapi_ng::decrypt(&blob, &envelope).",
110 id.root_key_id, id.l0
111 );
112
113 ExitCode::SUCCESS
114}Trait Implementations§
Source§impl Clone for ProtectedBlob
impl Clone for ProtectedBlob
Source§fn clone(&self) -> ProtectedBlob
fn clone(&self) -> ProtectedBlob
Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moreAuto Trait Implementations§
impl Freeze for ProtectedBlob
impl RefUnwindSafe for ProtectedBlob
impl Send for ProtectedBlob
impl Sync for ProtectedBlob
impl Unpin for ProtectedBlob
impl UnsafeUnpin for ProtectedBlob
impl UnwindSafe for ProtectedBlob
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more