
Un sandbox di rete deterministico per testare le regole di nftables. Utilizza namespace di rete Linux effimeri (netns) e Scapy per validare in modo sicuro la logica del firewall.
Perché NSE? • Il contratto dell'oracolo • Asserzioni sul filo • Funzionalità • Requisiti • Installazione • Avvio rapido • Come funziona • Struttura del progetto
Testare i ruleset dei firewall su un sistema Linux attivo comporta rischi significativi: regole malformate possono interrompere le sessioni SSH di gestione, far trapelare traffico in chiaro durante i test o lasciare tabelle del firewall orfane attive sull'host.
Network Sandbox Engine (NSE) fornisce un harness di test sicuro e riproducibile. Costruisce network namespace Linux effimeri, collega coppie di ethernet virtuali, compila ruleset nftables e inietta pacchetti sintetici di Livello 2 e Livello 3 usando Scapy. Tutta la valutazione avviene all'interno del namespace sandbox: lo stato del firewall dell'host non viene mai alterato.
Proprietà architetturali chiave:
nse_<uuid>) e vengono completamente rimossi durante il teardown.nse/ conta circa 1200 istruzioni con una copertura dei test del 98%.NSE crea network namespace, carica ruleset nftables e legge gli eventi di traccia del kernel, quindi viene eseguito come root. Non apre socket, porte o endpoint RPC di alcun tipo — è una libreria e una CLI che invochi tu, e mantiene i privilegi solo per la durata di un'esecuzione.
La versione 2.1.0 ha rimosso l'interfaccia web FastAPI/Svelte distribuita dalle release precedenti. Quell'interfaccia girava in-process come root a partire dalla 2.0.0, il che costituiva una vasta superficie d'attacco per uno strumento di test; il codice rimane nella cronologia git al tag v2.0.0 se ne hai bisogno.
Un test del firewall è un'asserzione negativa — "questo pacchetto non è passato" — e un'asserzione negativa non vale nulla se non si sa che lo strumento funziona. Un monitor di traccia che non si è mai agganciato al kernel e un firewall che ha bloccato tutto producono un output identico byte per byte.
NSE pertanto rifiuta di riportare un verdetto che non può dimostrare di aver misurato:
| Garanzia | Meccanismo |
|---|---|
| Il monitor era collegato prima del primo pacchetto di test | Viene iniettato un canary di prontezza e reiniettato finché non viene osservata la sua traccia nel kernel. Nessuna osservazione, nessuna esecuzione. |
| Il monitor era ancora collegato dopo l'ultimo | Un canary di vitalità viene eseguito dopo l'iniezione. Se viene mancato, il flusso dei verdetti viene dichiarato troncato. |
| Il parser ha compreso ciò che il kernel ha detto | Le righe di traccia che non corrispondono ad alcun pattern vengono conteggiate, e qualsiasi conteggio superiore a zero è un errore anziché un log di debug. |
| Il monitor non è morto silenziosamente | Il ciclo di lettura registra perché è terminato — arresto pulito, EOF inatteso, timeout o crash — e solo un arresto pulito è accettabile. |
| Un verdetto mancante non è un superamento | Il runner CLI fallisce quando il numero di verdetti osservati differisce da quello atteso, in entrambe le direzioni. |
I pacchetti canary sono esclusi dai risultati tramite trace id, quindi non compaiono mai nel tuo flusso dei verdetti.
La suite dimostra che ciò vale, anziché affermarlo: make test-blind forza
il parser a non comprendere nulla, e la build fallisce a meno che il runner non termini
con codice diverso da zero. Quel job viene eseguito in CI a ogni push.
nft monitor trace riporta ciò che il ruleset ha deciso. Non può riportare ciò che
ha lasciato un'interfaccia su cui il ruleset non ha mai fatto match, che è la domanda che una
rivendicazione di zero-leak effettivamente pone. PCAPAsserter copre questo: un wrapper
AsyncSniffer che cattura su un'interfaccia denominata e restituisce i frame, così un test
può verificare che uno stimolo non abbia prodotto nulla.
from nse import PCAPAsserter
asserter = PCAPAsserter(iface="veth-host")
await asserter.start()
# ... send the stimulus ...
leaked = await asserter.stop()
assert not leaked, leaked
La stessa regola dell'oracolo di trace si applica, ed è responsabilità del chiamante farla rispettare: un sniffer che non si è mai agganciato e un firewall che ha bloccato tutto restituiscono entrambi una lista vuota. Cattura lo stimolo una volta con il ruleset svuotato e richiedi che il frame sia visto prima di affermarne l'assenza.
Il filtro predefinito sopprime il rumore link-local, e nient'altro.
DEFAULT_FILTER esclude ARP e i tipi ICMPv6 133-137 - Neighbour Discovery,
che trasporta un hop limit di 255 e non può raggiungere un osservatore remoto. Tutto
il resto viene catturato, incluso l'echo ICMPv6 verso un indirizzo globalmente routable. Un
argomento filter viene combinato con quel default; replace_default_filter=True
usa solo il tuo. La via di fuga esiste perché il filtro è compilato in
BPF ed eseguito nel kernel: un pacchetto che esclude non raggiunge mai lo userspace,
quindi nessun consumatore può recuperarlo a valle. Fino alla 2.1.2 il default recitava not arp and not icmp6, che scartava anche l'ICMPv6 routable - vedi
issue #14.