guard/tests/traffic_intel.rs
loki5512344 bcae8901c6
fix: never ban a trusted proxy network from any ban source
The gateway already refused to ban addresses from proxy_protocol.trusted_cidrs,
but the traffic-intelligence auto-ban and the subnet monitor still did, so a
trusted load balancer living inside a banned /24 (or below the reputation
threshold) could be knocked out together with its clients.

- TrustedProxyCidr moved to src/config/trusted.rs (the edge section file hit
  the 250-line gate) and gained `overlaps_prefix`: a ban is suppressed when the
  banned prefix intersects a trusted network.
- TrafficHook::with_trusted suppresses reputation and offender bans; its ban()
  now reports whether the ban was installed so `ban_offenders` counts real
  bans.
- The subnet monitor takes a MonitorSetup bundle (spawn had 8 arguments) and
  suppresses both userspace CIDR bans and XDP prefix bans that overlap a
  trusted network, logging a warning instead.
- IPv4-mapped addresses are normalised in `contains` too.
- Tests: overlap maths (v4/v6, /0 rejected), tracker suppression vs unrelated
  networks, and auto-ban skipping a trusted range while still banning public
  offenders.
2026-11-16 13:03:50 +01:00

478 lines
12 KiB
Rust

//! Integration tests for Traffic Intelligence on the hot path: EWMA sanity,
//! attack detection across a sustained flood, reputation decay/eviction and
//! auto-ban driven by reputation.
use rampart::config::DetectAutobanConfig;
use rampart::filter::blacklist::Blacklist;
use rampart::traffic::alert::AlertDispatcher;
use rampart::traffic::detector::{AttackDetector, AttackStatus, DetectorThresholds};
use rampart::traffic::ewma::Ewma;
use rampart::traffic::hook::TrafficHook;
use rampart::traffic::reputation::{IpReputation, ReputationPolicy};
use std::net::{IpAddr, Ipv4Addr, Ipv6Addr};
use std::sync::Arc;
use std::time::Duration;
fn ip(octets: [u8; 4]) -> IpAddr {
IpAddr::V4(Ipv4Addr::from(octets))
}
fn autoban_cfg(enabled: bool) -> DetectAutobanConfig {
DetectAutobanConfig {
enabled,
reputation_threshold: -50,
}
}
fn quiet(detector: &mut AttackDetector) {
for _ in 0..12 {
detector.analyze(500.0, 50.0);
}
}
// EWMA
#[test]
fn ewma_starts_at_zero() {
assert_eq!(Ewma::new(0.125).value(), 0.0);
}
#[test]
fn ewma_alpha_one_follows_the_sample() {
let mut ewma = Ewma::new(1.0);
ewma.update(100.0);
assert!((ewma.value() - 100.0).abs() < 1.0);
}
#[test]
fn ewma_converges_to_a_constant_sample() {
let mut ewma = Ewma::new(0.5);
for _ in 0..10 {
ewma.update(50.0);
}
assert!((ewma.value() - 50.0).abs() < 1.0);
}
#[test]
fn ewma_falls_back_on_invalid_alpha() {
for alpha in [f64::NAN, f64::INFINITY, 0.0, -0.5] {
let mut ewma = Ewma::new(alpha);
ewma.update(100.0);
assert!(ewma.value().is_finite(), "alpha={alpha} must keep the average finite");
assert!(
ewma.value() > 0.0 && ewma.value() < 100.0,
"alpha={alpha} must fall back to the default smoothing"
);
}
}
#[test]
fn ewma_seed_primes_the_baseline() {
let mut ewma = Ewma::new(0.01);
ewma.seed(500.0);
assert_eq!(ewma.value(), 500.0, "a seeded baseline starts at the observed value");
ewma.update(500.0);
assert_eq!(ewma.value(), 500.0);
assert!(!ewma.value().is_nan());
}
#[test]
fn ewma_ignores_non_finite_samples() {
let mut ewma = Ewma::new(0.5);
ewma.update(10.0);
let before = ewma.value();
ewma.update(f64::NAN);
ewma.update(f64::INFINITY);
assert_eq!(ewma.value(), before, "non-finite samples must not move the average");
}
// Attack detector
#[test]
fn attack_detector_reports_normal_traffic() {
let mut detector = AttackDetector::new();
quiet(&mut detector);
assert_eq!(detector.analyze(500.0, 50.0), AttackStatus::Normal);
}
#[test]
fn attack_detector_flags_pps_spike_as_suspicious() {
let mut detector = AttackDetector::new();
for _ in 0..10 {
detector.analyze(1.0, 1.0);
}
assert_eq!(detector.analyze(5.0, 1.0), AttackStatus::Suspicious);
}
#[test]
fn attack_detector_flags_cps_spike_as_suspicious() {
let mut detector = AttackDetector::new();
for _ in 0..10 {
detector.analyze(1.0, 1.0);
}
assert_eq!(detector.analyze(1.0, 5.0), AttackStatus::Suspicious);
}
#[test]
fn attack_detector_escalates_after_three_anomalies() {
let mut detector = AttackDetector::new();
for _ in 0..10 {
detector.analyze(1.0, 1.0);
}
detector.analyze(10_000.0, 100.0);
detector.analyze(10_000.0, 100.0);
assert_eq!(detector.analyze(10_000.0, 100.0), AttackStatus::UnderAttack);
}
#[test]
fn attack_detector_resets_on_a_normal_window() {
let mut detector = AttackDetector::new();
for _ in 0..10 {
detector.analyze(1.0, 1.0);
}
detector.analyze(100.0, 10.0);
detector.analyze(100.0, 10.0);
detector.analyze(1.0, 1.0);
assert_eq!(detector.analyze(1.0, 1.0), AttackStatus::Normal);
}
#[test]
fn detector_flags_synthetic_traffic_spike() {
let mut detector = AttackDetector::new();
// Baseline: a quiet profile.
for _ in 0..12 {
detector.analyze(500.0, 50.0);
}
// Synthetic spike: 200x pps and cps for three consecutive windows.
assert_eq!(
detector.analyze(100_000.0, 10_000.0),
AttackStatus::Suspicious,
"first anomalous window is suspicious"
);
assert_eq!(detector.analyze(100_000.0, 10_000.0), AttackStatus::Suspicious);
assert_eq!(
detector.analyze(100_000.0, 10_000.0),
AttackStatus::UnderAttack,
"three anomalous windows in a row must escalate to UnderAttack"
);
}
#[test]
fn sustained_flood_stays_under_attack_and_keeps_banning_offenders() {
let reputation = Arc::new(IpReputation::new());
let blacklist = Arc::new(Blacklist::new());
let hook = TrafficHook::new(Arc::clone(&reputation), Arc::clone(&blacklist), autoban_cfg(true), 60);
let mut detector = AttackDetector::new();
quiet(&mut detector);
for tick in 0..10u8 {
let status = detector.analyze(100_000.0, 10_000.0);
if tick < 2 {
assert_eq!(status, AttackStatus::Suspicious, "flood tick {tick}");
} else {
assert_eq!(
status,
AttackStatus::UnderAttack,
"flood tick {tick}: the detector must not learn the attack as normal"
);
}
// A fresh offender joins on every tick of the attack. The edge keeps
// banning them only while the detector stays in UnderAttack.
let offender = ip([203, 0, 113, tick + 1]);
for _ in 0..6 {
reputation.record_bad(offender);
}
assert!(hook.ban_offenders() >= 1, "flood tick {tick} must produce a ban");
assert!(
blacklist.is_blocked(offender),
"flood tick {tick}: offender must be banned"
);
}
}
#[test]
fn under_attack_exits_only_after_the_recovery_window() {
let mut detector = AttackDetector::new();
quiet(&mut detector);
for _ in 0..3 {
detector.analyze(100_000.0, 10_000.0);
}
assert_eq!(detector.analyze(100_000.0, 10_000.0), AttackStatus::UnderAttack);
// Four calm windows are not enough: the exit hysteresis is five ticks.
for tick in 0..4 {
assert_eq!(
detector.analyze(500.0, 50.0),
AttackStatus::UnderAttack,
"calm tick {tick} must not end the attack"
);
}
assert_eq!(
detector.analyze(500.0, 50.0),
AttackStatus::Normal,
"the fifth calm tick ends the attack"
);
}
#[test]
fn detector_thresholds_are_configurable() {
let thresholds = DetectorThresholds {
suspicious_score: 1.5,
attack_score: 2.0,
escalate_after: 1,
recover_after: 2,
};
let mut detector = AttackDetector::with_thresholds(thresholds);
for _ in 0..10 {
detector.analyze(100.0, 10.0);
}
assert_eq!(
detector.analyze(1_000.0, 100.0),
AttackStatus::UnderAttack,
"escalate_after = 1 must escalate on the first anomalous window"
);
assert_eq!(detector.analyze(100.0, 10.0), AttackStatus::UnderAttack);
assert_ne!(
detector.analyze(100.0, 10.0),
AttackStatus::UnderAttack,
"recover_after = 2 must end the attack"
);
}
// Reputation
#[test]
fn reputation_initial_score_is_neutral() {
let rep = IpReputation::new();
assert_eq!(rep.score(ip([192, 168, 1, 1])), 0);
}
#[test]
fn reputation_good_and_bad_steps() {
let rep = IpReputation::new();
let good = ip([10, 0, 0, 1]);
let bad = ip([10, 0, 0, 2]);
rep.record_good(good);
rep.record_bad(bad);
assert_eq!(rep.score(good), 1);
assert_eq!(rep.score(bad), -10);
}
#[test]
fn reputation_scores_are_clamped() {
let rep = IpReputation::new();
let good = ip([10, 0, 0, 3]);
let bad = ip([10, 0, 0, 4]);
for _ in 0..200 {
rep.record_good(good);
}
for _ in 0..20 {
rep.record_bad(bad);
}
assert_eq!(rep.score(good), 100);
assert_eq!(rep.score(bad), -100);
}
#[test]
fn reputation_trusts_after_enough_good_connections() {
let rep = IpReputation::new();
let ip = ip([10, 0, 0, 5]);
assert!(!rep.is_trusted(ip));
for _ in 0..51 {
rep.record_good(ip);
}
assert!(rep.is_trusted(ip));
}
#[test]
fn reputation_tracks_ipv6() {
let rep = IpReputation::new();
let ip = IpAddr::V6(Ipv6Addr::LOCALHOST);
rep.record_bad(ip);
assert_eq!(rep.score(ip), -10);
}
#[test]
fn reputation_decays_toward_neutral() {
let policy = ReputationPolicy {
idle_ttl: Duration::from_secs(10),
decay_half_life: Duration::from_millis(20),
max_offenders: 64,
};
let rep = IpReputation::with_policy(policy);
let bad = ip([10, 0, 0, 6]);
for _ in 0..20 {
rep.record_bad(bad);
}
assert_eq!(rep.score(bad), -100);
std::thread::sleep(Duration::from_millis(40));
let decayed = rep.score(bad);
assert!(
decayed > -100 && decayed < 0,
"two half-lives must move the score toward neutral, got {decayed}"
);
}
#[test]
fn reputation_sweep_evicts_idle_and_keeps_active() {
let policy = ReputationPolicy {
idle_ttl: Duration::from_millis(20),
decay_half_life: Duration::from_secs(1800),
max_offenders: 64,
};
let rep = IpReputation::with_policy(policy);
let idle = ip([10, 0, 0, 7]);
let active = ip([10, 0, 0, 8]);
rep.record_bad(idle);
rep.record_bad(active);
std::thread::sleep(Duration::from_millis(40));
rep.record_bad(active);
for _ in 0..8 {
rep.sweep();
}
assert_eq!(rep.len(), 1, "only the idle source may be evicted");
assert_eq!(rep.score(idle), 0, "evicted source is neutral again");
assert!(rep.score(active) < 0, "active source keeps its score");
}
#[test]
fn offenders_are_capped_per_cycle() {
let policy = ReputationPolicy {
idle_ttl: Duration::from_secs(600),
decay_half_life: Duration::from_secs(1800),
max_offenders: 3,
};
let rep = IpReputation::with_policy(policy);
for last in 1..=20u8 {
let source = ip([198, 51, 100, last]);
for _ in 0..6 {
rep.record_bad(source);
}
}
assert_eq!(
rep.offenders_below(-50).len(),
3,
"one cycle must not return the whole offender table"
);
}
#[test]
fn offenders_below_returns_worst_sources() {
let rep = IpReputation::new();
let bad = ip([10, 0, 0, 1]);
let good = ip([10, 0, 0, 2]);
for _ in 0..6 {
rep.record_bad(bad);
}
rep.record_good(good);
assert_eq!(rep.offenders_below(-50), vec![bad]);
}
#[test]
fn offenders_below_is_empty_without_offenders() {
let rep = IpReputation::new();
assert!(rep.offenders_below(-50).is_empty());
}
// Traffic hook auto-ban
#[test]
fn reputation_fall_after_drops_triggers_autoban() {
let reputation = Arc::new(IpReputation::new());
let blacklist = Arc::new(Blacklist::new());
let hook = TrafficHook::new(Arc::clone(&reputation), Arc::clone(&blacklist), autoban_cfg(true), 60);
let attacker = ip([198, 51, 100, 7]);
for _ in 0..6 {
// Six drops through the rate limiter: -10 each, auto-ban threshold is -50.
reputation.record_bad(attacker);
hook.on_connection_end(attacker);
}
assert!(
reputation.score(attacker) <= -50,
"reputation must fall below threshold"
);
assert!(
blacklist.is_blocked(attacker),
"auto-ban must fire after repeated drops"
);
}
#[test]
fn autoban_ttl_expires_ban() {
let reputation = Arc::new(IpReputation::new());
let blacklist = Arc::new(Blacklist::new());
let hook = TrafficHook::new(
Arc::clone(&reputation),
Arc::clone(&blacklist),
autoban_cfg(true),
// Zero TTL taken from the config as a time mock.
0,
);
let attacker = ip([198, 51, 100, 8]);
for _ in 0..20 {
reputation.record_bad(attacker);
}
hook.on_connection_end(attacker);
std::thread::sleep(Duration::from_millis(5));
assert!(
!blacklist.is_blocked(attacker),
"zero TTL must not produce an active ban"
);
}
#[test]
fn alerts_fire_only_on_state_transitions() {
let dispatcher = AlertDispatcher::new();
let sequence = [
AttackStatus::Normal,
AttackStatus::Normal,
AttackStatus::Suspicious,
AttackStatus::UnderAttack,
AttackStatus::UnderAttack,
AttackStatus::UnderAttack,
AttackStatus::Suspicious,
AttackStatus::Normal,
AttackStatus::Normal,
];
let alerts: Vec<_> = sequence.iter().filter_map(|s| dispatcher.on_status(*s)).collect();
assert_eq!(alerts.len(), 2, "two transitions must yield exactly two alerts");
assert!(alerts[0].message.contains("attack started"));
assert!(alerts[1].message.contains("attack ended"));
}
#[test]
fn auto_ban_never_targets_a_trusted_proxy_network() {
let reputation = Arc::new(IpReputation::new());
let blacklist = Arc::new(Blacklist::new());
let trusted: Vec<rampart::config::TrustedProxyCidr> = vec!["10.0.0.0/8".parse().expect("trusted cidr")];
let hook =
TrafficHook::new(Arc::clone(&reputation), Arc::clone(&blacklist), autoban_cfg(true), 60).with_trusted(trusted);
let inside = ip([10, 1, 2, 3]);
for _ in 0..6 {
reputation.record_bad(inside);
hook.on_connection_end(inside);
}
assert!(
reputation.score(inside) <= -50,
"reputation must fall below the threshold"
);
assert_eq!(hook.ban_offenders(), 0, "trusted addresses are never banned");
let public = ip([198, 51, 100, 9]);
for _ in 0..6 {
reputation.record_bad(public);
hook.on_connection_end(public);
}
assert!(
blacklist.is_blocked(public),
"non-trusted offenders are still banned by the reputation path"
);
}