线束写作

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

概述

该工具是模糊器的随机字节生成和应用程序 API 之间的桥梁。它必须将原始字节解析为有意义的输入,调用目标函数,并优雅地处理边缘情况。任何模糊测试设置中最重要的部分是工具——如果编写得不好,应用程序的关键部分可能无法覆盖。

关键概念

概念 · 描述 · 框架 · 接收模糊器输入并调用被测目标代码的函数 SUT · 被测系统 - 被模糊化的代码 入口点 · 模糊器所需的函数签名(例如,LLVMFuzzerTestOneInput) FuzzedDataProvider · 用于从原始字节中结构化提取类型数据的帮助程序类

何时申请

在以下情况下应用此技术: 首次创建新的模糊目标 模糊测试活动的代码覆盖率较低或未发现错误 模糊测试期间发现的崩溃不可重现 目标 API 需要复杂或结构化的输入

快速参考

任务 · 模式最小 C++ 工具 · extern "C" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size) 最小 Rust 工具 · fuzz_target!( · data: &[u8] · { ... }) 大小验证 · if (size < MIN_SIZE) return 0; 转换为整数 · uint32_t val = *(uint32_t*)(data);

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@trailofbits · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:确定切入点

在代码库中查找具有以下功能的函数: 接受外部输入(解析器、验证器、协议处理程序) 解析复杂的数据格式(JSON、XML、二进制协议) 执行安全关键操作(身份验证、加密) 具有高圈复杂度或多个分支

02
第 2 步:编写最小线束

从调用目标函数的最简单的工具开始:C/C++:Rust:

03
第 3 步:添加输入验证

拒绝太小或太大而没有意义的输入: 原理:模糊器生成所有大小的随机输入。您的线束必须处理空的、微小的、巨大的或格式错误的输入,而不会导致线束本身出现意外问题(SUT 中的崩溃是正常的 - 这就是我们正在寻找的)。

04
第 4 步:构建输入

对于需要类型化数据(整数、字符串等)的 API,请使用转换或帮助程序,如 `FuzzedDataProvider`:简单转换:使用 FuzzedDataProvider:

05
第 5 步:测试和迭代

运行模糊器并监控:代码覆盖率(是否到达了所有有趣的路径?)每秒执行次数(是否足够快?)崩溃重现性(您可以使用保存的输入重现崩溃吗?)迭代工具以改进这些指标。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。