
Uma plataforma de testes de segurança aberta e local-first para pentesters, agentes de IA, pipelines de CI/CD e equipes.
CI: suite · goldens · perf-check — linha de base 281.9ms / 19 páginas (tests/perf/baseline.json) — .github/workflows/ci.yml
Um único motor de testes de segurança. Todas as interfaces.
Uma plataforma aberta e local-first de testes de segurança para pentesters, agentes de IA, pipelines de CI/CD e equipes.
As ferramentas de segurança tradicionais foram concebidas em torno de um único testador que utiliza uma interface de desktop.
O pwnproxy é construído em torno de um motor partilhado de testes de segurança que pode ser controlado através de um terminal, TUI, API REST, streams WebSocket, pipelines de CI/CD ou agentes de IA através de MCP.
┌─────────────────────┐
│ pwnproxy core │
│ │
│ Proxy · Scanners │
│ Repeater · Intruder │
│ Sessions · Plugins │
└──────────┬──────────┘
│
┌───────────┬───────────┼───────────┬───────────┐
▼ ▼ ▼ ▼ ▼
CLI TUI REST API WebSocket MCP
│ │ │ │ │
Pentesters Pentesters Automation Teams AI Agents
O mesmo núcleo é usado quer esteja a intercetar tráfego manualmente, a executar uma análise automatizada, a integrar verificações de segurança em CI/CD ou a dar a um agente de IA acesso ao seu fluxo de trabalho de testes.
O proxy, os scanners, o armazenamento e a automação são executados na sua infraestrutura.
Não é necessária qualquer dependência da cloud para o fluxo de trabalho de testes principal.
A CLI, a TUI, a API REST, os streams WebSocket e o servidor MCP são interfaces para o mesmo sistema subjacente.
Não precisa de ferramentas separadas para testes manuais e automação.
Execute análises diretamente a partir da linha de comandos, consuma saída JSON ou SARIF e integre os resultados em pipelines CI/CD.
O pwnproxy expõe as suas capacidades através de um servidor MCP nativo, para que agentes de IA compatíveis possam interagir com o mesmo motor de testes usado pelos operadores humanos.
Os scanners e os hooks utilizam uma arquitetura de plugins concebida para extensões incorporadas e de terceiros.
git clone https://github.com/ericmtzmtz/pwnproxy.git
cd pwnproxy
poetry install
É necessário Python 3.12 ou superior.
poetry run pwnproxy start --proxy-port 8080 --api-port 8000
127.0.0.1:8080127.0.0.1:8000http://127.0.0.1:8000/docscurl -x http://127.0.0.1:8080 http://httpbin.org/get
poetry run pwnproxy history
poetry run pwnproxy scan url https://example.com \
--scanners sqli,xss \
--output sarif \
--output-file report.sarif
Códigos de saída:
| Código | Significado |
|---|---|
| 0 | Varredura concluída, nenhum achado |
| 1 | Varredura concluída, achados encontrados |
| 2 | Erro |
O pwnproxy atualmente é instalado a partir do código-fonte usando Poetry (0.1.0 pré-lançamento; 0.2.0-dev no CHANGELOG.md). O empacotamento no PyPI está planejado para uma versão futura.
A configuração fica em ~/.pwnproxy/config.toml — consulte config.example.toml para [triage] / [llm] / max_llm_per_scan e configurações de escopo. Os testes principais (proxy, scanners, armazenamento) funcionam sem uma chave de API de LLM; a triagem é executada por heurísticas por padrão.
Pause, inspecione, modifique e retome o tráfego HTTP/HTTPS.
Os scanners integrados atualmente incluem:
| Scanner | Detecção |
|---|---|
| SQLi | Baseada em erros (assinaturas + 5xx atenuados com controles negativos / proteções anti-WAF), boolean-blind (múltiplas rodadas + linha de base), baseada em tempo, OOB |
| XSS | Refletido/armazenado com explorabilidade sensível ao contexto (reflexão ≠ XSS); sinais estáticos de sink no DOM (dom-xss, inferido) |
| LFI | Assinaturas de conteúdo, travessia e wrappers PHP |
| XXE | Fluxos baseados em erros, XInclude, mutação de JSON e OOB |
| SSRF | Apenas confirmação OOB/callback (fail-closed; sem SSRF especulativo baseado em erros) |
Os achados usam três níveis de confiança — tentative, inferred e confirmed — para que sinais fracos não sejam tratados como exploits. A triagem por LLM é opcional; por padrão o pipeline permanece em heurísticas e nunca envia achados tentative ao juiz LLM.
Os scanners consomem fluxos capturados e também podem ser executados diretamente em modo headless.
Reproduza e modifique requisições HTTP brutas de forma independente do proxy.
Os achados preservam os dados da requisição para que os problemas detectados possam ser validados manualmente.
Fuzzing de requisições usando posições §marker§ no estilo Burp.
Os modos suportados incluem:
Descoberta de caminhos e arquivos baseada em wordlists com:
Extraia e armazene automaticamente:
As sessões são isoladas e persistidas localmente.
Estenda o pwnproxy com scanners e hooks personalizados.
Os plugins podem ser:
A mesma interface de plugin é usada para scanners integrados e de terceiros.
Um watchdog monitora falhas de plugins e pode desativar automaticamente plugins que falham repetidamente.
Execute o pwnproxy diretamente pelo terminal.
pwnproxy start
pwnproxy history
pwnproxy findings
pwnproxy scan url https://example.com
pwnproxy plugin list
pwnproxy session list
Use uma interface de terminal interativa para:
Controle a plataforma programaticamente.
curl http://127.0.0.1:8000/api/v1/flows
A API expõe funcionalidades para:
A documentação interativa da API está disponível em:
http://127.0.0.1:8000/docs