
LibAFL 기반으로 개발된 커버리지 기반 REST API 퍼저
TNO는 LibAFL을 기반으로 개발된 커버리지 기반 REST API 퍼저인 WuppieFuzz를 개발했습니다. 이 도구는 폭넓은 최종 사용자층을 대상으로 하며, 사용 편의성, 발견된 결함의 설명 가능성, 모듈성에 중점을 두고 있습니다. WuppieFuzz는 세 가지 테스트 방식(블랙 박스, 그레이 박스, 화이트 박스)을 모두 지원합니다.
[!NOTE]
빠르게 따라 하며 배우고 싶다면 튜토리얼을 참고하세요!
WuppieFuzz는 다음 매체에 소개되었습니다:
학술 작업에서 WuppieFuzz를 인용하려면 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
WuppieFuzz는 Apache-2.0에 따라 라이선스가 부여됩니다. LICENSE를 참고하세요.
타사 라이선스 고지는 THIRD_PARTY_NOTICES에 나열되어 있습니다.
주요 운영 체제(MacOS, Windows, Linux)용 WuppieFuzz의 빠른 설치 방법은 releases를 참고하거나 brew install wuppiefuzz를 사용하세요.
docker build . -t wuppiefuzz:local 명령으로 도커 이미지를 빌드할 수 있습니다. 사용하려면 openapi 스펙이 포함된 폴더를 마운트해야 합니다. 로컬에서 실행 중인 서비스(Docker 내부가 아님)를 퍼징할 때는 호스트 네트워킹을 지정해야 합니다:
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
프로젝트를 빌드하려면 다음 종속성과 도구를 설치해야 합니다:
sudo apt install -y build-essential pkg-config cmake # General build tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # Rust
WuppieFuzz를 실행하기 전에, (계측된) 대상 애플리케이션을 시작해야 합니다.
또한 WuppieFuzz가 요청을 생성하고 변이하는 방법을 알 수 있도록 OpenAPI 명세를 제공해야 합니다. 명령줄 인수에 대한 도움말은 다음을 사용하십시오:
$ cargo run -- --help # shows help for required parameters and flags
Usage: wuppiefuzz [OPTIONS] [OPENAPI_SPEC.YAML]
...
예를 들어, JaCoCo 에이전트가 연결된 Java 대상에 대해 WuppieFuzz를 실행하려면 OpenAPI 파일(API 명세에 대상이 실행 중인 URL이 포함됨)을 지정합니다. 또한 커버리지 형식이 JaCoCo임을 지정하고 다음과 같이 classes 디렉터리를 제공합니다:
cargo run -- fuzz openapi.yaml --coverage-format jacoco --jacoco-class-dir ../Targets/app/target/classes/
명령줄 인수 대신 또는 명령줄 인수와 함께 구성 파일을 사용하려면 --config <CONFIG_FILE> 플래그를 사용할 수 있습니다. 명령줄 인수를 구성 파일과 함께 사용하는 경우 명령줄 인수가 우선합니다.
구성 파일은 yaml 파일이어야 하며, 지정하려는 각 명령줄 인수에 대해 한 줄씩 포함해야 합니다. 예를 들면 다음과 같습니다:
coverage_format: jacoco
output_format: human-readable
source_dir: "/swagger-petstore/src/main/java"
jacoco_class_dir: "/swagger-petstore/target"
timeout: 20
이 경우 예시 실행 명령은 다음과 같을 수 있습니다:
$ cargo run -- fuzz --config=config.yaml --report --coverage-host=localhost:6300 --timeout=10 ./openapi.yaml
이 줄은 명령줄과 설정 파일의 인자를 결합합니다. 플래그 --timeout이 양쪽 모두에 지정되어 있으므로, 명령줄에 지정된 타임아웃(10초)이 우선합니다.
example_configs/ 디렉터리에는 Java 코드용 JaCoCo로 커버리지 보고서를 생성하거나 Python 코드용 LCOV로 커버리지 보고서를 생성할 때 사용할 수 있는 두 개의 예제 설정 파일이 있습니다.
--report 플래그와 함께 WuppieFuzz를 실행하면 reports/ 안에 타임스탬프를 이름으로 하는 하위 디렉터리가 생성됩니다. 지원되는 모든 커버리지 보고서가 이 하위 디렉터리에 작성됩니다. 커버리지 보고서에는 두 가지 유형이 있습니다:
그 위에 퍼징 캠페인과 관련된 모든 요청 정보가 데이터베이스에 채워집니다. 이 데이터베이스는 Grafana 대시보드를 통해 시각화하고 탐색할 수 있습니다.
동일한 --report 플래그는 Web Fuzzing Commons 보고서 스키마를 따르는 report.json 파일도 reports/<timestamp> 디렉터리에 작성하여, 결과를 WFC 호환 도구에서 사용할 수 있게 합니다. 이 파일은 생성된 테스트 케이스, 커버된 엔드포인트와 HTTP 상태 코드, 발견된 결함(검증 오류), 그리고 기본 커버리지 통계를 요약합니다(코드 커버리지는 커버리지 에이전트 - 예: JaCoCo - 가 구성된 경우에만 포함되며, 블랙박스/엔드포인트 전용 모드에서는 엔드포인트 커버리지만 보고됩니다).
각 항목에 대한 자세한 내용은 해당 디렉터리의 README를 참조하세요.
기본적으로 WuppieFuzz는 C 의존성(OpenSSL, SQLite, Z3)을 벤더링하여 일반적인 cargo build가 별도 설정 없이 작동하도록 합니다. 개발 중 더 빠른 컴파일을 위해 모든 벤더링된 의존성을 비활성화하고 시스템에 설치된 라이브러리에 링크할 수 있습니다.
[!NOTE]
z3크레이트는 Z3 4.15 이상을 요구하며, 이는 대부분의 Linux 배포판 패키지 관리자가 제공하는 버전보다 최신입니다. 호환되는 버전을 얻으려면 Homebrew를 통해 Z3를 설치하세요(brew install z3).
시스템에 다음 라이브러리를 설치하세요:
Debian/Ubuntu:
sudo apt install libssl-dev libsqlite3-dev
brew install z3 # apt's libz3-dev is too old; use Homebrew instead
Linux에서 Homebrew는 비표준 경로에 설치됩니다. 컴파일러와 런타임 링커가 Z3를 찾을 수 있도록 Homebrew의 라이브러리 디렉터리를 환경에 추가하세요:
eval "$(brew shellenv)"
export LIBRARY_PATH="$(brew --prefix z3)/lib:$LIBRARY_PATH"
export LD_LIBRARY_PATH="$(brew --prefix z3)/lib:$LD_LIBRARY_PATH"
[!TIP] 위의 줄을
~/.bashrc또는~/.zshrc에 추가하면 영구적으로 적용됩니다.
Fedora (42+):
sudo dnf install openssl-devel sqlite-devel z3-devel
macOS (Homebrew):
brew install openssl sqlite z3
저장소에는 .cargo/config.toml에 cargo 별칭이 포함되어 있으며, 이는
--no-default-features로 빌드하고 모든 시스템 라이브러리에 링크합니다:
cargo dev-build # build without vendored dependencies
cargo dev-run -- <args> # run without vendored dependencies
cargo dev-test # test without vendored dependencies
소스 코드의 주석에서 문서를 생성하려면 cargo doc --no-deps를 실행하세요. 문서의 메인 페이지는 target/doc/wuppiefuzz/index.html에 생성됩니다.