guise 0.1.2

Canonical browser fingerprint bundles, human-behavior timing, and TLS profile re-exports for the Santh fleet
Documentation
//! TLS and HTTP/2 fingerprint targets for browser-shaped transports.
//!
//! WAFs can classify the TLS ClientHello and HTTP/2 SETTINGS frame before
//! any JavaScript runs. This catalogue records the target strings that Santh
//! clients use when selecting or validating a browser-shaped transport.

use serde::{Deserialize, Serialize};

/// One vendor-shaped TLS and HTTP/2 fingerprint target.
///
/// The four fingerprint fields are published string formats. Consumers match
/// on whichever representation their probe or upstream WAF reports.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct FingerprintTarget {
    /// Stable lowercase label for the target profile.
    pub label: &'static str,
    /// JA3 fingerprint string: TLS version, ciphers, extensions, groups, and
    /// EC point formats.
    pub ja3: &'static str,
    /// JA4 fingerprint string.
    pub ja4: &'static str,
    /// Akamai HTTP/2 fingerprint string in
    /// `settings|window_update|priority|headers` form.
    pub akamai_h2: &'static str,
    /// Peet HTTP/2 fingerprint hash.
    pub peet_h2: &'static str,
}

/// Bundled browser TLS and HTTP/2 fingerprint targets.
///
/// Adding a target is compatible. Removing or changing a label is a breaking
/// contract change for callers that persist profile names.
pub const FINGERPRINT_TARGETS: &[FingerprintTarget] = &[
    FingerprintTarget {
        label: "chrome-130-win",
        ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,29-23-24,0",
        ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
        akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
        peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
    },
    FingerprintTarget {
        label: "chrome-130-mac",
        ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,29-23-24,0",
        ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
        akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
        peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
    },
    FingerprintTarget {
        label: "firefox-131-linux",
        ja3: "771,4865-4867-4866-49195-49199-52393-52392-49196-49200-49162-49161-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-34-51-43-13-45-28-65037,29-23-24-25-256-257,0",
        ja4: "t13d1717h2_5b57614c22b0_3d5424432f57",
        akamai_h2: "1:65536;4:131072;5:16384|12517377|3:0:0:201|m,p,a,s",
        peet_h2: "5e6b2c9f4a1d8c3b7e9a4f2d6c8b1e3a",
    },
    FingerprintTarget {
        label: "chrome-131-win-pq",
        ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,4588-29-23-24,0",
        ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
        akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
        peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
    },
    FingerprintTarget {
        label: "safari-17-mac",
        ja3: "771,4865-4867-4866-49196-49200-52393-52392-49195-49199-49188-49192-49162-49172-49187-49191-49161-49171-156-157-61-60-53-47-49160-49170-10,0-65281-10-11-13-16-23-43-45-51,29-23-24-25,0",
        ja4: "t13d1715h2_5b57614c22b0_eedb19c98e96",
        akamai_h2: "2:0;4:4194304;3:100|10485760|0|m,s,p,a",
        peet_h2: "9c2a4d8b6e1f5a3c7d9b2e4f6a8c1d3e",
    },
];

/// Look up the canonical fingerprint target for `label`.
///
/// Returns `None` when `label` is not one of the bundled target labels.
///
/// # Example
///
/// ```rust
/// use guise::fingerprint::tls_targets::lookup;
///
/// let target = lookup("chrome-130-win").expect("chrome-130-win must ship");
/// assert!(target.ja3.starts_with("771,"));
/// assert!(!target.ja4.is_empty());
/// ```
#[must_use]
pub fn lookup(label: &str) -> Option<&'static FingerprintTarget> {
    FINGERPRINT_TARGETS.iter().find(|t| t.label == label)
}

/// Return every bundled target label in declaration order.
#[must_use]
pub fn all_labels() -> Vec<&'static str> {
    FINGERPRINT_TARGETS.iter().map(|t| t.label).collect()
}

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

    #[test]
    fn ships_at_least_four_targets() {
        assert!(
            FINGERPRINT_TARGETS.len() >= 4,
            "fingerprint catalogue regressed below the 4-target baseline"
        );
    }

    #[test]
    fn every_label_resolves_via_lookup() {
        for target in FINGERPRINT_TARGETS {
            let resolved = lookup(target.label).expect("label must round-trip");
            assert_eq!(resolved, target);
        }
    }

    #[test]
    fn lookup_returns_none_for_unknown_label() {
        assert!(lookup("internet-explorer-6").is_none());
        assert!(lookup("").is_none());
        assert!(
            lookup("CHROME-130-WIN").is_none(),
            "lookup is case-sensitive"
        );
    }

    #[test]
    fn every_target_has_non_empty_fields() {
        for target in FINGERPRINT_TARGETS {
            assert!(!target.label.is_empty(), "target label empty");
            assert!(!target.ja3.is_empty(), "{}: empty JA3", target.label);
            assert!(!target.ja4.is_empty(), "{}: empty JA4", target.label);
            assert!(
                !target.akamai_h2.is_empty(),
                "{}: empty akamai_h2",
                target.label
            );
            assert!(
                !target.peet_h2.is_empty(),
                "{}: empty peet_h2",
                target.label
            );
        }
    }

    #[test]
    fn all_labels_lists_every_target_in_order() {
        let labels = all_labels();
        assert_eq!(labels.len(), FINGERPRINT_TARGETS.len());
        for (index, target) in FINGERPRINT_TARGETS.iter().enumerate() {
            assert_eq!(labels[index], target.label);
        }
    }

    #[test]
    fn ja3_format_starts_with_tls_version_771() {
        for target in FINGERPRINT_TARGETS {
            assert!(
                target.ja3.starts_with("771,"),
                "{}: JA3 must start with 771, got {}",
                target.label,
                &target.ja3[..target.ja3.len().min(20)]
            );
        }
    }

    #[test]
    fn ja4_format_starts_with_t13d_for_tls_13_targets() {
        for target in FINGERPRINT_TARGETS {
            assert!(
                target.ja4.starts_with("t13d"),
                "{}: JA4 must start with t13d, got {}",
                target.label,
                &target.ja4[..target.ja4.len().min(8)]
            );
        }
    }

    #[test]
    fn akamai_h2_has_pipe_separated_four_part_format() {
        for target in FINGERPRINT_TARGETS {
            let parts: Vec<&str> = target.akamai_h2.split('|').collect();
            assert_eq!(
                parts.len(),
                4,
                "{}: akamai_h2 must have 4 pipe-separated parts, got {}",
                target.label,
                parts.len()
            );
        }
    }
}