
Una piattaforma di test aperta che sonda i server HTTP/1.1 rispetto ai requisiti RFC 9110/9112, ai vettori di smuggling e alla gestione di input malformati. Aggiungi il tuo framework, ottieni automaticamente i risultati di conformità.
Http11Probe è un tester di conformità e sicurezza per server HTTP/1.1. Invia richieste malformate, ambigue e di dimensioni eccessive a un server tramite socket TCP grezzi e verifica come risponde rispetto a ciò che RFC 9110 e RFC 9112 richiedono effettivamente. Si tratta di quei casi scomodi come terminazioni di riga con LF singolo, il folding di riga obsoleto, il request smuggling CL/TE, i trucchi di framing dei chunk, header di dimensioni eccessive e byte NUL, dove un parser rigoroso e uno indulgente iniziano a divergere.
Gli stessi 215 test vengono eseguiti contro 47 server di riferimento scritti in 14 linguaggi, da Nginx, Apache ed Envoy fino a Kestrel, Gin, Actix e i server integrati in Node, Bun e Deno. Ogni risultato viene valutato rispetto alla formulazione MUST/SHOULD/MAY della specifica e contrassegnato come Pass, Fail o Warn. Un Warn significa semplicemente che l'RFC consente sia il comportamento rigoroso che quello indulgente, quindi nessuno dei due è sbagliato.
Trovi la documentazione completa, un glossario per singolo test con citazioni RFC e la matrice dei risultati live per ogni server su http-probe.com.
Il probe è indipendente dal target. Testa qualunque server HTTP/1.1 sia già in ascolto su --host:--port, e non esiste un flag per scegliere un framework. Avvia prima il server (oppure lascia che probe-local.sh ne avvii uno per te), poi punta il probe verso di esso.
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
| Flag | Descrizione | Predefinito |
|---|---|---|
--host | Nome host o indirizzo IP di destinazione | localhost |
--port | Numero di porta di destinazione | 8080 |
--category | Esegue solo i test in questa categoria (Compliance, Smuggling, MalformedInput, Normalization, Cookies, Capabilities) | tutti |
--test | Esegue solo ID di test specifici, senza distinzione tra maiuscole e minuscole (ripetibile) | tutti |
--timeout | Timeout di connessione e lettura in secondi per test | 5 |
--output | Scrive i risultati JSON su file | nessuno |
--verbose, -v | Stampa la risposta grezza del server per ogni test | disattivato |
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
Esegui test specifici:
dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
I risultati vengono trasmessi alla console man mano che ogni test viene completato, con un riepilogo alla fine:
Score: 97/97 19 warnings (146 tests, 35.5s)
La verifica invia solo richieste, non avvia i server. Per verificare uno dei server inclusi in src/Servers/, usa scripts/probe-local.sh. Fa la stessa cosa della pipeline CI: compila l'immagine Docker del server, la esegue con --network host, attende che sia attivo, lo verifica, quindi lo arresta e lo rimuove.
# Probe one server by its directory name under src/Servers/, e.g. ActixServer
scripts/probe-local.sh --server ActixServer
# Probe every bundled server
scripts/probe-local.sh --all
Il valore di --server è il nome della directory (ActixServer), non il nome visualizzato (Actix). Se il tuo demone Docker richiede i privilegi di root, aggiungi --docker-sudo per non dover eseguire l'intero script con sudo:
scripts/probe-local.sh --server ActixServer --docker-sudo
| Flag | Descrizione |
|---|---|
--server <Dir> | Verifica un singolo server tramite il nome della sua directory sotto src/Servers/ (ad es. NginxServer) |
--all | Verifica ogni server sotto src/Servers/*/probe.json |
--port <Port> | Porta di destinazione (predefinita: 8080) |
--skip-build | Salta dotnet build (presuppone che esista già una build Release) |
--verbose | Passa --verbose alla CLI |
--docker-sudo | Esegue i comandi Docker tramite sudo (consente di eseguire lo script senza sudo) |
-h, --help | Mostra l'aiuto |
Scrive probe-<ServerDir>.json (uno per server), oltre a probe-data.js e docs/static/probe/data.js per il rendering locale. Servono jq, docker, curl, python3 e l'SDK .NET 10.
probe-local.sh è solo un wrapper di comodità. Se preferisci farlo a mano, ad esempio per mantenere un server attivo durante diverse esecuzioni di verifica, compila ed esegui il container tu stesso, poi punta la verifica verso di esso. Esegui questi comandi dalla radice del repository, poiché è il contesto di build Docker:
docker build -t probe-actix -f src/Servers/ActixServer/Dockerfile .
docker run -d --name probe-target --network host probe-actix
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
docker rm -f probe-target
Puoi anche puntare la sonda verso qualsiasi server HTTP/1.1 che hai già in esecuzione:
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 9000
Richiede l'SDK .NET 10.
dotnet build Http11Probe.slnx
Il workflow Probe viene eseguito sulle pull request e su workflow_dispatch. Compila l'immagine Docker di ciascun server, la verifica e pubblica una tabella di confronto come commento alla PR.