Project Wycheproofは、暗号ライブラリの開発者が既知の攻撃、仕様の不整合、その他さまざまな実装バグに対してテストするために使用できるテストベクターのコミュニティ管理リポジトリです。
テストベクターはJSONテストベクターデータとして維持されており、テストベクターデータの構造を文書化したJSONスキーマファイルが付属しています。
pyca/cryptographyなどの他のプロジェクトがWycheproofのテストベクターをどのように統合しているかを調べると参考になるかもしれません。
Project Wycheproofには、以下を含む最も一般的な暗号アルゴリズムのテストベクターがあります
テストベクターは、以下を含む多くの攻撃に対してライブラリが脆弱かどうかを検出します
新しいテストベクターデータやアルゴリズムのコントリビューションを歓迎します。
コントリビュートしたい場合は、CONTRIBUTINGをお読みのうえ、プルリクエストをお送りください。バグの報告や新しいテストのリクエストはGitHub issuesで行うこともできます。
私たちは、テストベクターデータに重点を置いて、Project Wycheproofの開発とメンテナンスをC2SPプロジェクトとして活性化させる作業を進めています。
当面の優先事項は、テストベクターデータにアルゴリズムとテストケースのカバレッジを追加することです。
Project Wycheproofは、世界で最も低い山であるMount Wycheproofにちなんで名付けられました。プロジェクト創設時の主な動機は、達成可能な目標を持つことでした。山が低ければ低いほど、登頂できる可能性が高くなります。
Wycheproofのテストベクターは、いくつかの重要な暗号プロジェクトやライブラリで何らかの形で使用されています。特に順序はありませんが、以下が含まれます:
あなたのプロジェクトが Wycheproof のテストベクターを使用している場合は、ぜひ PR を開いて上記のリストに追加してください!
Wycheproof のテストハーネスやテストベクターデータを使用して発見された注目すべき過去のバグについては、doc/bugs.md を参照してください。
testvectors/ ディレクトリはどこにありますか?最近、testvectors/ と testvectors_v1/ のディレクトリを、スキーマに対する一貫したアプローチを備えた単一の統合ディレクトリに統合しました。
元の("v0")テストベクターデータが必要なユーザーは、wycheproof-v0-vectors タグからこのリポジトリをクローンできますが、今後の更新の恩恵を受けるために testvectors_v1/ を使用するよう更新することをお勧めします。testvectors/ にあって testvectors_v1/ にない機能やテストカバレッジがある場合、または更新を妨げる別の問題がある場合は、必要な内容を記載した issue を開いてください。
ファイル、フォーマット、型 に関するいくつかのレガシーなドキュメントが利用可能ですが、現在のテストベクターの状態と必ずしも同期しているわけではありません。
一般に、スキーマファイル を参照することを推奨します。これらはベクターファイルの内容が公表されたスキーマと一致することを保証するために CI でテストされているためです。
歴史的に、Wycheproof にはさまざまな攻撃を実装に対して直接テストするテストハーネス(Java や Javascript の暗号実装向けなど)も含まれていました。コミュニティサポートへの移行に伴い、これらのハーネスは削除されました(ただし、興味のある方は git 履歴の cd27d64 にまだ存在します)。現在は実装に依存しないテストベクターに注力しています。
サードパーティの暗号ライブラリを直接テストするということは、欠陥がテスト対象プロジェクトによってコミットされ、場合によってはリリースされた後に初めて発見されることを意味します。代わりに、ダウンストリームのプロジェクトが開発プロセスの一環として Wycheproof のテストベクターを使用して定期的にコードをテストすることを推奨しています。このアプローチは、欠陥が CVE になる_前に_発見するのに役立ち、新機能が即座にテストされ、メンテナンスの負担を分散させるのにも役立ちます。これにより、Wycheproof のメンテナーは、増え続ける言語やプロジェクト固有のテストハーネスを維持しながら多数のプロジェクトのダウンストリーム開発を追跡するのではなく、テストベクターに集中できるようになります。
テストハーネスに関心のある方は、Daniel Bleichenbacher による Rooterberg での継続的な取り組みが参考になるかもしれません。
Copyright 2016-2026 The Wycheproof Authors、Apache License 2.0 の下で提供されています。
Project Wycheproof は元々、次の者によって作成され、維持されていました: