DaLaw2 7e7d47f94c feat(soar): seed fusion-era default playbooks
Day 1 DB now ships with two playbooks that exercise the Fusion v1
condition vocabulary so a fresh install demonstrates multi-source
agreement out of the box instead of requiring the operator to author a
MultiSourceMin / SingleSourceHigh playbook before anything blocks.

Both target `c2_beacon` — the canonical attack type where fusion carries
the highest marginal value (Suricata trojan-activity + Beaconing CV +
ML c2 class can all independently fire on the same C2 channel):

- `fusion_c2_multi_source_block` — Condition: MultiSourceMin >= 2.
  Actions: block_ip 3600s + telegram + log. Requires agreement from
  two independent detection sources before blocking.
- `fusion_c2_suricata_solo_high_block` — Condition: SingleSourceHigh
  for Suricata with min_confidence 0.95. Actions: block_ip 3600s +
  telegram + log. Escape hatch for high-certainty signature hits
  that shouldn't wait for a second source.

Idempotent via the existing "seed only when playbooks table is empty"
guard in `seed_default_playbooks`.

Note: the pre-existing `default_block` (trigger "threat_detected")
never matches any fused event — canonicalization in the orchestrator
rewrites attack_type to one of the 13 canonical values before SOAR
sees it. That cleanup is separate; this commit only adds the fusion
defaults.

clippy --package net-guardia -- -D warnings clean. 219 pass.

Closes A-region F-5 seed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-18 17:21:06 +08:00

NetGuardia

Project Overview

NetGuardia is a high-performance network security solution that combines eBPF XDP technology with deep learning models to provide advanced network protection. The system operates as a standalone network appliance that can run on any Ubuntu-based system with compatible network hardware.

Core Technologies

  • eBPF XDP Technology - Provides high-performance packet processing directly at the data link layer
  • Deep Learning Models - Identifies and predicts potential network attacks with intelligent threat detection
  • Hardware Integration - Designed to work with Intel i350 T2 and similar enterprise-grade network interface cards

Functional Modules

Resource Overview

Home

  • Real-time control system occupancy rate

Dashboard Overview

Dashboard

  • Real-time network traffic monitoring and visualization
  • Recent traffic statistics and trend analysis

Detailed Traffic Statistics

Statistics

  • Detailed traffic usage information per IP address

Network Access Control

accessControl

  • IPv4/IPv6 whitelist and blacklist management
  • Precise port-level access control

System Features

  • High Performance - Low-latency packet processing with minimal network performance impact
  • User-Friendly - Cross-platform web management interface with intuitive operation
  • Reliability - Hardware-accelerated processing ensures stable operation
  • Scalability - Modular design supports functional expansion

System Requirements

NetGuardia requires the combination of a kernel with eBPF support and a NIC driver that implements AF_XDP on that kernel. There is no single "minimum kernel version" — it depends on which NIC driver you use.

  • Linux with eBPF + AF_XDP support for your NIC driver. Any modern distribution (Ubuntu 22.04+, Debian 12+, RHEL 9+, Fedora recent) is fine as long as the driver matrix below lines up.
  • Dual-port NIC with an AF_XDP-capable driver (see matrix).
  • Root / sudo access for eBPF program loading.

NIC driver / kernel matrix (AF_XDP)

Driver NIC family (examples) Min kernel for AF_XDP
mlx5 Mellanox ConnectX-4/5/6/7 5.x (early)
ixgbe Intel 82599, X520, X540, X550 5.x
i40e Intel X710, XL710, XXV710 5.x
ice Intel E810 5.5+
igb Intel i350 T2 (reference hardware) 6.17
igc Intel I225/I226 6.x
virtio_net QEMU/KVM virtual NICs varies; AF_XDP is limited

If you are using the reference Intel i350 T2, you need Linux 6.17 or newer because igb AF_XDP support landed in that release. On a kernel older than 6.17 the system will still build, but ingress/egress setup will fail at runtime when AF_XDP binding is attempted — check driver support with ethtool -i <iface> and confirm against the matrix above before deploying.

Hardware Compatibility

  • Network Interface: dual-port NIC with an AF_XDP-capable driver on your kernel (see matrix above). Intel i350 T2 is the reference hardware.
  • CPU: multi-core recommended; XDP scales with RX queue count.
  • Memory: 8 GB minimum, 16 GB+ for high-traffic environments.

NetGuardia is not limited to embedded platforms — it runs on standard server hardware, virtual machines, or dedicated appliances as long as the driver/kernel requirement above is met.

Description
NetGuardia is a network defense system that integrates eBPF XDP and deep learning models
Readme 121 MiB
Languages
Rust 96.7%
Shell 2.9%
HCL 0.4%