バージョンと変更履歴
このページでは、ホワイトペーパーのドキュメントについて、バージョンごとの変更と概要を記録します。各変更には、変更の範囲、影響を受ける章、関係するクレーム ID、そして(該当する場合は)実装バージョンや cryptoVersionとの関係を明記する必要があります。
記録の基準
- バージョン番号:セマンティックバージョニング(例:
v1.0、v1.1)または日付によるバージョニング(例:2026-01)を推奨します。 - 変更の種類:追加(Added)/変更(Changed)/修正(Fixed)/廃止予定(Deprecated)/削除(Removed)。
- 追跡可能性:各変更は、該当する章とクレーム IDにリンクします。クレームの文言を変更した場合は、総覧と同期します。
- 実装との関係:ドキュメントに記載した実装が変わる場合(暗号パラメーター、トークンのスコープ、ログポリシーなど)は、対応するクライアント/サーバーのバージョンまたは適用日を記載します。
変更ログ
以下の表は、保守しやすい最小限の構成です。リリースの周期に合わせて、日付、バージョン、概要を更新してください。内部のバージョン番号を公開していない場合は、日付によるバージョニングを使用してください。
| 日付 | ドキュメントのバージョン | 変更の概要 | 対象の章 | 関連するクレーム ID |
|---|---|---|---|---|
| 2026-01-14 | v1.0 | セキュリティとプライバシーのホワイトペーパー(章ごとの分割版)の初回リリース。対象範囲と脅威モデル、アーキテクチャと認証、暗号と鍵管理、プライバシーとゼロナレッジ、Webセキュリティ、 ログとインシデント対応、脆弱性の開示、証拠とステータス、クレーム ID総覧、用語集を収録。 | 概要 + 第1~12章 + 付録 | 総覧を参照 /security-privacy-appendix-claim-ids |
| YYYY-MM-DD | v1.1 | 例:第6~7章(データのライフサイクルと不正利用)を補足し、ダウンロードページのCSPとReferrer-Policyの例を更新し、監査フィールドの最小化を見直す。 | 第6、7、9、10章 | (例)DATA-*、ABUSE-*、WEB-*、LOG-* |
| YYYY-MM-DD | v1.2 | 例:新しいcryptoVersion(例:v2)を導入し、IV/AADの仕様と互換性を調整する。廃止までのスケジュールを追加する。 | 第5、11章 | (例)CRYPTO-*、VERSION-* |
運用上の提案
- 文言を変更する際は、クレーム ID(主張の内容や証拠へのリンク)への影響を確認してください。
- セキュリティに関する公開された約束に関わる大きな変更については、/status上の証拠や注記も同期することを検討してください。
- セキュリティインシデントを公表する場合は(攻撃面を広げない範囲で)、リリースの時期と影響範囲をここに記録し、公開されているインシデント声明(ある場合)にリンクしてください。