见过一封只有一句话的报告:目标站点存在 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 有保密期和披露流程,以该项目最新规则为准。不要在厂商确认前发社交平台,也不要拿未修复细节做课程素材。

还有一条常被忽略:报告提交后,不要在公开渠道讨论细节,包括群聊和朋友圈。修复前的信息扩散,可能直接提高真实风险,也会让原本可控的问题变得不可控。

练习与下一篇

下面几项都能在本地靶场完成,重点是练结构,不是练利用。

  1. 在本地靶场找一个你已复现的问题,按七段式写一份完整报告。写完后把复现步骤单独发给同伴,只让他按步骤操作,看能不能一次走通。
  2. 让同伴只读你的标题和摘要,猜这条漏洞的优先级。如果他猜的方向和你预期差很远,说明这两段没写准。
  3. 找两份公开的漏洞报告样例,各打一次分,从标题、步骤、证据、建议四个角度说明理由,不评价漏洞本身的技术难度。
  4. 把一份含糊报告改写成可复现版本,至少补上地址、参数、账号前提和时间,再对比改写前后对方需要追问的问题数量。

三句话收尾:报告按标题、摘要、影响、前提、步骤、证据、建议七段写;复现步骤要最小化、编号、带账号前提;证据要能对上请求、响应、时间和资产,敏感信息脱敏且不过量。

下一篇讲从提交到修复:跟踪与沟通。原因很直接:报告提交不是终点,后面还有确认、补材料、复测和披露。写得好只保证对方看得懂,沟通得好才能让问题真正被修掉。