テスト証拠の管理履歴とは何ですか?
テスト証拠の管理履歴とは、テスト結果とそのファイルが実行後に変更されていないことを証明する記録です。Verdict System LLC の Nexus StudioQA では、任意で有効にできる追記専用の台帳でこれを管理します。証拠フォルダー内の各ファイルを SHA-256 でハッシュ化し、直前の記録と連結するため、検証時に最初に変更された記録を特定できます。
最終更新日:
執筆: Verdict System LLCのNexus StudioQAチーム。
チームにとってなぜ必要なのですか?
失敗したテストは、不具合報告やリリースの判断、監査項目につながります。数週間後に、その画像と報告書が実行時に生成されたものと同じかどうかを問われるかもしれません。ディスク上のフォルダーだけでは何も証明できません。中のどのファイルも編集できるためです。管理履歴があれば、誰でもコマンドを1つ実行するだけで、変更の有無と変更された記録を確認できます。
どのような仕組みですか?
- 1つの記録は、metadata.json を含む証拠フォルダーです。たとえば、BREACHED の実行で報告書、画面の画像、ログとともに残されるフォルダーがこれに当たります。
- フォルダー内の各ファイルは SHA-256 でハッシュ化され、記録のハッシュには直前の記録のハッシュも含まれます。1つのファイルの1バイトでも変更すると、その記録とそれ以降のすべての記録の整合性が崩れます。
- 記録は、証拠と並べて配置された追記専用の単一台帳
evidence/chain-of-custody/ledger.jsonlに保存され、切り詰められることはありません。Node.js 標準の crypto のみを使用し、お使いの端末上で動作します。 - 封印は任意で有効にできます。Studio で初めて「実際の不具合」または「誤検知」と判定すると、その理由とともに記録が連結され、封印が始まります。
nexus verify --sealでも開始できます。 - 台帳がない場合、検証は UNVERIFIED を報告して失敗します。証拠がないことは証明にはならないため、何も知らせずに OK を返すことはありません。
実際の実行ではどのように表示されますか?
これは、2026-11-06 に記録された、エンジン自体のコマンドの出力です。対象は、Chromium で BREACHED となった実行と Firefox で TIMEOUT となった実行の2つの証拠フォルダーです。3番目と4番目のコマンドの間に、TC101 の report.md の1行を手動で編集しました。
> nexus verify
🔗 Nexus StudioQA — Evidence Chain of Custody (SHA-256, on-prem)
⚠️ UNVERIFIED — no ledger — run `nexus verify --seal` first (UNVERIFIED, not OK)
> nexus verify --seal
✅ SEALED 2 record(s) → evidence\chain-of-custody\ledger.jsonl
tip: bcc9f551e102aa6b0593bbab23e794d2da62934d58dcd27464fa322962338571
> nexus verify
✅ VERIFIED — verified 2 record(s), all artifacts intact
(report.md of TC101 edited by hand)
> nexus verify
❌ TAMPER DETECTED — evidence altered after sealing at record 0: TC101_chromium_2026-11-06_10-15-02 [BREACHED]
record: TC101 / chromium [BREACHED] — TC101_chromium_2026-11-06_10-15-02 [BREACHED]
検証の終了コードは、未検証では 2、検証済みでは 0、編集を検出した場合は 1 でした。このため、改ざんを検出したときに CI ジョブを失敗させることができます。
4つの状態とは何ですか?
| 状態 | 意味 | 必要な対応 |
|---|---|---|
| UNVERIFIED | 台帳がまだないため、何も証明できません | 封印するか、初めての「実際の不具合」または「誤検知」の判定を行います |
| VERIFIED | 封印済みのすべての記録とファイルが、それぞれのハッシュと一致しています | 対応不要 |
| TAMPER DETECTED | 封印後にファイルまたは台帳の行が変更されています。整合性が崩れた最初の記録が示されます | そのフォルダーを信頼できるコピーと比較します |
| PURGED | 封印済みのフォルダーが意図的に削除されており、削除した人と日時が台帳に記録されています | 対応不要です。台帳は引き続き、そのハッシュ値を証明します |
古い証拠を削除するとどうなりますか?
ディスク容量制限、保存期間、または「ディスク領域を解放」によって封印済みフォルダーを削除する前に、エンジンは削除した人と日時を示す PURGE 項目を台帳に追記します。その後の検証では、その記録を改ざんではなく PURGED として報告します。台帳に PURGE を記録できない場合、フォルダーは削除されません。容量制限については、保存領域と自動保守で説明しています。
制限事項には何がありますか?
- 封印後にファイルが変更されていないことを証明します。封印前に正しかったことまでは証明しません。編集後に記録を封印した場合は、その編集内容が封印されます。
- 対象は封印済みの記録のみです。最初の封印より前に書き込まれた証拠は、封印するまで UNVERIFIED のままです。
- 台帳は証拠と同じディスクに保存されます。両方に書き込める人は連鎖全体を再構築できるため、封印時に表示される末尾のハッシュを課題票やリリースノートなどの別の場所に保管し、後で比較してください。
どこで確認できますか?
証拠のページでは、失敗した1つのテストが残すファイルをすべてたどります。用語集では、UNVERIFIED と「実際の不具合」または「誤検知」の判定を定義しています。無料試用版では、ご自身のテストで同じエンジンを実行できます。