加密协议图

人工智能 社区

技能解读

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

何时使用

用户要求绘制、可视化或提取加密协议 输入是实现握手、密钥交换或多方协议的源代码 输入是 RFC、学术论文、伪代码或形式模型 (ProVerif/Tamarin) 用户命名特定协议(TLS、Noise、Signal、X3DH、FROST)

何时不使用

用户想要调用图、类层次结构或模块依赖关系图 — 使用 diagramming-code 用户想要正式验证协议 — 使用 mermaid-to-proverif (生成图表后) 输入没有加密协议语义(没有各方,没有消息交换)

拒绝的理由

合理化 · 为什么这是错误的 · 需要采取的行动 “协议很简单,我可以根据记忆绘制图表” · 基于内存的图表缺少步骤和反向箭头 · 系统地阅读源代码或规范 “因为代码存在,我将跳过规范路径” · 代码可能偏离规范 — 两条路径捕获不同的错误 · 当两者都存在时,首先运行规范工作流程,然后注释代码分歧 “加密注释是可选装饰” · 如果没有加密注释,图表只是一个消息流 —对安全审查无用 · 对每个密码操作进行注释

第 0 步:确定输入类型

在进行其他操作之前,请对输入进行分类: 信号 · 输入类型 源文件扩展名 (.py、.rs、.go、.ts、.js、.cpp、.c) · 代码函数/类定义、导入语句 · 代码 RFC 风格的节标题 (§、 Section X.Y、MUST/SHALL 关键字)·规格

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

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

01
第 0 步:确定输入类型

在进行其他操作之前,请对输入进行分类: 信号 · 输入类型 源文件扩展名 (`.py`、`.rs`、`.go`、`.ts`、`.js`、`.cpp`、`.c`) · 代码 函数/类定义、导入语句 · 代码 RFC 样式的节标题(`§`、`Section X.Y`、`MUST`/`SHALL`关键字)·规格

02
第 1 步:找到协议入口点

Grep 查找揭示协议的函数名称、类型名称和注释:从最高级别的编排函数开始读取 - 调用握手阶段或主协议循环的函数。

03
第 2 步:确定各方和角色

从以下位置提取参与者名称: `Client`、`Server`、`Initiator`、`Responder`、`Prover`、`Verifier`、`Dealer`、`Party`、`Coordinator` 携带状态的函数参数名称声明协议角色的角色注释

04
第 3 步:跟踪消息流

遵循状态转换和网络发送/接收。寻找如下模式: 模式 · 含义 `send(msg)` / `recv()` · 直接消息交换 `serialize` + `transmit` · 发送的结构化消息 返回值传递给对方的函数 · 逻辑消息(进程中)

05
第 4 步:注释加密操作

在每个协议步骤中,识别并标记: 操作 · 图注释 密钥生成 · `Note over A: keygen(params) → pk, sk` DH / ECDH · `Note over A,B: DH(sk_A, pk_B)` KDF / HKDF · `Note over A: HKDF(ikm, salt, info)`

06
第 5 步:确定协议阶段

使用`rect`或`Note`块将消息步骤分组为命名阶段: 要检测的常见阶段: 设置/密钥生成:参与方密钥创建、可信设置、参数生成 握手/初始化:临时密钥交换、随机数交换、版本协商 身份验证:身份证明、证书交换、签名验证

07
第6步:生成序列图

按照references/mermaid-sequence-syntax.md 中的规则生成 Mermaid 语法。完整性胜于简洁。显示每种不同的消息类型。省略重复的循环迭代(使用`loop`块代替),但永远不要省略不同的协议步骤。

08
第7步:验证并交付

在交付之前: [ ] 声明的每个参与者实际上发送或接收至少一条消息 [ ] 箭头指向正确的方向(发送者 → 接收者) [ ] 加密操作在正确的一方(计算它们的一方) [ ] 如果使用协议阶段,则阶段块之外不会出现箭头

讨论

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