威奇普洛斯

其他 社区

技能解读

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

关键概念

概念 · 描述 测试向量 · 用于验证加密实现正确性的输入/输出对 测试组 · 共享属性(密钥大小、IV 大小、曲线)的测试向量集合 结果标志 · 指示测试是否应通过(有效)、失败(无效)或可接受 边缘情况测试 · 测试已知漏洞和攻击模式

为什么这很重要

众所周知,密码实现很难正确实施。即使是小错误也可能: 暴露私钥 允许签名伪造 启用消息解密 当不同的实现接受/拒绝相同的输入时产生共识问题

何时使用

在以下情况下应用 Wycheproof: 测试加密实现(AES-GCM、ECDSA、ECDH、RSA 等) 验证加密代码是否正确处理边缘情况 针对已知攻击向量验证实现 为加密库设置 CI/CD

快速参考

场景 · 推荐方法 · 注释 AES-GCM 实现 · 使用 aes_gcm_test.json · 44 个测试组的 316 个测试向量 ECDSA 验证 · 对特定曲线使用 ecdsa_*_test.json · 测试签名延展性、DER 编码 ECDH 密钥交换 · 使用 ecdh_*_test.json · 测试无效曲线攻击 RSA 签名 · 使用 rsa_*_test.json · 测试填充预言机攻击

存储库结构

Wycheproof 存储库的组织方式如下: 基本文件夹是 testvectors 和 testvectors_v1。虽然两者都包含类似的文件,但testvectors_v1包含更详细的信息,建议用于新集成。

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

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

01
第 1 阶段:将 Wycheproof 添加到您的项目中

选项 1:Git 子模块(推荐) 将 Wycheproof 添加为 git 子模块可确保自动更新: 选项 2:获取特定测试向量 如果无法使用子模块,请获取特定 JSON 文件:

02
第 2 阶段:解析测试向量

确定算法的测试文件并解析 JSON:Python 示例:JavaScript 示例:

03
第 3 阶段:编写测试工具

创建处理有效和无效测试用例的测试函数。 Python/pytest 示例: JavaScript/Mocha 示例:

04
第四阶段:CI 集成

通过以下方式确保测试向量保持最新: 使用 git 子模块:在运行测试之前更新 CI 中的子模块 获取最新向量:在测试执行之前运行获取脚本 计划更新:设置每周/每月更新以捕获新的测试向量

讨论

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