mda2av/http11probeUne plateforme de test ouverte qui sonde les serveurs HTTP/1.1 par rapport aux exigences des RFC 9110/9112, aux vecteurs de contrebande (smuggling) et à la gestion des entrées malformées. Ajoutez votre framework, obtenez automatiquement des résultats de conformité.
Http11Probe est un outil de test de conformité et de sécurité pour les serveurs HTTP/1.1. Il envoie des requêtes malformées, ambiguës et surdimensionnées à un serveur via des sockets TCP bruts et vérifie comment celui-ci répond par rapport à ce que les RFC 9110 et RFC 9112 exigent réellement. Il s'agit des cas délicats comme les fins de ligne LF seules, le repliement de ligne obsolète, la contrebande de requêtes CL/TE, les astuces de fragmentation chunk, les en-têtes surdimensionnés et les octets NUL, où un analyseur strict et un analyseur indulgent commencent à diverger.
Les mêmes 215 tests s'exécutent contre 42 serveurs de référence écrits dans 12 langages, de Nginx, Apache et Envoy à Kestrel, Gin, Actix, et les serveurs intégrés de Node, Bun et Deno. Chaque résultat est évalué selon la formulation MUST/SHOULD/MAY de la spécification et marqué Pass, Fail ou Warn. Un Warn signifie simplement que la RFC autorise à la fois le comportement strict et le comportement indulgent, donc aucun des deux n'est incorrect.
Vous trouverez la documentation complète, un glossaire par test avec les citations des RFC, et la matrice de résultats en direct pour chaque serveur sur http-probe.com.
La sonde est agnostique quant à la cible. Elle teste n'importe quel serveur HTTP/1.1 déjà en écoute sur --host:--port, et il n'y a pas d'option pour choisir un framework. Démarrez d'abord le serveur (ou laissez probe-local.sh en lancer un pour vous), puis pointez la sonde vers celui-ci.
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
| Flag | Description | Default |
|---|---|---|
--host | Nom d'hôte ou adresse IP cible | localhost |
--port | Numéro de port cible | 8080 |
--category | Exécuter uniquement les tests de cette catégorie (Compliance, Smuggling, MalformedInput, Normalization, Cookies, Capabilities) | tous |
--test | Exécuter uniquement des IDs de test spécifiques, insensible à la casse (répétable) | tous |
--timeout | Délai de connexion et de lecture en secondes par test | 5 |
--output | Écrire les résultats JSON dans un fichier | aucun |
--verbose, -v | Afficher la réponse brute du serveur pour chaque test | désactivé |
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
Exécuter des tests spécifiques :
dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
Les résultats s'affichent dans la console au fur et à mesure que chaque test se termine, avec un résumé à la fin :
Score: 97/97 19 warnings (146 tests, 35.5s)
La sonde ne fait qu'envoyer des requêtes, elle ne démarre pas de serveurs. Pour sonder l'un des serveurs inclus sous src/Servers/, utilisez scripts/probe-local.sh. Il fait la même chose que le pipeline CI : construire l'image Docker du serveur, l'exécuter sur --network host, attendre qu'il soit opérationnel, le sonder, puis le démonter.
# Sonder un serveur par son nom de répertoire sous src/Servers/, par ex. ActixServer
scripts/probe-local.sh --server ActixServer
# Sonder tous les serveurs inclus
scripts/probe-local.sh --all
La valeur de --server est le nom du répertoire (ActixServer), pas le nom d'affichage (Actix). Si votre démon Docker nécessite root, ajoutez --docker-sudo pour ne pas avoir à exécuter tout le script avec sudo :
scripts/probe-local.sh --server ActixServer --docker-sudo
| Flag | Description |
|---|---|
--server <Dir> | Sonder un seul serveur par son nom de répertoire sous src/Servers/ (par ex. NginxServer) |
--all | Sonder tous les serveurs sous src/Servers/*/probe.json |
--port <Port> | Port cible (par défaut : 8080) |
--skip-build | Ignorer dotnet build (suppose qu'une build Release existe déjà) |
--verbose | Passer --verbose au CLI |
--docker-sudo | Exécuter les commandes Docker via sudo (permet d'exécuter le script sans sudo) |
-h, --help | Afficher l'aide |
Il écrit probe-<ServerDir>.json (un par serveur), plus probe-data.js et docs/static/probe/data.js pour le rendu local. Vous aurez besoin de jq, docker, curl, python3 et du SDK .NET 10.
probe-local.sh n'est qu'un simple wrapper de commodité. Si vous préférez le faire à la main, par exemple pour garder un serveur actif sur plusieurs exécutions de sonde, construisez et exécutez le conteneur vous-même, puis pointez la sonde vers celui-ci. Exécutez ces commandes depuis la racine du dépôt, car c'est le contexte de 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
Vous pouvez également pointer la sonde vers n'importe quel serveur HTTP/1.1 que vous avez déjà en cours d'exécution :
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 9000
Nécessite le SDK .NET 10.
dotnet build Http11Probe.slnx
Le workflow Probe s'exécute sur les pull requests et workflow_dispatch. Il construit l'image Docker de chaque serveur, le sonde, et publie un tableau comparatif en commentaire de PR.