Fuzzing Harness 是一个面向安全测试的技能,用于为把不可信字节转换为结构的函数编写并运行模糊测试器(fuzzer)、模糊测试嗅探器(harness)和基于属性的测试。它针对代码处理不可信字节的场景,例如文件解析器、数据包解析器、序列化器等,并输出可直接放入用户仓库测试目录的代码。
【主要能力】
- 盘点项目中已有的嗅探器、属性测试和 CI 模糊测试配置,避免重复编写。
- 识别并排序值得模糊测试的目标函数,排序维度包括可达性、内存安全、复杂度、历史漏洞和嗅探成本。
- 按语言选择引擎:C/C++ 使用 libFuzzer,Rust 使用 cargo-fuzz 与 proptest,Go 使用原生模糊测试,Python 使用 Atheris 与 Hypothesis,JavaScript/TypeScript 使用 Jazzer.js 与 fast-check,Java/Kotlin 使用 Jazzer 与 jqwik。
- 编写确定性、快速、正确捕获预期错误并遵守 API 契约的嗅探器,并可加入往返、差分、幂等、安全不变量、签名验证等断言作为 oracle。
- 准备小型合成种子语料和字典,运行后可最小化并提交结果。
- 运行崩溃最小化、去重、分类,判断是否具有安全影响,区分 confirmed、needs_validation、rejected 三种结论。
- 输出带指纹的发现记录,并补充回归测试和 CI 任务。
【使用方式】 工作流为:盘点 → 排序目标 → 编写嗅探器与属性测试 → 准备种子和字典 → 运行(须获同意)→ 最小化、去重、分类 → 验证并记录 → 回归测试与 CI。该技能可以预授权读写代码、排序目标和编写测试文件,但安装工具链或模糊测试包、带 sanitizer 编译、运行模糊测试或属性测试套件、编辑构建文件(如 Cargo.toml、CMakeLists.txt、package.json、go.mod)前,都必须逐次获得用户同意,并说明时间预算。嗅探器不得访问网络、真实数据库、支付或邮件服务,也不得访问临时目录之外的文件;原生目标建议在无网络且有内存和 CPU 限制的容器或虚拟机中运行。
【适用场景】
- 为数据包解析器、图像解码器、配置加载器编写 fuzzer。
- 为序列化器补充属性测试,验证 decode(encode(x)) == x 是否成立。
- 对已有 fuzzer 发现的大量崩溃进行筛选和分级。
- 在 CI 中搭建模糊测试,或评估能否进入 OSS-Fuzz。
- 在源码审查发现手写解析器后,实际运行该解析器进行测试。
【限制】 不适用于向运行中的 Web 应用或 API 发送载荷(应使用 web-pentest)、设备上的 Android intent 模糊测试(应使用 mobile-audit)、不编写嗅探器只做逐行 OWASP 审查(应使用 owasp-audit)、判断 CVE 与模糊测试库的相关性(应使用 vuln-research)、对 SAST 或扫描器告警进行分诊(应使用 finding-triage),也不适用于负载或性能测试。该技能只对用户拥有或获授权的代码操作;对第三方库可在本地通过用户自己的构建进行模糊测试,发现问题应通过该项目的安全策略报告,而不是公开 issue。分类与分诊后停止,不基于崩溃构建可用的漏洞利用。