威胁建模最有价值的时机是攻击发生前,但前提是模型写清什么重要、信任在哪里变化。没有资产和边界的攻击名称清单只是安全表演。
为什么需要这个 Skill
威胁建模 Skill 用有证据边界的方式整理资产、信任边界、攻击面、威胁场景、缓解措施和假设,准备安全验证,不登录、不调用真实 API,也不声称安全通过。
Skill 用来做什么
本文关注的模型应说明攻击者可能在哪里跨越边界,以及什么证据会改变风险判断。
新服务、数据流、集成或高影响变更需要复核安全假设和缓解措施时,可以使用这个 Skill。系统跨越租户、网络、身份或数据边界,或者需要在实现前准备安全场景时也适用。
好的发现要写清资产、边界、角色、威胁场景、已有缓解、证据状态、影响、负责人、关闭条件和隔离验证方式。
它不做什么
威胁建模 Skill 可以组织资产与边界的材料、证据和下一步动作,但它不能替代:
- 业务或领域负责人对规则、范围和风险的确认。
- 真实环境、账号、数据、日志或运行结果;静态分析不会自动升级为运行证据。
- 发布、合规、生产操作和残余风险接受等授权决定。
- 在输入相互冲突时替团队选择一个未经确认的事实。
它主要检查哪些内容
围绕实际组件和信任边界整理数据流,把每条跨界路径与资产、现有控制和验证证据对应起来:
| 检查关注点 | 开始前要问 | 结果应留下什么 |
|---|---|---|
| 资产与边界 | 保护什么、信任在哪里变化 | 来源与适用性 |
| 威胁场景 | 角色、路径、前置、影响和缓解 | 证据状态 |
| 假设缺口 | 模型依赖但没有证明的内容 | 负责人问题 |
| 验证动作 | 高风险场景的安全检查 | 隔离与停止条件 |
如果某一行只有经验判断、没有来源或验证方法,就把它留在待确认项里,不要提前写成通过。
开始之前先审计输入
围绕“资产与边界”开始分析时,先把输入分成六种状态。缺口不会自动变成失败,但也不能被隐藏在结论里。
| 状态 | 含义 | 本 Skill 的处理方式 |
|---|---|---|
| known | 材料直接证明的事实 | 标出来源、版本和时间,允许进入判断 |
| missing | 本轮需要但尚未提供的材料 | 列出最小补证动作,结论保持受限 |
| conflicting | 来源之间互相矛盾 | 并列来源和冲突点,交给负责人裁决 |
| stale | 材料存在但版本或时间已经过期 | 标出新鲜度,不把旧结论当当前事实 |
| out_of_scope | 有关但不在本轮范围内 | 明确排除,避免分析悄悄扩大 |
| assumptions | 为继续分析而暂时采用的假设 | 写出验证方式和失效条件 |
至少把输入版本、范围、环境、证据位置和负责人放在一起。没有运行记录时,只能交付分析、设计或验证计划,不能写执行通过。
从问题到结构化发现
先把来源、范围、证据状态、分析判断、责任角色、动作、关闭条件和验证方式连起来,再写结论。下面的案例保留这个 Skill 的专属编号和领域语境。
分层写法
围绕每项资产和信任边界,分开写事实、证据支持的推断、建议和人工决策:
| 层次 | 写法 | 本文应用 |
|---|---|---|
| 事实 | 材料直接显示了什么 | 引用来源中的重点、版本、输入或运行记录 |
| 基于证据的推断 | 多个事实共同支持的判断 | 说明推断链,并保留不确定性 |
| 建议 | 下一步最小动作是什么 | 指定补证、复核、执行或回归路径 |
| 人工决策 | 谁需要决定什么 | 由负责人确认范围、风险接受、资源和发布含义 |
一个完整案例
本节按输入、分析、发现、决策和验证展开;材料不足时保留 missing、conflicting 或 assumptions,不把它们改写成通过。
输入
| 材料 | 这次提供什么 | 缺失时的处理 |
|---|---|---|
| 系统范围 | 组件、数据流、角色、集成和环境 | 未提供路径保持开放 |
| 资产 | 客户数据、凭证、资金、可用性和审计记录 | 不要自推价值 |
| 信任边界 | 租户、网络、服务、权限、存储和第三方边界 | 边界证据要标出 |
| 缓解与假设 | 控制、依赖、负责人和安全验证 | 设计与执行分开 |
可以这样调用:
请使用 threat-modeling Skill。
任务:为多租户发票导出服务建模威胁,服务会把文件发送到对象存储并由客户门户下载。
输入材料:[数据流图、角色、存储策略、API 契约、租户规则和审计设计]
范围:[创建导出、存储、下载和删除]
限制:[数据脱敏、不使用真实凭证或 API 调用]
覆盖资产、信任边界、攻击面、威胁场景、缓解措施、假设、证据状态、负责人、关闭条件和安全验证。
分析
先根据输入、检查矩阵和证据状态整理判断,再进入发现;缺失材料保留为缺口。
发现
聚焦例子:建模发票下载中的跨租户访问
门户从浏览器接收导出 ID,但设计没有说明 API 是否把导出所属租户与会话租户对比。这个 Skill 应建模跨租户访问场景,把它连接到授权控制和审计证据,并建议合成租户验证;不应对生产发起访问尝试。
可以把这条场景写成一张 THM-01 威胁卡。下表是基于上述设计缺口的示意记录,不表示发现了真实漏洞或执行过验证:
| 字段 | 示例记录 |
|---|---|
| 资产与路径 | 发票导出文件;浏览器提交导出 ID,门户 API 读取对象存储中的文件 |
| 触发条件与前提 | 租户 A 的已登录用户提交属于租户 B 的导出 ID;适用的访问规则必须来自已提供的策略 |
| 边界与候选威胁 | 门户 API 到对象存储的读取路径;当前设计未说明 API 如何将会话租户与文件所有者绑定 |
| 已有控制与证据 | 当前未提供授权规则、对象所有权字段和服务端审计记录;是否存在相应控制仍待确认 |
| 影响与状态 | 若缺少所有权校验,可能造成跨租户发票数据暴露;目前是 missing 的设计证据,不是漏洞确认。项目风险分级标准尚未提供,因此优先级待定 |
| 预期结果与证据 | 如果来源策略要求租户隔离,就应拒绝该请求,并保留服务端决定和审计记录;本文没有提供这项策略,因此只能先把它列为待确认的预期结果 |
| 负责人和关闭条件 | 由安全或服务负责人确认规则;规则来源、负责人和隔离验证结果都可复核后,才关闭这项发现 |
| 下一步验证 | 负责人确认规则后,在隔离环境用两个合成租户验证允许与拒绝路径,并留存请求范围、服务端决定和审计证据 |
| 停止条件 | 如果检查离开隔离环境、接触到真实租户数据或超出批准范围,就停止,保留证据并交由负责人处理 |
如果租户身份如何进入服务端、文件如何绑定所有者、拒绝后是否读取或返回了对象等细节没有来源,就先把它们标成缺口;不要把假定的组件或控制画进数据流图。
模型可以整理安全上下文和假设,不能证明漏洞、利用成功、缓解有效或发布安全。
示例发现:把一次问题写成可交接动作
下面的字段示例只展示记录方式,不代表真实环境已经执行。
如果现有材料不足以判断某项资产或信任边界的风险,可以按这个格式写发现。不要补造缺失规则,也不要把证据缺失直接判成失败。
| 字段 | 示例写法 |
|---|---|
| 来源与范围 | 记录本轮使用的需求、版本、环境和资产与边界的具体对象 |
| 发现 | 资产与边界的判断条件或结果仍缺少可追溯依据 |
| 证据状态 | missing / assumptions;如果来源相互矛盾则改为 conflicting |
| 影响与优先级 | 说明会影响哪个用户、链路或交付决定,不凭感觉扩大等级 |
| 负责人和人工决策 | 由业务、开发、安全或测试负责人确认规则和风险取舍 |
| 动作与关闭条件 | 补齐最小证据;关闭条件是来源、判断和责任人都能复核 |
| 验证 | 指定一次可重复的检查、查询或运行,并保存原始产物 |
将威胁卡和它对应的数据流、控制证据一起交给负责人复核;攻击分类本身不能作为关闭理由。
决策
模型可以提出候选验证,但剩余风险接受和发布判断须由有责任的安全或业务负责人确认。
验证
关闭前按发现中的验证方式执行,并保留原始产物;没有执行记录时,状态仍然保持未验证。
发现如何进入下一阶段
交接产物
| 产物 | 要回答的问题 | 示例状态 |
|---|---|---|
| 资产与边界 | 保护什么、信任在哪里变化 | 来源与适用性 |
| 威胁场景 | 角色、路径、前置、影响和缓解 | 证据状态 |
| 假设缺口 | 模型依赖但没有证明的内容 | 负责人问题 |
| 验证动作 | 高风险场景的安全检查 | 隔离与停止条件 |
每条结论都应该能回到来源、证据状态和下一步动作。材料不足时使用 pending、blocked、未评估或 NOT_SCORED,不要用自信填空。
下一步路由
至少交付来源、证据状态、负责人、关闭条件和验证动作;下一阶段的结论仍受证据状态约束。
怎样准备更好的输入
提供最新数据流图、资产、角色矩阵、信任边界、版本、集成、缓解措施、负责人和安全验证环境。密钥和个人数据要脱敏。
交接时至少保留输入版本、范围、时间窗口、证据索引、假设、人工决策边界和最小验证动作。
实践建议
- 先看影响大、难发现、涉及权限或敏感数据的路径。
- 使用脱敏材料;候选验证应限制权限、放在隔离环境中,并且可以撤销。
- 每条结论都要能追溯到来源和信任边界;威胁分类名称本身不能证明攻击路径存在。
和其他 Skill 怎么配合
- 安全需求复核: https://inaodeng.com/zh-cn/qaskills/security-requirement-review/;把保护目标变成可测试条件。
- 授权测试: https://inaodeng.com/zh-cn/qaskills/authorization-testing/;在批准环境验证访问决定。
- 敏感信息暴露审查: https://inaodeng.com/zh-cn/qaskills/secrets-exposure-review/;检查凭证和日志暴露。
容易踩的坑
- 列出类似 STRIDE 的威胁,却不关联资产、边界和证据。
- 设计中出现控制名称,就假设控制已经存在。
- 为了让模型完整而读取凭证或探测生产。
安装与调用
npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh --skill threat-modeling
请使用 threat-modeling Skill。
提供目标、范围、版本、证据路径、限制和决策边界。
先审计输入,保留证据状态,最后给出负责人、关闭条件和验证方式。
常见问题
威胁模型能直接发现漏洞吗?
它识别场景和证据缺口,漏洞验证是另外需要授权的活动。
数据流图不完整怎么办?
先输出受限模型,标记未知边界,并请求最小缺失数据流或负责人决定。
参考
源 Skill 与执行契约
完整执行规则见威胁建模提示词: https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/threat-modeling/prompts/threat-modeling.md。源目录: https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/threat-modeling 中还可能包含评测用例和补充材料。
静态计划、文件存在和模拟运行保留原有证据状态,不能变成运行时证明、全部通过结论或发布批准。
延伸阅读
- 威胁建模详情页: https://inaodeng.com/zh-cn/qaskills/threat-modeling/
- Awesome QA Skills 项目: https://github.com/naodeng/awesome-qa-skills
更多参考
- 个人网站链接:https://inaodeng.com/zh-cn/
- 微信公众号:软件测试同学
- AI 生成测试检测项目:https://github.com/AI-Native-QA-Lab/ai-test-auditor
- DeepSeek QA 工作台项目:https://github.com/naodeng/dsh-qa
- 更多 AI 测试技能:https://inaodeng.com/zh-cn/qaskills/
- 更多测试百科:https://inaodeng.com/zh-cn/wiki/
- 更多 AI 百科:https://inaodeng.com/zh-cn/AIWiki/