Volver a actualizaciones
Nuevo releaseAug 30, 2026

WuppieFuzz v1.7.1

Un fuzzer de API REST guiado por cobertura desarrollado sobre LibAFL

Compartir

WuppieFuzz v1.8.1

Logotipo de WuppieFuzz.

TNO desarrolló WuppieFuzz, un fuzzer de API REST guiado por cobertura construido sobre LibAFL, dirigido a un amplio público de usuarios finales, con un fuerte enfoque en la facilidad de uso, la explicabilidad de los fallos descubiertos y la modularidad. WuppieFuzz admite los tres modos de pruebas (caja negra, caja gris y caja blanca).

[!NOTE]
Para una guía rápida y paso a paso, ¡sigue el tutorial!

Cobertura mediática

WuppieFuzz ha aparecido en:

Publicación científica

Si deseas citar WuppieFuzz en un trabajo académico, utiliza la publicación preferida que figura en CITATION.cff:

Rooijakkers, T., Nijsten, A., Daniele, C., Weitenberg, E., Groenewegen, R., & Melissen, A. (2026). WuppieFuzz: Coverage-Guided, Stateful REST API Fuzzing. In Proceedings of the 12th International Conference on Information Systems Security and Privacy (ICISSP), Volume 2, 221-231. SciTePress. https://doi.org/10.5220/0000217100004061

Licencia

WuppieFuzz está licenciado bajo Apache-2.0; consulta LICENSE.
Los avisos de licencias de terceros se enumeran en THIRD_PARTY_NOTICES.

Instalación rápida

Para una instalación rápida de WuppieFuzz en los sistemas operativos más populares (MacOS, Windows, Linux), consulta releases o usa brew install wuppiefuzz

Docker

Puedes construir la imagen de Docker con docker build . -t wuppiefuzz:local. Para usarla, debes montar una carpeta que contenga tu especificación OpenAPI. Al hacer fuzzing de un servicio que se ejecuta localmente (no en Docker), debes especificar la red del host:

docker run \
  --network host \
  -v ./fuzzing-folder:/fuzzing-folder \  # The folder will be populated with wuppiefuzz outputs
  -w /fuzzing-folder \
  wuppiefuzz:local fuzz --timeout 60 --report openapi.json

Guía rápida

How to use WuppieFuzz? - YouTube

Requisitos previos para el desarrollo

Para compilar el proyecto, es necesario instalar las siguientes dependencias y herramientas:

sudo apt install -y build-essential pkg-config cmake  # General build tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh  # Rust

Ejecución

WuppieFuzz en acción.

Antes de ejecutar WuppieFuzz, debes iniciar tu aplicación objetivo (instrumentada).

Además, debes proporcionar a WuppieFuzz una especificación OpenAPI para que sepa cómo generar y mutar sus peticiones. Para obtener ayuda sobre los argumentos de la línea de comandos, utiliza lo siguiente:

$ cargo run -- --help # shows help for required parameters and flags

Usage: wuppiefuzz [OPTIONS] [OPENAPI_SPEC.YAML]
...

Por ejemplo, para ejecutar WuppieFuzz contra un objetivo Java con el agente JaCoCo adjunto, se especifica su archivo OpenAPI (que contiene la URL en la que se ejecuta el objetivo en la especificación de la API). Además, se especifica que el formato de cobertura es JaCoCo y se indica el directorio de clases de la siguiente manera:

cargo run -- fuzz openapi.yaml --coverage-format jacoco --jacoco-class-dir ../Targets/app/target/classes/

Archivo de configuración

Si deseas usar un archivo de configuración en lugar de/en combinación con los argumentos de línea de comandos, puedes usar el flag --config <CONFIG_FILE>. En caso de que uses argumentos de línea de comandos en combinación con un archivo de configuración, los argumentos de línea de comandos tienen prioridad.

El archivo de configuración debe ser un archivo yaml y contener una línea por cada argumento de línea de comandos que desees especificar, por ejemplo:

coverage_format: jacoco
output_format: human-readable
source_dir: "/swagger-petstore/src/main/java"
jacoco_class_dir: "/swagger-petstore/target"
timeout: 20

Un ejemplo de comando de ejecución en este caso podría ser:

$ cargo run -- fuzz --config=config.yaml --report --coverage-host=localhost:6300 --timeout=10 ./openapi.yaml

Esta línea combinaría los argumentos de la línea de comandos y del archivo de configuración. Dado que el flag --timeout se especifica en ambos, el timeout especificado en la línea de comandos (10 segundos) tendrá precedencia.

En el directorio example_configs/ encontrarás dos archivos de configuración de ejemplo para usar al generar informes de cobertura con JaCoCo para código Java y para generar informes de cobertura con LCOV para código Python.

Informes

Cuando ejecutes WuppieFuzz con el flag --report, se crea un subdirectorio dentro de reports/ con una marca de tiempo como nombre. Todos los informes de cobertura compatibles se escriben en este subdirectorio. Hay dos tipos de informes de cobertura:

  1. cobertura de endpoints: esto siempre se puede generar, ya que solo requiere la especificación OpenAPI.
  2. cobertura de código: actualmente solo es compatible con JaCoCo, pero nuestro objetivo es admitir más. La parte complicada es que esto requiere un mapeo de la cobertura a los archivos fuente, y una generación de informes robusta que lo utilice.

Además de esto, se llena una base de datos con toda la información de solicitudes relacionada con tu campaña de fuzzing. Esta base de datos se puede visualizar y explorar a través del panel de Grafana.

Informe de Web Fuzzing Commons (WFC)

El mismo flag --report también escribe un archivo report.json en el directorio reports/<timestamp>, siguiendo el esquema de informe de Web Fuzzing Commons , lo que permite que los resultados sean consumidos por herramientas compatibles con WFC. Resume los casos de prueba generados, los endpoints y códigos de estado HTTP cubiertos, cualquier fallo (errores de validación) encontrado, y estadísticas básicas de cobertura (la cobertura de código se incluye solo cuando se configura un agente de cobertura - p. ej., JaCoCo -; en modo de caja negra/solo endpoints solo se informa la cobertura de endpoints).

Estructura de este repositorio

Categorías