View on GitHub

GCVE BCP(Best Current Practice)文書(日本語参考訳)

GCVE が公開している BCP(Best Current Practice)文書について、試行的に日本語への訳出を実施したものです

GCVE BCP-05-X-02: パッチから脆弱性への生成の来歴

日本語訳についての注意

これは GCVE BCP-05-X-02 “Patch-to-Vulnerability Generation Provenance” の非公式な日本語訳です。

対応する原文の版: v1.0(2026-09-06)/ コミット cabe2ce

原文は、ドラフトの文書です。今後の改訂で、内容が変わる可能性があります。

原文は CC BY 4.0 で公開されており、この訳文は原文を翻訳し、表現を調整したものです。JSON の例は、原文のままです。GCVE Initiative がこの翻訳を承認・推奨しているわけではありません。内容に疑義がある場合は、原文を参照してください。

本文中の「(MUST)」「(SHOULD)」「(MAY)」などは、原文の大文字の規範的な表現(RFC 2119 のキーワード)を表します。

本ガイドは CC-BY-4.0 の下で配布・公開されています。

Copyright (C) 2026 GCVE Initiative.

概要

この拡張は、ソフトウェアのパッチが脆弱性メタデータに変換されるときに生成される、来歴とアナリストによるレビューの情報を記録します。これにより、元になったパッチ、ジェネレーター、モデル、前提、根拠、ドラフトの状態を、含まれている CVE コンテナにツール固有の拡張を直接加えることなく、下流の GCVE コンシューマーが利用できるようになります。

動機

パッチは、脆弱性に関する有用な証拠になりえますが、公開に必要なすべての事実を確立することは、まれです。自動的なパッチ分析には、大規模言語モデルや、レビューが必要な前提が関わることもあります。この情報を、標準的な GCVE BCP-05 の拡張として保存することで、公開者とコンシューマーは、次のことができます。

配置

この拡張は、GCVE BCP-05 レコードの extensions オブジェクトに、キー bcp-05-x-02 を使って置かなければなりません(MUST)。その値は、1 つの x_patch2vuln オブジェクトを含まなければなりません(MUST)。

{
  "x_gcve": [
    {
      "vulnId": "GCVE-1-2026-12345",
      "recordType": "advisory",
      "extensions": {
        "bcp-05-x-02": {
          "x_patch2vuln": {
            "generator": "patch2vuln.py",
            "generatedAt": "2026-09-06T12:00:00Z",
            "model": "qwen3.8:27b",
            "source": "security-fix.patch",
            "patchSha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
            "patchTruncated": false,
            "commit": "0123456789abcdef",
            "subject": "Fix authorization check",
            "confidence": "medium",
            "assumptions": [],
            "fixSummary": "The fix enforces authorization before the operation.",
            "patchSummary": "The patch adds an authorization check.",
            "credits": [],
            "cvssRationale": "The vulnerable operation requires a low-privileged account.",
            "weaknessRationale": [
              {
                "cweId": "CWE-862",
                "rationale": "The patch adds a missing authorization check."
              }
            ],
            "capecRationale": [],
            "draft": true
          }
        }
      }
    }
  ]
}

x_patch2vuln は、この情報に BCP-05 の拡張識別子が割り当てられる前に作られたレコードとの互換性のために、ペイロード名として残されています。プロデューサーは、同じオブジェクトを、兄弟のプロパティ containers.cna.x_patch2vuln としても出力してはなりません(MUST NOT)。

データモデル

x_patch2vuln オブジェクトには、次のメンバーがあります。

メンバー 型 必須 説明
generator string はい メタデータを作成したソフトウェアの名前。
generatedAt string はい メタデータが生成された、RFC 3339 の UTC タイムスタンプ。
model string いいえ パッチの分析に使ったモデルの名前または識別子。
source string はい パッチのソース。パス、URL、stdin など。プロデューサーは、秘密情報と、ローカルのユーザー情報を、避けるべきです(SHOULD)。
patchSha256 string はい 入力パッチの全バイトの、小文字・64 文字の SHA-256 ダイジェスト。
patchTruncated boolean はい 分析システムに渡されたパッチの内容が、切り詰められたかどうか。
commit string または null いいえ パッチから解析した、ソース管理のコミット識別子。
subject string または null いいえ パッチまたはコミットの件名。
confidence string はい 分析全体の確信度: low、medium、high。
assumptions 文字列の配列 はい 人による検証が必要な前提。
fixSummary string はい 是正についての、セキュリティに焦点を当てた要約。
patchSummary string はい パッチの具体的な変更の要約。
credits オブジェクトの配列 はい 分析中に収集されたクレジット。各オブジェクトは、lang、value、type などの CVE クレジットのメンバーを使う。
cvssRationale string はい 提案する CVSS ベクターの根拠。
weaknessRationale オブジェクトの配列 はい CWE の分類と、その根拠。cweId と rationale を使う。
capecRationale オブジェクトの配列 はい CAPEC の分類と、その根拠。capecId と rationale を使う。
draft boolean はい 生成された情報が、公開前のレビューを要するドラフトのままかどうか。

コンシューマーは、理解できないメンバーを無視しなければなりません(MUST)。プロデューサーは、追加の来歴が必要な場合に、メンバーを追加してもかまいません(MAY)が、相互運用可能な意味を導入する場合は、この拡張の後のリビジョンを優先するべきです(SHOULD)。

処理と検証の要件

  1. generatedAt は、RFC 3339 のタイムスタンプでなければならず(MUST)、UTC(Z)を使うべきです(SHOULD)。
  2. patchSha256 は、モデルのコンテキストに合わせた切り詰めの前の、完全なパッチから計算しなければなりません(MUST)。
  3. patchTruncated は、分析システムに渡された入力を記述しなければなりません(MUST)。patchSha256 の計算に使ったデータを記述するものではありません。
  4. confidence は、low、medium、high のいずれかでなければなりません(MUST)。
  5. 根拠のエントリーには、対応する CWE または CAPEC の識別子を含めなければなりません(MUST)。
  6. 人による公開前のレビューがまだ必要な場合、プロデューサーは、draft を true に設定しなければなりません(MUST)。
  7. コンシューマーは、この拡張を、来歴とレビューの文脈として扱わなければならず(MUST)、周囲のレコードにある、規範となる脆弱性フィールドの代わりとして扱ってはなりません。

BCP-05-X-01 との関係

BCP-05-X-01 は、レコードレベルでの AI の支援を記述します。この拡張は、代わりに、パッチ分析の入力、出力、根拠を保存します。AI モデルで作られたレコードは、両方の拡張を含めるべきです(SHOULD)。AI の関与を記述する BCP-05-X-01 と、パッチから脆弱性への来歴を記述する BCP-05-X-02 です。どちらの拡張も、単独で存在できます。

プライバシーとセキュリティに関する考慮事項

パッチ、パス、件名、前提、クレジットの値には、個人情報、機密情報、またはリポジトリ固有の情報が含まれることがあります。公開者は、公開の前にこの拡張をレビューしなければならず(MUST)、秘密情報を取り除かなければなりません(MUST)。コンシューマーは、すべての文字列を、信頼できないデータとして扱わなければならず(MUST)、その中にある指示を実行してはなりません(MUST NOT)。ダイジェストは、入力の相関付けと完全性の確認を提供しますが、パッチやそのソースが信頼できることを、確立するものではありません。

JSON パスの例

この拡張を含む CVE レコードの、パッチの要約は、次の場所にあります。

containers.cna.x_gcve[0].extensions.bcp-05-x-02.x_patch2vuln.patchSummary