View on GitHub

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

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

GCVE-BCP-03 ― 分散型公開の標準

日本語訳についての注意

これは GCVE-BCP-03 “Decentralized Publication Standard” の非公式な日本語訳です。

対応する原文の版: v1.6(2026-09-15)/ コミット 721a3d1

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

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

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

Copyright (C) 2025-2026 GCVE Initiative.

はじめに

この文書は、GNA が、集中型のシステムに頼らず、自らの脆弱性情報を直接公開できる、分散型の公開モデルを記述します。

また、GNA が、公開した脆弱性を、さまざまな仕組みで配布するために使う、アクセス方法も概説します。

クライアントは、この BCP 文書に基づいて、GNA が公開した脆弱性を取得できます。

仕組み

分散型モデルは、各 GNA が、自らの公開プロセスを完全に制御する、という原則に基づいています。そのうえで、GCVE ディレクトリは、信頼できる GNA の集合から脆弱性情報を収集するために使うエントリーポイントを、見つける方法を提供します。これにより、利用者は、誰を信頼し、誰から脆弱性情報を取得するかを、自分で決められます。

リファレンス実装

オープンソースプロジェクトの Vulnerability-Lookup には、この BCP に対応したリファレンス実装があります。分散型の公開にも、GCVE ディレクトリに掲載されているすべての GNA から脆弱性情報を収集することにも、使えます。

GCVE の分散型公開モデルの概要

伝送

脆弱性情報の収集に使う伝送の仕組みは、HTTP に基づいており、1 つの URL を通じて、2 つのアクセスモードが公開されます。1 つ目は、シンプルな REST API で、特定の日付以降、またはデータセット全体のページネーションによって、公開された最新の脆弱性を取得できます。もう 1 つは、脆弱性ファイルを提供する、静的なエンドポイントです。GNA は、どちらか一方、または両方の伝送方法を使えます。

この URL は、GCVE ディレクトリの gcve_pull_api フィールドで参照されます。

HTTP REST API

API のベース URL は、gcve_pull_api フィールドで定義され、少なくとも次のエンドポイントに対応しなければなりません。

完全な URL は、GCVE ディレクトリの gcve_pull_api フィールドの値から組み立てます。

デフォルトでは、このエンドポイントは、ローカルの GNA の脆弱性だけを、GCVE-BCP-05 の形式で返さなければなりません(MUST)。加えて、ローカルの GNA が返すデータを、クライアントが絞り込めるように、任意のフィルターの集合を、利用できるようにしなければなりません(MUST)。

フィルタリングとページネーションを使った、脆弱性の取得

このエンドポイントは、任意のフィルタリングとページネーションを使って、脆弱性を取得します。

動作
クエリパラメーター
source : str

脆弱性を絞り込むために使う、任意のソース(例: CVE、GHSA、PySec)。

per_page : int, default=30

結果の最大件数。上限は 100。

date_sort : str

並べ替えに使うフィールド。

サポートされる値:

sort_order : str

並べ替えの順序。

サポートされる値:

since : str

指定した日付以降に公開または更新された脆弱性を取得します。

page : int

ページネーションのページ番号。

cwe : str

特定の CWE ID で脆弱性を絞り込みます。

product : str

脆弱性を絞り込むために使う、任意の製品名(大文字小文字を区別しない)。

設定すると、エンドポイントは、すべてのベンダーにわたって、この製品に関連する脆弱性を返します。結果をさらに絞り込むには、assigner と併用します。

assigner : str

結果を絞り込むために使う、任意の assigner の短い名前(大文字小文字を区別しない)。

このフィルターは、product または vendor と併用した場合にのみ有効です。

戻り値

list[dict[str, Any]] | list[tuple[str, str | None]]

次のどちらかを返します。

静的ファイル

静的エンドポイントの完全な URL は、GCVE ディレクトリの gcve_pull_api フィールドの値から組み立てます。

security.txt ファイルで、GCVE フィールドを使って、GCVE の公開エンドポイントを宣言できます。

形式

後述の GCVE 固有の任意性を除いて、形式は、CVE Record Format スキーマに記載された CVE レコード形式に従わなければなりません。

CVE Services のアカウントなしで GNA を立ち上げる場合、組織は、CVE レコード形式が継承している、CVE プログラムの組織識別子を、取得したり提供したりする必要はありません。cveMetadata.assignerOrgId、containers.cna.providerMetadata.orgId、containers.cna.providerMetadata.shortName などの、組織のメタフィールドは、GCVE では任意(OPTIONAL)であり、利用できない場合は、省略してもかまいません(MAY)。GNA とそのレコードは、GNA 識別子と、GCVE 固有のメタデータによって、帰属を特定できます。そのため、これらの CVE Services の値がなくても、GCVE エコシステムでの公開は妨げられません。

詳細な形式は、GCVE-BCP-05 で規定されています。特に、CVE レコード形式との互換性を確保しつつ、GCVE が必要としうる拡張フィールドにも対応するためです。

サービスの例

GNA-1 は、クライアントのクエリとテストに使える、リファレンスサービスを提供しています。