mythic-c2 0.1.0

Mythic C2 agent protocol library — message encoding, AES-256-CBC-HMAC crypto, and transport abstraction
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

/// Errors that can occur during message encoding or decoding.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum MythicMessageError {
    Serialize,
    Deserialize,
    Base64Decode,
    Utf8,
    InvalidPacket,
    InvalidUuid,
    UuidMismatch,
    Crypto,
}

impl core::fmt::Display for MythicMessageError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        f.write_str(match self {
            Self::Serialize => "failed to serialize Mythic message",
            Self::Deserialize => "failed to deserialize Mythic message",
            Self::Base64Decode => "failed to decode Mythic packet from base64",
            Self::Utf8 => "failed to decode Mythic UUID as UTF-8",
            Self::InvalidPacket => "invalid Mythic packet",
            Self::InvalidUuid => "invalid Mythic UUID",
            Self::UuidMismatch => "Mythic UUID mismatch",
            Self::Crypto => "Mythic crypto operation failed",
        })
    }
}

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

    #[test]
    fn error_display_covers_all_variants() {
        let errors = [
            MythicMessageError::Serialize,
            MythicMessageError::Deserialize,
            MythicMessageError::Base64Decode,
            MythicMessageError::Utf8,
            MythicMessageError::InvalidPacket,
            MythicMessageError::InvalidUuid,
            MythicMessageError::UuidMismatch,
            MythicMessageError::Crypto,
        ];

        for error in errors {
            assert!(!error.to_string().is_empty());
        }
    }
}