¿Qué es pFuzz? ❓

pFuzz es una herramienta avanzada de fuzzing para el equipo rojo que desarrollamos para nuestra investigación. Nos ayuda a evadir firewalls de aplicaciones web utilizando diferentes métodos al mismo tiempo.

pFuzz es una herramienta avanzada de fuzzing que desarrollamos para investigaciones de aplicaciones web. Se ha desarrollado para acelerar el proceso de probar varios métodos de ataque en diferentes aplicaciones de seguridad.

Descripción [EN]

pFuzz es una herramienta desarrollada en el lenguaje Python para tener capacidad avanzada de fuzzing en la investigación de aplicaciones web. Dado que la aplicación tiene una estructura modular, tiene la capacidad de añadir rápidamente métodos de evasión de WAF recién encontrados/por encontrar a pFuzz y probarlos en todos los demás WAF. Además de una estructura modular, se han utilizado estructuras como multi-hilo, multiprocesamiento y colas para hacer la herramienta más flexible, y se ha creado la infraestructura para futuros desarrollos.

La herramienta está programada para que una solicitud dada pueda ser analizada y modificada fácilmente a través de un objeto. Gracias a esta estructura, quienes desarrollen la aplicación podrán contribuir fácilmente y desarrollar la herramienta según sus propias necesidades sin cambiar la estructura central de la aplicación y sin tener que aprenderla.

Nota: Si deseas contribuir al desarrollo, no solo puedes hacerlo desarrollando pFuzz, sino también añadiendo nuevos módulos. ¡No dudes en abrir nuevos PR! :)

Descripción [TR]

pFuzz es una herramienta desarrollada en Python para tener capacidad avanzada de fuzzing en investigaciones de aplicaciones web. Dado que la aplicación tiene una estructura modular, tiene la capacidad de añadir rápidamente métodos de evasión de WAF recién encontrados/por encontrar a pFuzz y probarlos en todos los demás WAF. Además de una estructura modular, se han utilizado estructuras como multi-hilo, multiprocesamiento y colas para hacer la herramienta más flexible, y se ha creado la infraestructura para futuros desarrollos.

Nota: Si deseas contribuir al desarrollo, no solo puedes hacerlo como desarrollo del núcleo 'core', sino también añadiendo nuevos módulos. ¡Esperamos tus nuevos PR! :)

        _____                 
 _ __  |  ___|_   _  ____ ____
| '_ \ | |_  | | | ||_  /|_  /
| |_) ||  _| | |_| | / /  / / 
| .__/ |_|    \__,_|/___|/___|
|_|

Desarrolladores 💁

Flujo 📋

pFuzz

Instalación y Uso 📚

sudo pip3 install virtualenv
python3 -m venv myvenv
source myvenv/bin/activate
pip3 install -r requirements.txt
python3 pfuzz.py --help

Dependencias:

cffi==1.14.3
cryptography==3.1.1
numpy==1.19.2
pandas==1.1.3
pycparser==2.20
pyOpenSSL==19.1.0
python-dateutil==2.8.1
pytz==2020.1
six==1.15.0
xlrd==1.2.0

Uso

Ayuda

python3 pfuzz.py --help

Módulo de Manipulación de Cabeceras

python3 pfuzz.py -r request.txt -m

Módulo de Fuzzing de Caracteres

python3 pfuzz.py -r request.txt -cf

Módulo de Fuzzing

python3 pfuzz.py -r request.txt -f

Añadir proxy

python3 pfuzz.py -r request.txt -f --proxy 127.0.0.1:8080

Añadir un retardo entre peticiones

python3 pfuzz.py -r request.txt -f -d 3

Habilitar conexión TLS/SSL

python3 pfuzz.py -r request.txt -f -s

Habilitar registro (logging)

python3 pfuzz.py -r request.txt -f -l

Habilitar función de codificación/codificación completa de payloads

python3 pfuzz.py -r request.txt -f -e

python3 pfuzz.py -r request.txt -f -fe

Establecer multi-hilos

python3 pfuzz.py -r request.txt -f -t 5

Salida a la terminal

python3 pfuzz.py -r request.txt -f -o terminal

python3 pfuzz.py -r request.txt -f -od terminal

Salida a un archivo

python3 pfuzz.py -r request.txt -f -o ~/Desktop/

python3 pfuzz.py -r request.txt -f -od ~/tmp/

Ayuda 💻

              _____                 
       _ __  |  ___|_   _  ____ ____
      | '_ \ | |_  | | | ||_  /|_  /
      | |_) ||  _| | |_| | / /  / / 
      | .__/ |_|    \__,_|/___|/___|
      |_|
   ------------------------------------
   @EmreOvunc | @merttasci | @xsuperbug
   ------------------------------------
                 v0.2.4
   ------------------------------------

usage: pfuzz.py [-h] [--request REQUEST] [--proxy PROXY] [--log] [--ssl]
                 [--threads THREADS] [--output OUTPUT] [--delay TIME] 
                 [--output-details OUTPUT] [--full-encode] [--encode]
                 [--fuzz] [--charfuzz] [--manipulate] [--version]

optional arguments:
  --help/-h             show this help message and exit
  --proxy/-p    PROXY   proxy [IP:PORT]
  --log/-l              enable logging
  --ssl/-s              enable ssl
  --threads/-t  NUMBER  thread(s) number [default=1]
  --version/-v          show program's version number and exit
  
[Request Options]:  
  --request/-r  REQUEST request file
  --delay/-d    TIME    set a delay between requests [default=0.05]
  --encode/-e           encode space chars in uri/body
  --full-encode/-fe     encode all chars in uri/body
  
[Output Options]:
  --output/-o   OUTPUT  output important info [terminal/folder name]
  --output-details/-od OUTPUT
                        output all details [terminal/folder name]
                        
[Modules]:
  --fuzz/-f             run fuzzing module
  --charfuzz/-cf        run char fuzzing module
  --manipulate/-m       run manipulating headers module

Usage: python3 pfuzz.py -r req.txt --log -s --fuzz -d 1 --encode -o terminal --threads 2
Usage: python3 pfuzz.py -r req.txt -f -l --proxy 127.0.0.1:8080 --output-details ~/output

Extras 📢

Cómo Desarrollar un Nuevo Módulo

Debe crearse un archivo Python que especifique el nombre del módulo dentro de la carpeta modules/.

- modules
        - charfuzzer.py
        - exparse.py
        - fuzzer.py
        - headeroperations.py
        - manupilatingheaders.py

Puedes usar el objeto analizado como myreq = HTTPReq.getobj()

from reqparser import HTTPReq
myreq  = HTTPReq.getobj()

Tiene muchos atributos derivados de la clase HTTPReq. Puedes verlos en reqparser.py.

...
myreq.uri
myreq.body
myreq.http
myreq.referer
myreq.origin
myreq.host
myreq.cookie
...

Si deseas obtener tus payloads desde el archivo Excel, puedes usar los métodos getpayloads de modules.exparse.
- getpayloads(fuzzsheetName, genericcolmnName, fuzzingpayloads)
```
from modules.exparse import getpayloads
getpayloads(fuzzsheetName, genericcolmnName, fuzzingpayloads)
```
- Configuramos objetos estáticos como fuzzsheetName en statics.py que está dentro de la carpeta static/.
```
# Módulo de Fuzzing en static/statics.py
fuzzsheetName   = 'Fuzzing'
genericcolmnName = 'Payload'
fuzzingpayloads = []
```
Ahora, puedes cambiar/añadir/eliminar los atributos como desees.

myreq.uri = tmpuri + payload
myreq.addheader(header, "127.0.0.1")
myreq.content_type = "text/html"

Para detener el multi-hilo, debes agregar el payload #exitme# al final de tus payloads y establecer statics.exitCall = True para verificar si la cola está vacía o no.

from modules.exparse import getpayloads
for payload in fuzzingpayloads:
if payload == '#exitme#':
    statics.exitCall = True
else:
    [OPERACIONES]

Cuando tu objeto (solicitud) esté listo para ser enviado, puedes usar la función sendit() para ponerlo en la cola.

from reqsender import sendit
sendit(myreq)

Si necesitas cambiar funciones centrales en pFuzz, puedes iniciar un pull request o abrir un issue.

Algunas Funciones Importantes para Desarrollar Nuevos Módulos

¿Qué WAFs hemos evadido?

FortiWeb
Cloudflare
Sucuri
Akamai
Imperva
F5 WAF

Enviar una solicitud	reqsender.py	sendit()	object
Usar un objeto de solicitud	reqparser.py/HTTPReq	getobj()	-
Añadir una cabecera personalizada	reqparser.py/HTTPReq	OBJECT.addheader()	newHeadername,value
Eliminar una cabecera	reqparser.py/HTTPReq	OBJECT.delheader()	headerName
Cambiar una cabecera	reqparser.py/HTTPReq	OBJECT.changeheader()	headerName,newHeaderName
Obtener un payload del archivo	exparse.py	getpayloads()	sheetName,columnName
Escribir un registro info/debug/warning	waflogger.py	loginfo/logdebug/logwarn()	logMessage