ベンダーのためのソフトウェアバージョン管理のベストプラクティス | Versio.io

ソフトウェアのバージョン管理に関するベストプラクティス

ソフトウェアベンダーに向けた、製品名、バージョン識別子、ライフサイクルデータ、および脆弱性アドバイザリに関する5つの推奨事項

要するにデモをリクエストする無料トライアルを開始する
 

バージョン識別子が重要な理由

バージョン識別子は、単なるダウンロードページのラベル以上のものです。これは、インストールされた製品と、そのrelease日、サポート期間、および既知の脆弱性をつなぐ鍵となるものです。 この鍵に曖昧さがあれば、それに依存するあらゆるプロセスの信頼性が損なわれます。脆弱性スキャナーが誤検知を報告したり、さらに悪い場合には実際の脆弱性を見逃したり、end-of-life警告が遅れて届いたり、パッチ適用に関する判断が推測に基づいて行われたりすることになります。
1つの製品、5つの名称:Brave バージョン 1.97.56 がリリースされ、Release notes、Windows、macOS、Linux パッケージ、および NVD CPE 辞書において、それぞれ異なる製品名とバージョンが記載されている
X1つの製品、5つの名称:Brave バージョン 1.97.56 がリリースされ、Release notes、Windows、macOS、Linux パッケージ、および NVD CPE 辞書において、それぞれ異なる製品名とバージョンが記載されている
Versio.io は、数千もの製品に関する end-of-life 情報およびバージョンデータベースを管理しており、これを顧客環境で検出されたソフトウェアのバージョンと毎日照合しています。 その過程で、一意に特定できない製品やバージョンに頻繁に遭遇します。例えば、同じ製品名に複数の表記がある場合、ウェブサイト、インストーラー、パッケージマネージャー間でバージョン識別子が異なる場合、日付の記載がない release 履歴、あるいは「古いバージョン」としか記載されていない vulnerabilities アドバイザリなどが挙げられます。
 

さっと確認:あなたの製品は、どれほど特定しやすいでしょうか?

ご自身の製品に該当する項目にチェックを入れてください。各項目については以下で詳しく説明しています。矢印をクリックすると、該当する推奨事項に直接移動します。
 
以下の推奨事項は、ソフトウェアベンダーを対象としています。これらは意図的にシンプルにまとめられており、導入コストもほとんどかからず、貴社の製品を使用または監視するすべての人々の役に立ちます:
  • 顧客およびOperator - 自分のインストール環境が最新かどうか、引き続きサポートされているかどうか、また vulnerabilities の影響を受けているかどうかを一目で確認できます。
  • 脆弱性スキャナ - CVEを、誤検知や検知漏れなしに、インストール済みのバージョンと正確に照合することができます。
  • end-of-lifeモニタリング - サポートの終了を事前に知らせることができます。
  • CMDBと資産管理 - バージョンを一貫性を持って、かつ監査に耐えうる形で記録することができます。
  • ベンダー自身 - サポート依頼の件数を減らし、「サイバーレジリエンス法(CRA)」などの規制要件(SBOM、サポート期間、脆弱性の対応など)を満たすことができます。
 

1. 製品名およびベンダー名を一意に定義する

バージョンを割り当てる前に、そのバージョンがどの製品に属するかを明確にする必要があります。したがって、ベンダーは製品名を1つ、ベンダー名を1つ正確に定義し、ウェブサイト、インストーラー、パッケージのメタデータ、バージョン履歴、およびvulnerabilitiesアドバイザリなど、あらゆる場所でそれらを一貫して使用する必要があります。
同じ製品が「Brave」、「Brave-Browser」、「Brave Browser」という形で表示される場合、各ツールはこれらが1つ、2つ、それとも3つの製品であるかを判断しなければなりません。これは、「Example」、「Example Ltd」、「Example Software Ltd」といったベンダー名についても同様です。 バリエーションごとに、インベントリ、SBOM、脆弱性データベースに追加のエントリが生成され、バージョンやCVEの照合時に潜在的な不整合が生じる可能性があります。
  • ✅ - Canonical製品名およびCanonicalベンダー名を、綴り、スペース、ハイフン、大文字小文字の区別を含めて定義してください。
  • ✅ - 異なる製品名は、実際に異なる製品(例:サーバーとそのクライアント)にのみ使用してください。
  • ✅ - 製品やベンダーの名称が変更された場合は、バージョン履歴に旧名称と変更日を記録してください。
  • ❌ - プラットフォーム、インストーラー、またはダウンロードページによって、同じ名称のバリエーションが存在します。
 

2. セマンティック・バージョニングに従う

製品のバージョン番号は、可能な限りセマンティック・バージョニング(SemVer)に準拠する必要があります:MAJOR.MINOR.PATCH、例:4.2.1。 MAJORバージョンは互換性のない変更があった場合に増やし、MINORバージョンは下位互換性のある新機能が追加された場合に増やし、PATCHバージョンは下位互換性のあるバグ修正が行われた場合に増やします。 release版およびビルドメタデータは、定義された形式で末尾に付加されます。例:4.3.0-rc.1 または 4.2.1+build.5821。
SemVerは広く採用されており、ソートが可能で、製品に関する特別な知識がなくてもツールで解析できます。そのルールにより、更新による影響がバージョン番号そのものに明確に反映されます。 カレンダー方式のバージョン管理(例:2026.10.1)など、別の方式を使用する場合は、その方式を文書化し、すべてのreleaseで一貫して適用する必要があります。
  • ✅ - 製品ごとに技術バージョンの体系を1つだけ使用し、それを文書化してください。
  • ✅ - 常に同じ桁数のバージョン番号を使用してください。たとえば、「5」、「5.0」、「5.0.0」と使い分けるのではなく、一貫して「5.0.0」のように表記してください。
  • ✅ - 公開する各ビルドには、必ず1つのバージョンを割り当て、別のビルドで同じバージョンを再利用してはなりません。
  • ❌ - 技術的なバージョン番号を伴わないマーケティング名称(例:「Spring Release」や「2026 R2」など)。マーケティング名称が必要な場合は、それぞれを技術的なバージョン番号と一意に紐づけてください。
  • ❌ - 先頭のゼロ、パッチレベルを表す文字(例:3.1b)、および区切り記号の変更(例:同じreleaseでも 3.1-2 と 3.1.2)。
 

3. バージョン履歴をオンラインで公開する

ベンダーは、すべての製品バージョンとその履歴をオンラインで公開すべきです。各バージョンについて、そのリストには、製品に表示されている通りの文字単位で正確なバージョン識別子と、release日が記載されている必要があります。 理想的には、メンテナンス終了日(バグ修正が終了する日)およびサポート終了日またはend-of-life日(セキュリティ更新プログラムの提供が終了する日)、Release notesへのリンク、ならびに修正された脆弱性に関する注記も記載されるべきです。
  • 完全性 - パッチリリースやホットフィックスを含め、すべてのバージョンを一覧表示してください。サポートが終了した古いバージョンであっても、一覧から削除しないでください。
  • 明確な日付 - 03/04/2026 と 04/03/2026 の混同を防ぐため、ISO 8601 日付形式(YYYY-MM-DD)を使用してください。
  • 固定URL - バージョン履歴のアドレスを安定させておき、自動的に参照・監視できるようにしてください。
  • 機械可読形式 - さらに、バージョン履歴をJSONまたはXML形式で、できればAPIやフィードを通じて提供してください。
  • CPEマッピング - 機械可読形式のバージョン履歴に、製品の共通プラットフォーム列挙(CPE)識別子を明記してください。これにより、National Vulnerability Database(NVD)などの脆弱性データベースとの照合を、推測に頼ることなく行うことができます。
機械可読なバージョン履歴があれば、顧客やツールベンダーは、HTMLページから情報を読み取る代わりに、新しいreleasesを自動的に処理することができます。簡単な例を挙げると:
version-history.jsonJSON
{
	"product": "Example Server",
	"vendor": "Example Ltd",
	"cpe": "cpe:2.3:a:example:example_server:*:*:*:*:*:*:*:*",
	"versions": [
		{
			"version": "4.2.1",
			"releaseDate": "2026-09-15",
			"endOfMaintenance": "2027-09-30",
			"endOfSupport": "2028-03-31",
			"releaseNotes": "https://www.example.com/release-notes/4.2.1",
			"fixedVulnerabilities": [ "CVE-2026-12345" ]
		},
		{
			"version": "4.2.0",
			"releaseDate": "2026-07-01",
			"endOfMaintenance": "2027-09-30",
			"endOfSupport": "2028-03-31",
			"releaseNotes": "https://www.example.com/release-notes/4.2.0"
		}
	]
}
 

4. インストール済みの製品およびバージョンを検索可能にする

製品がインストールされた後は、オペレーティングシステムのパッケージマネージャーまたはコマンドラインを使用して、その製品名、ベンダー名、およびバージョンを照会できる必要があります。 返される値は、公開されている製品名、ベンダー名、およびバージョン識別子と完全に一致している必要があります。そうして初めて、手動での解釈を必要とせずに、インストールをバージョン履歴や脆弱性アドバイザリと照合することが可能になります。
  • リナックス - パッケージのメタデータ(たとえば、RPM パッケージの「Name」、「Vendor」、「Version」フィールドなど)に、正確な製品名、ベンダー名、およびバージョンを登録してください。これらは、`rpm -q` または `dpkg -s` コマンドで照会できます。
  • Windows - アンインストール用のレジストリキーおよびファイルのバージョン情報には、公開された製品名を「DisplayName」として、ベンダー名を「Publisher」として、バージョンを「DisplayVersion」として指定するか、winget を通じて指定してください。
  • macOS - Info.plist 内の CFBundleName および CFBundleShortVersionString を、公開する製品名とバージョンに設定してください。また、Homebrew パッケージには同じ名前とバージョンを指定してください。
  • コマンドライン - --version オプションをサポートし、解析可能な形式で正確なバージョンを出力するようにしてください。
  • 機器、container、およびサービス - APIエンドポイント、SNMP値、またはイメージラベル(例:org.opencontainers.image.version)を通じてバージョンを提供してください。
コマンドラインbash
$ example-server --version
4.2.1
よくあるエラーの原因として、読み取る場所によって異なるバージョン識別子が挙げられます。たとえば、ウェブサイトではバージョン 24.2 と表示され、Windows レジストリには 24.2.0.1234 と表示され、コマンドラインでは「build 1234」と出力されるといったケースです。このような場合、各ツールはどの番号を指しているのかを推測しなければなりません。 内部ビルド番号が必要な場合は、バージョンを置き換えるのではなく、ビルドメタデータとして末尾に追加すべきです(例:24.2.0+1234)。
 

5. Vulnerabilitiesアドバイザリにおいて、正確なバージョンを明記する

When publishing vulnerabilities, it is essential to accurately specify the affected versions and corrected versions. Vague descriptions can lead to false positives, unnecessary emergency patches, and, in the worst case, overlooked vulnerabilities.
「4.0.0 から 4.2.0」といったバージョン範囲でさえ、解釈の余地が残されます。これを評価するには、読者はその間のすべてのバージョンを推測する必要があるか、あるいは最悪の場合、ホットフィックスや公式リリースリストに掲載されなかったビルドを含め、これまでにリリースされたすべてのバージョンを把握していなければなりません。 したがって、影響を受けるすべてのバージョンを明示的に列挙するのが最善です。
  • ❌ - 「最新 release 以前のすべてのバージョン」、「バージョン 3.x」、「旧バージョン」、または「詳細についてはサポートにお問い合わせください」。
  • ❌ - 「4.0.0 から 4.2.0」や「4.2.1 未満」といったバージョン範囲は、その間のすべてのバージョンを把握している必要があります。
  • ✅ - 影響を受けるバージョンをすべて明示的に列挙してください。例:「影響を受けるバージョン:4.0.0、4.0.1、4.1.0、4.1.1、4.2.0;修正済みバージョン:4.2.1」。
  • ✅ - サポート対象の各releaseラインごとに、固定バージョンを指定してください(例:3.8.7、4.2.1)。
  • ✅ - バージョン履歴およびインストール済みの製品と同じバージョン識別子を使用してください。
  • ✅ - アドバイザリを機械可読形式(例:CPEまたはパッケージURL(purl)識別子を含むCSAFドキュメントなど)で公開し、CVEレコードに影響を受けるバージョンを個別に記載してください。
 

詳細はこちら


Talk to me


Matthias Scholze
Matthias Scholze
Chief Technology Officer
P:  +49-30-221986-51
LinkedIn

 
 

詳細情報

 

We use cookies to ensure that we give you the best experience on our website. Read privacy policies for more information.