mda2av/http11probeUma plataforma de testes aberta que testa servidores HTTP/1.1 conforme os requisitos das RFCs 9110/9112, vetores de smuggling e tratamento de entrada malformada. Adicione seu framework e obtenha resultados de conformidade automaticamente.
Http11Probe é um testador de conformidade e segurança para servidores HTTP/1.1. Ele envia requisições malformadas, ambíguas e de tamanho excessivo para um servidor através de sockets TCP brutos e verifica como ele responde em relação ao que as RFC 9110 e RFC 9112 realmente exigem. Esses são os casos complicados, como terminações de linha com LF isolado, dobra de linha obsoleta, contrabando de requisições CL/TE, truques de enquadramento de chunks, cabeçalhos de tamanho excessivo e bytes NUL, onde um analisador estrito e um leniente começam a discordar.
Os mesmos 215 testes são executados contra 42 servidores de referência escritos em 12 linguagens, de Nginx, Apache e Envoy a Kestrel, Gin, Actix e os servidores embutidos em Node, Bun e Deno. Cada resultado é pontuado de acordo com a redação MUST/SHOULD/MAY da especificação e marcado como Pass, Fail ou Warn. Um Warn significa apenas que a RFC permite tanto o comportamento estrito quanto o leniente, então nenhum dos dois está errado.
Você encontrará a documentação completa, um glossário por teste com citações das RFCs e a matriz de resultados ao vivo para cada servidor em http-probe.com.
O probe é agnóstico em relação ao alvo. Ele testa qualquer servidor HTTP/1.1 que já esteja escutando em --host:--port, e não há flag para escolher um framework. Inicie o servidor primeiro (ou deixe o probe-local.sh iniciar um para você), depois aponte o probe para ele.
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
| Flag | Descrição | Padrão |
|---|---|---|
--host | Nome do host ou endereço IP de destino | localhost |
--port | Número da porta de destino | 8080 |
--category | Executa apenas testes desta categoria (Compliance, Smuggling, MalformedInput, Normalization, Cookies, Capabilities) | todos |
--test | Executa apenas IDs de teste específicos, sem diferenciar maiúsculas de minúsculas (repetível) | todos |
--timeout | Tempo limite de conexão e leitura em segundos por teste | 5 |
--output | Grava resultados JSON em arquivo | nenhum |
--verbose, -v | Imprime a resposta bruta do servidor para cada teste | desativado |
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
Executar testes específicos:
dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
Os resultados são transmitidos para o console conforme cada teste é concluído, com um resumo no final:
Score: 97/97 19 warnings (146 tests, 35.5s)
O probe apenas envia requisições, ele não inicia servidores. Para testar um dos servidores incluídos em src/Servers/, use scripts/probe-local.sh. Ele faz a mesma coisa que o pipeline de CI faz: compila a imagem Docker do servidor, executa-a em --network host, espera que ela suba, testa-a e depois a remove.
# Testa um servidor pelo nome do diretório em src/Servers/, por exemplo ActixServer
scripts/probe-local.sh --server ActixServer
# Testa todos os servidores incluídos
scripts/probe-local.sh --all
O valor de --server é o nome do diretório (ActixServer), não o nome de exibição (Actix). Se o seu daemon Docker precisar de root, adicione --docker-sudo para não precisar executar o script inteiro com sudo:
scripts/probe-local.sh --server ActixServer --docker-sudo
| Flag | Descrição |
|---|---|
--server <Dir> | Testa um único servidor pelo nome do diretório em src/Servers/ (por exemplo, NginxServer) |
--all | Testa todos os servidores em src/Servers/*/probe.json |
--port <Port> | Porta de destino (padrão: 8080) |
--skip-build | Ignora dotnet build (presume que já existe uma compilação Release) |
--verbose | Passa --verbose para a CLI |
--docker-sudo | Executa comandos Docker via sudo (permite executar o script sem sudo) |
-h, --help | Mostra a ajuda |
Ele grava probe-<ServerDir>.json (um por servidor), além de probe-data.js e docs/static/probe/data.js para renderização local. Você precisará de jq, docker, curl, python3 e o .NET 10 SDK.
probe-local.sh é apenas um wrapper de conveniência. Se preferir fazer manualmente, por exemplo, para manter um servidor ativo durante várias execuções do probe, compile e execute o contêiner você mesmo, depois aponte o probe para ele. Execute estes comandos a partir da raiz do repositório, pois esse é o contexto de build do 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
Você também pode apontar o probe para qualquer servidor HTTP/1.1 que já esteja em execução:
dotnet run --project src/Http11Probe.Cli -- --host localhost --port 9000
Requer o .NET 10 SDK.
dotnet build Http11Probe.slnx
O workflow Probe é executado em pull requests e workflow_dispatch. Ele compila a imagem Docker de cada servidor, testa-a e publica uma tabela de comparação como comentário no PR.