huginn-net-http 2.0.0

HTTP fingerprinting (p0f-style) analysis for huginn-net
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

pub mod common;
#[cfg(feature = "p0f-request")]
pub mod request;
#[cfg(feature = "p0f-response")]
pub mod response;

#[cfg(feature = "json")]
pub(crate) fn serialize_display<T: std::fmt::Display, S: serde::Serializer>(
    val: &T,
    s: S,
) -> Result<S::Ok, S::Error> {
    s.serialize_str(&val.to_string())
}

pub use common::*;
#[cfg(feature = "p0f-request")]
pub use request::*;
#[cfg(feature = "p0f-response")]
pub use response::*;

/// Result of analyzing HTTP packets, mirrors the database-agnostic shape of
/// `HuginnNetHttp::analyze_*`.
///
/// Field availability depends on the enabled HTTP features:
/// - [`Self::http_request`] requires the `p0f-request` feature.
/// - [`Self::http_response`] requires the `p0f-response` feature.
///
/// Use [`Self::empty`] to construct a fallback value that is valid under any
/// feature combination.
#[derive(Debug)]
#[cfg_attr(feature = "json", derive(serde::Serialize))]
pub struct HttpAnalysisResult {
    /// Information derived from HTTP request packets.
    #[cfg(feature = "p0f-request")]
    pub http_request: Option<HttpRequestOutput>,
    /// Information derived from HTTP response packets.
    #[cfg(feature = "p0f-response")]
    pub http_response: Option<HttpResponseOutput>,
}

impl HttpAnalysisResult {
    #[must_use]
    pub const fn empty() -> Self {
        Self {
            #[cfg(feature = "p0f-request")]
            http_request: None,
            #[cfg(feature = "p0f-response")]
            http_response: None,
        }
    }

    #[must_use]
    pub fn is_empty(&self) -> bool {
        #[cfg(feature = "p0f-request")]
        if self.http_request.is_some() {
            return false;
        }
        #[cfg(feature = "p0f-response")]
        if self.http_response.is_some() {
            return false;
        }
        true
    }
}