forensicnomicon 0.2.2

The ForensicNomicon — comprehensive DFIR artifact catalog: UserAssist, Shimcache, Amcache, Prefetch, $MFT, ShellBags, EVTX, NTDS.dit, SAM, SRUM, LNK, Jump Lists + KAPE/Velociraptor/Sigma/MITRE. Zero deps.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use crate::threat_intel::{
    profile::{MalwareClass, MalwareProfile, ProfileSignal, WeightedExclusion},
    signals::*,
};

pub static DIAMORPHINE: MalwareProfile = MalwareProfile {
    id: "diamorphine",
    family: "Diamorphine",
    aliases: &["diamorphine-rootkit"],
    description: "Compact signal-driven LKM rootkit. Signal 31 hides/shows PIDs; signal 63 toggles \
                  module visibility; signal 64 grants root. Files with DIAMORPHINE_SECRET prefix hidden. \
                  No netfilter, no network hiding, no PAM. Widely used by TeamTNT and Rocke.",
    malware_class: MalwareClass::LkmRootkit,
    mitre_techniques: &["T1215", "T1014", "T1548"],
    signals: &[
        ProfileSignal { id: SYSTEM_KERNEL_TAINT_OOT,      weight: 30, required: true  },
        ProfileSignal { id: SYSTEM_PROC_MODULES_SUSPECT,  weight: 30, required: true  },
        ProfileSignal { id: PROCESS_HIDDEN_FROM_PS,       weight: 35, required: false },
        ProfileSignal { id: TEMPORAL_ACTIVATION_SEQUENCE, weight: 25, required: false },
        ProfileSignal { id: SYSTEM_KERNEL_TAINT_FORCED,   weight: 10, required: false },
    ],
    exclusions: &[
        WeightedExclusion { id: NETWORK_MAGIC_PACKET_KNOCK, penalty: 35 },
        WeightedExclusion { id: ELF_HOOKS_PAM_CREDENTIAL,   penalty: 20 },
        WeightedExclusion { id: ELF_HOOKS_NETWORK_HIDING,   penalty: 25 },
    ],
    class_threshold:     60,
    probable_threshold:  85,
    confirmed_threshold: 105,
};

#[cfg(test)]
mod tests {
    use super::DIAMORPHINE;
    use crate::threat_intel::{
        engine::{score_against_profile, DetectedSignal},
        profile::Classification,
        signals::*,
    };

    fn sigs(ids: &[&'static str]) -> Vec<DetectedSignal> {
        ids.iter()
            .map(|&id| DetectedSignal {
                id,
                confidence: 1.0,
                evidence: String::new(),
            })
            .collect()
    }

    #[test]
    fn diamorphine_required_signals_reach_class_threshold() {
        let s = sigs(&[SYSTEM_KERNEL_TAINT_OOT, SYSTEM_PROC_MODULES_SUSPECT]);
        let m = score_against_profile(&s, &DIAMORPHINE);
        assert!(
            m.score >= DIAMORPHINE.class_threshold,
            "score {} < class_threshold {}",
            m.score,
            DIAMORPHINE.class_threshold
        );
        assert!(m.classification >= Classification::ClassMatch);
    }

    #[test]
    fn diamorphine_with_process_hidden_reaches_probable() {
        let s = sigs(&[
            SYSTEM_KERNEL_TAINT_OOT,
            SYSTEM_PROC_MODULES_SUSPECT,
            PROCESS_HIDDEN_FROM_PS,
        ]);
        let m = score_against_profile(&s, &DIAMORPHINE);
        assert!(
            m.score >= DIAMORPHINE.probable_threshold,
            "score {} < probable_threshold {}",
            m.score,
            DIAMORPHINE.probable_threshold
        );
        assert!(m.classification >= Classification::Probable);
    }

    #[test]
    fn diamorphine_full_signals_reach_confirmed() {
        let s = sigs(&[
            SYSTEM_KERNEL_TAINT_OOT,
            SYSTEM_PROC_MODULES_SUSPECT,
            PROCESS_HIDDEN_FROM_PS,
            TEMPORAL_ACTIVATION_SEQUENCE,
        ]);
        let m = score_against_profile(&s, &DIAMORPHINE);
        assert_eq!(m.classification, Classification::Confirmed);
    }

    #[test]
    fn diamorphine_magic_packet_reduces_score() {
        let base = sigs(&[
            SYSTEM_KERNEL_TAINT_OOT,
            SYSTEM_PROC_MODULES_SUSPECT,
            PROCESS_HIDDEN_FROM_PS,
        ]);
        let with_knock = sigs(&[
            SYSTEM_KERNEL_TAINT_OOT,
            SYSTEM_PROC_MODULES_SUSPECT,
            PROCESS_HIDDEN_FROM_PS,
            NETWORK_MAGIC_PACKET_KNOCK,
        ]);
        let m_base = score_against_profile(&base, &DIAMORPHINE);
        let m_knock = score_against_profile(&with_knock, &DIAMORPHINE);
        assert!(
            m_knock.score < m_base.score,
            "magic packet should penalise Diamorphine (not its style)"
        );
    }
}