见过一封只有一句话的报告:目标站点存在 XSS,请修复。没有地址,没有参数,没有账号前提。厂商回复无法复现,工单关闭。提交者觉得委屈,说自己确实打出来了。
问题不在结论真假,而在报告没有把你怎么打出来的变成别人能重走一遍的东西。安全报告的第一读者不是你自己,是一个没参与测试、手里只有这封文档的工程师。
这篇讲漏洞报告的写法。重点在结构:标题、摘要、影响、前提条件、复现步骤、证据、修复建议。七段都写到位,报告才算完成;少一段,对方就得靠猜。
先解释两个词。复现步骤是把一次验证拆成按顺序可执行的动作;证据链是让这些动作和结论对得上的材料,包括请求、响应、截图、时间戳。两者不是装饰,是报告的主体。
那句无法复现是怎么来的
那句回复通常不是对方敷衍。把工程师的动作还原一遍,就能看明白。
他先打开首页,翻了几个功能,没有看到可疑参数。报告里没有地址,他找不到入口。
他试着在搜索框输入一段脚本,页面没有反应。报告里没有参数,他不知道该传什么。
他用匿名身份测了一次。报告里没有账号前提,他不知道这需要两个登录用户。
他测的是线上当前版本。报告里没有时间,他不知道你测的是上周的旧版。
四步走完,他只能关掉工单。整个过程他没有任何恶意,只是信息缺口太大。
报告的目标不是证明我很厉害,而是让另一个人用最低成本确认这个问题真实存在、影响是这个。这两件事经常冲突,写作时要选后者。
七段式:每段回答一个问题
七段不需要在报告里原样列成七个大标题,多数平台有固定表单,把内容填进对应栏位就行。但内容一个都不能少。
前三段回答是什么和有多大,中间三段回答怎么发生,最后一段回答怎么收尾。按这个顺序读下来,对方不用来回翻。
常见的顺序错误是把排查过程写成正文,把结论放在最后。读者时间有限,先给结论,再给证据。过程可以放在附录,或者干脆不写。
标题与摘要:先把话说准
标题写清三件事:哪个资产、什么问题、什么后果。比如订单导出接口未校验属主,普通账号可导出他人订单,比存在越权漏洞有用得多。前者让对方一眼知道要叫谁来处理,后者只说明你懂一个名词。
不夸大是硬要求。把需要登录且只能读到测试数据写成全部用户数据泄露,短期可能让报告更显眼,长期会被判定为夸大,甚至影响账号信用。评审看过的报告比你想的多,夸张的措辞很容易被识别。
摘要控制在三到五句:在哪、什么条件、做了什么、结果是什么、影响范围。不要在这里讲排查过程,也不要贴大段请求。摘要是让人决定继续读下去的那几行。
摘要里可以给具体的数字或范围,比如影响同一租户下的所有订单,但要确认这个范围是你真的验证过的。没验证的部分写明是推测,并说清推测依据。把推测写成结论,是报告被打回的常见原因。
被判定「无影响」,很多时候不是漏洞不存在,而是报告里缺了一句「所以呢」。对比一下就清楚。坏写法是:「该接口存在越权,可导致信息泄露。」好写法是:「普通账号 A 登录后,把导出请求里的 orderId 换成账号 B 的订单号,接口返回 200,响应里包含 B 的收货人姓名、手机号和金额;我用两个自己注册的测试账号复现,全程不需要管理员权限。」
差别在三处:谁在什么身份下操作、他改了什么、他实际拿到了什么。第一句只有结论和「可能」,评审无法判断范围,只能按「未证明」处理;第二句把可利用性、前提和结果落到具体字段上,才具备被确认和修复的条件。一句可检验的影响描述,胜过五段原理说明。
写报告时可以先写这句话,再倒推需要哪些步骤和证据。写不出来,通常说明影响还没验证清楚,而不是对方要求太严。
如果确实只能读到自己造的测试数据,就如实写「在测试账号下可见」,不要为了显得严重而扩大范围。影响写小了最多被降级,写大了会被判定夸大,反而失去信任。
复现步骤:让对方一次走通
最小化是第一条。去掉与结论无关的步骤,能用两步证明的不要写十步。步骤越短,复现成功率越高,也越不容易在中间引入变量。
编号,一步一个动作。每一步写清用什么身份、访问什么地址、提交什么内容、期望看到什么。期望和实际分开写,对方才知道哪一步没对上。
账号前提写在最前面:需要几个账号、什么角色、如何准备测试数据。不要假设对方有你测试时用的那个账号,也不要说用你自己的账号就行。对方没有你的账号,这句话等于没说。
参数给原样文本,敏感值替换成占位符,但要说明替换规则。截图不能代替文本,文本才能被复制。下面是一段示意,域名和编号都是占位:
POST /api/order/export HTTP/1.1
Host: shop.example.com
Cookie: SESSION=<账号A的会话>
Content-Type: application/json
{"orderId":"<账号B的订单号>"}
对应的响应只要说明状态码、关键字段和实际结果就够了。比如返回 200,body 里出现账号 B 的收货人和金额,这一句比十张截图都直接。前提是这些字段确实来自你控制的两个测试账号。
步骤里不要夹带无关动作。顺手试了一下别的接口这种描述,会让对方怀疑测试范围,也会让复现变得不确定。只写支撑结论的那条路径。
证据链与脱敏:能对上,又不过量
证据要能回答三个问题:请求是你发的、响应是目标回的、时间和资产对得上。三个问题有一个答不上,证据就不完整。
请求给完整报文,包括方法、路径、关键请求头、body;响应给状态码、关键响应头、能证明结果的那一段。截图辅助,不要只给截图。截图会被压缩、裁剪,也会丢掉请求头里的关键信息。
时间戳带时区,最好能和目标日志对上。资产写完整域名,不要写目标站。这两项看起来琐碎,却是对方定位日志的唯一线索。
脱敏要保留结构。Cookie、Token、手机号、身份证、真实姓名、内部地址,替换成占位符,但要让人看得出这里原本是什么类型。全部涂黑等于没有证据,保留原文又制造了新风险。
证据不要超出必要范围。为了证明一个越权,不需要把整库数据导出来;拿一条能对上的记录就够了。多拿的部分既是风险,也不是证据,还会让报告的重点失焦。
CVSS:分数是参考,不是结论
CVSS 是一套给漏洞打分的通用框架,由一组维度组成:攻击路径、攻击复杂度、所需权限、用户交互、对机密性、完整性、可用性的影响。每个维度选一个值,算出一个基础分。
分数不等于危害。同一个 7.5,落在有千万用户的支付接口,和落在内网测试工具上,实际影响差得很远。报告里要写清业务上下文,不要只丢一个分数就结束。
别硬凑 9.8。9.8 通常要求网络可达、无需权限、无需交互,且对三项都有高影响。很多真实漏洞达不到,硬写反而显得不专业。不确定时给出各维度的取值和理由,让对方自己判断。
CVSS 也不该单独出现。它适合放在摘要或影响段作为参考,前面仍然要用人话说明谁能利用、能做什么。分数是给流程用的,人话是给人用的。
两份报告放在一起
把两份报告放在一起看,差别不在文笔,在信息密度。一份读完还得追问五件事,另一份读完可以直接开环境验证。
坏报告
标题只有存在 XSS 四个字。正文一句目标站有反射型跨站。没有步骤,只有一张模糊截图。修复建议是请修复。对方不知道是哪个页面、哪个参数、用什么账号、影响到什么程度。
好报告
标题写明搜索页 q 参数存在反射型跨站,可窃取登录态。摘要四句交代条件和范围。前提是匿名可触发。步骤五步,带原样参数。请求响应齐全。修复建议分编码和缓存策略两步,并给出验证方法。
好报告也不是越长越好。它的每一段都在减少对方的一个疑问。当对方读完不需要再问你任何问题,报告就合格了。
坏报告往往不是没写,而是写偏了:把篇幅花在过程叙述上,把关键信息藏在附件里,让对方自己去拼。写作时站在对方的位置回读一遍,很容易发现缺口。
现象对照表
下面这张表列的是报告本身的问题。提交前逐行对一遍,能省掉一轮来回。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 标题只写漏洞类型 | 没有交代资产和后果,无法判断优先级 | 补上资产、触发条件和实际影响 |
| 对方回复无法复现 | 缺地址、参数、账号前提或时间版本 | 按最小步骤重走一遍,补齐缺口 |
| 只给截图不给请求 | 无法确认路径、参数和数据来源 | 补完整请求与关键响应片段 |
| 影响写得夸张 | 把推测当结论,超出实际验证范围 | 按真正能触达的数据和用户重写 |
| CVSS 直接写 9.8 没有理由 | 只想要高分,没有逐维度取值 | 列出各维度取值和判断依据 |
| 修复建议写成整段代码 | 替厂商做业务决策,方案未必可落地 | 改成方向、边界和验证方法 |
| 证据里含真实用户数据 | 证据与素材没有分开,收集过量 | 脱敏,只留证明结论的最小片段 |
边界与代价
写报告也有边界。报告里不能出现真实用户的姓名、手机号、身份证、完整订单;不能把怎么进一步利用写成操作手册;不能在厂商修复前公开细节。
代价一:证据不足,报告被关,时间白费。代价二:证据过度,把不该拿的数据拿走,问题从发现漏洞变成处理数据。代价三:夸大,短期得分,长期失信。三种代价里,后两种往往比第一种更难收拾。
修复建议的边界也要注意。你是研究者,不是这个项目的开发者。给方向和验证方法,不要替对方改代码;不确定业务约束时,写建议评估,而不是必须这样改。对方比你更清楚系统里还有哪些依赖。
公开节奏按项目规则来。多数 SRC 有保密期和披露流程,以该项目最新规则为准。不要在厂商确认前发社交平台,也不要拿未修复细节做课程素材。
还有一条常被忽略:报告提交后,不要在公开渠道讨论细节,包括群聊和朋友圈。修复前的信息扩散,可能直接提高真实风险,也会让原本可控的问题变得不可控。
练习与下一篇
下面几项都能在本地靶场完成,重点是练结构,不是练利用。
- 在本地靶场找一个你已复现的问题,按七段式写一份完整报告。写完后把复现步骤单独发给同伴,只让他按步骤操作,看能不能一次走通。
- 让同伴只读你的标题和摘要,猜这条漏洞的优先级。如果他猜的方向和你预期差很远,说明这两段没写准。
- 找两份公开的漏洞报告样例,各打一次分,从标题、步骤、证据、建议四个角度说明理由,不评价漏洞本身的技术难度。
- 把一份含糊报告改写成可复现版本,至少补上地址、参数、账号前提和时间,再对比改写前后对方需要追问的问题数量。
三句话收尾:报告按标题、摘要、影响、前提、步骤、证据、建议七段写;复现步骤要最小化、编号、带账号前提;证据要能对上请求、响应、时间和资产,敏感信息脱敏且不过量。
下一篇讲从提交到修复:跟踪与沟通。原因很直接:报告提交不是终点,后面还有确认、补材料、复测和披露。写得好只保证对方看得懂,沟通得好才能让问题真正被修掉。