guard/tests/traffic_intel.rs
loki5512344 918e561a61
feat(xdp): IPv6 UDP rate limit, working loader; English JavaDoc comments
XDP behaviour:
- udp_rate_limit6 (LRU, 128-bit source key) + throttle_hit6, so
  udp_policy = "rate-limit" now applies to native IPv6 as well.
- scripts/xdp_ipv6_smoke.sh: phase 4 patches .rodata before load and
  verifies policy=2 on a real kernel (3 pass / 3 rate-limited).

XDP loader (was completely broken, never reached the verifier):
- .rodata is now one struct rampart_config with frozen offsets enforced by
  _Static_assert; XdpGlobals is #[repr(C)] and the image is built with
  offset_of!. Previously a 96-byte image was written into a 76-byte map at
  offsets clang had reordered, so load() failed with EINVAL.
- patch_rodata fails loudly when the map size and the image size diverge.
- build.rs tracks xdp/core and xdp/hooks, not just universal_filter.c.
- build_ringbuf looked for "events_map"; the map is "events_ringbuf".
- tests/xdp_object_maps.rs: verifies map names and .rodata size without root;
  the real binary was confirmed to attach in a netns.

Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
  decorative banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, TOC and
  copy-paste quick start.
- docs/README.md: documentation index and maintenance rules;
  configuration.md documents the whole [xdp] section and IPv4/IPv6 coverage;
  testing.md describes the real-kernel smoke; stale research links removed.
2026-11-15 23:44:07 +01:00

113 lines
3.1 KiB
Rust

//! Integration tests for Traffic Intelligence on the hot path: auto-ban driven
//! by reputation, attack detection on a synthetic spike and alerts on state
//! transitions.
use rampart::config::DetectAutobanConfig;
use rampart::filter::blacklist::Blacklist;
use rampart::traffic::alert::AlertDispatcher;
use rampart::traffic::detector::{AttackDetector, AttackStatus};
use rampart::traffic::hook::TrafficHook;
use rampart::traffic::reputation::IpReputation;
use std::net::{IpAddr, Ipv4Addr};
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,
}
}
#[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 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 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"));
}