
Une 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 qu'exigent réellement les RFC 9110 et RFC 9112. Il s'agit des cas délicats comme les fins de ligne LF seules, le repli 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 sont exécutés contre 47 serveurs de référence écrits dans 14 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 erroné.
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 tout serveur HTTP/1.1 déjà à l'écoute sur --host:--port, et il n'existe aucun indicateur 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
| Option | Description | Valeur par défaut |
|---|---|---|
--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 ID 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 de l'achèvement de chaque test, avec un récapitulatif à la fin :
Score: 97/97 19 warnings (146 tests, 35.5s)
Le probe ne fait qu'envoyer des requêtes, il ne démarre pas de serveurs. Pour sonder l'un des serveurs intégrés 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 démarre, le sonder, puis le démonter.
# 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
La valeur --server correspond au nom du répertoire (ActixServer), et non au nom d'affichage (Actix). Si votre démon Docker nécessite les droits root, ajoutez --docker-sudo afin de ne pas avoir à exécuter l'ensemble du script avec sudo :
scripts/probe-local.sh --server ActixServer --docker-sudo
| Option | Description |
|---|---|
--server <Dir> | Sonde un seul serveur par son nom de répertoire sous src/Servers/ (par ex. NginxServer) |
--all | Sonde tous les serveurs sous src/Servers/*/probe.json |
--port <Port> | Port cible (par défaut : 8080) |
--skip-build | Ignore dotnet build (suppose qu'une build Release existe déjà) |
--verbose | Passe --verbose à la CLI |
--docker-sudo | Exécute les commandes Docker via sudo (permet de lancer le script sans sudo) |
-h, --help | Affiche l'aide |
Il écrit probe-<ServerDir>.json (un par serveur), ainsi que 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 maintenir un serveur actif pendant plusieurs exécutions de sonde, construisez et lancez 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, la sonde, et publie un tableau comparatif en commentaire de PR.