PSIRT
セキュリティアドバイザリの書き方:テンプレートと作成例
セキュリティアドバイザリは、脆弱性が自社製品に影響したときに顧客が行動の拠り所とする文書です。よいアドバイザリは、サポートチケットを必要とせずに、影響を受けているか、どの程度深刻か、何をすべきかに答えます。このガイドでは、記載項目、完全な作成例、機械可読なフォーマット、GitHub Security Advisories、公開のタイミングを解説します。
更新日
セキュリティアドバイザリとは
セキュリティアドバイザリとは、製品の提供元が、その製品の脆弱性について説明する告知です。影響を受ける製品とバージョン、 深刻度、攻撃者に何ができるか、ユーザーがどのように修正または緩和できるかを示します。 製品を運用する人々に向けて書かれますが、最近ではそのツールに向けても書かれるようになっています。
アドバイザリは、協調的脆弱性開示の公開側の終着点です。 発見者が非公開で報告し、提供元が修正し、アドバイザリによってほかのすべての人がそれを知ります。 ほとんどのソフトウェア企業やデバイス企業では、PSIRTがアドバイザリを作成します。これは、より広い プロダクトセキュリティプログラムの一環です。
セキュリティアドバイザリとセキュリティ情報、CVEレコード、VEX、リリースノートの違い
これらの文書は重なり合っており、チームはよく混同します。
| 文書 | 発行者 | 対象範囲 | 主な読み手 |
|---|---|---|---|
| セキュリティアドバイザリ | 製品の提供元、または調整機関 | 自社製品の1つの脆弱性、または関連するいくつかの脆弱性:影響を受けるバージョン、深刻度、修正 | 顧客の運用担当者とセキュリティチーム |
| セキュリティ情報(セキュリティ速報) | 提供元。多くの場合、決まったスケジュールで発行 | 1つのリリースまたは期間に含まれる多数の修正のまとめ。たとえばAndroidのセキュリティ情報は、毎月第1月曜日に公開されます。 | 定期的にパッチを適用するチーム |
| CVEレコード | CVE Numbering Authority(CNA) | 1つの脆弱性の世界共通の識別子と最小限の説明:影響を受ける製品、問題の種類、説明、少なくとも1つの公開参照先 | 脆弱性データベースとスキャナー |
| VEXステートメント | 提供元 | 製品と脆弱性ごとの機械可読なステータス:影響あり、影響なし、修正済み、調査中 | 顧客のスキャナー |
| リリースノート | 提供元 | リリースで変更されたすべての内容。セキュリティ修正もほかの変更とともに含まれる | アップグレードするすべての人 |
一般的なパターンは、脆弱性ごとに1つのアドバイザリを作成し、CVE IDでCVEレコードと結び付け、修正された各バージョンのリリースノートから、 またセキュリティ情報を発行している場合はそこからもリンクする、というものです。「セキュリティ情報」と「セキュリティアドバイザリ」は同義語として使われることもあります。 重要なのは、顧客が引用できる安定したページが脆弱性ごとにあることです。
セキュリティアドバイザリに含めるべき項目
以下の項目は顧客が探す情報であり、このガイドの後半で紹介する機械可読なフォーマットに1対1で対応します。 CVEプログラムのCNAルールは、 CVEレコードの最低限の内容を定めています。少なくとも1つの影響を受ける製品とバージョン、脆弱性の種類または原因(できればCWEで)、 文章による説明、公開参照先です。役に立つアドバイザリは、さらに踏み込みます。
| 項目 | 記載内容 | よくある間違い |
|---|---|---|
| アドバイザリID | EXC-2026-007のような自社独自の安定した識別子と、CVE ID |
CVE IDだけを使うこと。公開が必要な日にまだCVE IDがないこともある |
| タイトル | 製品、脆弱性の種類、影響を1行で | 「Product Xのセキュリティアップデート」のように、何も伝えないタイトル |
| 影響を受ける製品とバージョン | 影響を受けるすべての製品とバージョンを、リリースブランチごとの範囲で | 「4.2.2より前のバージョン」のように、バグが存在しなかったブランチまで誤って含めること |
| 影響を受けない製品 | 確認した結果、影響を受けないとわかった製品とバージョン | 記載を省き、古いバージョンを使うすべての顧客にチケットを起票させること |
| 修正済みバージョン | サポート対象の各ブランチで最初に修正されたバージョン | 最新リリースだけを挙げること |
| 深刻度 | 評価と、CVSSのバージョンを含む完全なCVSSベクトル | ベクトルのないスコアだけを示すこと。誰も検証できず、自分の環境に合わせて調整することもできない |
| 弱点 | CWEのIDと名称 | 省略すること。データベースとCVEのルールはこれを想定している |
| 説明 | 欠陥が何で、どこにあるか。影響の有無を判断できる程度に詳しく、ただし動作するエクスプロイトは含めない | 曖昧すぎて、顧客が自分の構成が影響を受けるか判断できないこと |
| 影響 | 攻撃者が何を得るか、そのために何が必要か(アクセス、ロール、ネットワーク上の位置) | 結果を説明する代わりに、CVSSのメトリクスを言葉で繰り返すこと |
| 回避策と緩和策 | すぐにアップグレードできない場合にすべきことと、悪用されたかどうかを確認する方法 | 設定変更で攻撃を防げるのに「回避策なし」とすること |
| 謝辞 | 本人の同意を得たうえで、誰が発見し報告したか | 匿名を希望した人の名前を載せること |
| タイムライン | 報告、確認、修正、公開の日付 | 記載を省き、長い遅延を隠しているように見せること |
| 参照先 | CVEレコード、リリースノート、修正コミット、機械可読版 | 顧客が開けない社内チケットへのリンク |
| 改訂履歴 | 初回公開後のすべての変更を、日付とバージョンとともに | 影響を受けるバージョンを黙って書き換えること |
最も難しい項目は、影響を受けるバージョンです。脆弱なコードはある時点で入り込み、別の時点で修正され、サポート対象の各ブランチにはそれぞれの修正があります。 脆弱性がサードパーティのコンポーネントから入り込んだ場合、問題は、自社のどのリリースがそのコンポーネントの脆弱なバージョンを、直接または推移的依存関係として出荷したかになります。 新しいCVEをビルド全体で評価する方法をご覧ください。
作成例
架空の製品の完全なアドバイザリを紹介します。Example Corpのセルフホスト型APIゲートウェイ「Example Gateway」で、 サポート対象のブランチは3.9と4.xの2つです。脆弱なエンドポイントは3.9.0で追加されたため、3.8以前は影響を受けません。 名前、ID、日付はすべて架空のものです。CVSS 4.0のスコアは、示したベクトルから算出しています。
Example Corp Security Advisory EXC-2026-007
Path traversal in Example Gateway export API allows reading server files
Advisory ID: EXC-2026-007
CVE ID: CVE-2026-XXXXX
Published: 2026-09-01
Last updated: 2026-09-15 (version 1.1)
Severity: High, CVSS 4.0 base score 7.1
CVSS vector: CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N
Weakness: CWE-22, Improper Limitation of a Pathname to a
Restricted Directory ('Path Traversal')
Affected products
Example Gateway 4.x 4.0.0 up to and including 4.2.1
Example Gateway 3.9 3.9.0 up to and including 3.9.6
Fixed versions
Example Gateway 4.2.2
Example Gateway 3.9.7
Not affected
Example Gateway 3.8 and earlier (the export API was added in 3.9.0)
Example Gateway Cloud (patched on 2026-08-28; no action needed)
Description
The export endpoint of the admin API (/api/v1/export) does not
normalize the file name parameter. A request containing "../"
sequences can read any file the gateway process can read.
Impact
An authenticated user with any role, including the read-only
"viewer" role, can read files on the gateway host. These include
gateway.yaml, which holds the database password and the signing key
for admin sessions. With that key an attacker can forge an admin
session. Unauthenticated users cannot exploit this vulnerability.
Workarounds
If you cannot upgrade right away:
1. Remove the viewer role from accounts that do not need it.
2. Block requests to /api/v1/export at your reverse proxy.
After upgrading, rotate the database password and the session
signing key if untrusted users held any admin API role.
Detection
Requests to /api/v1/export with "..", "%2e%2e" or "%2f" in the
file parameter appear in the gateway access log.
Credits
Example Corp thanks A. Researcher of Example Security Lab for
reporting this vulnerability through coordinated disclosure.
Timeline
2026-08-04 Reported to [email protected]
2026-08-05 Report acknowledged
2026-08-08 Vulnerability confirmed, CVE ID requested
2026-08-28 Example Gateway Cloud patched
2026-09-01 4.2.2 and 3.9.7 released, advisory published
2026-09-15 Advisory updated (version 1.1)
References
CVE record: https://www.cve.org/CVERecord?id=CVE-2026-XXXXX
Release notes 4.2.2: https://example.com/gateway/releases/4.2.2
Release notes 3.9.7: https://example.com/gateway/releases/3.9.7
CSAF version: https://example.com/security/csaf/2026/exc-2026-007.json
Revision history
1.0 2026-09-01 Initial publication
1.1 2026-09-15 Added 3.8 and earlier as not affected; added the
reverse proxy workaround
このアドバイザリが機能している理由は3つあります。
- ブランチごとの範囲。「4.0.0から4.2.1」と「3.9.0から3.9.6」は正確です。「4.2.2より前」と書けば、 3.8を使うすべての顧客に影響を受けると伝えてしまったでしょう。
- 影響の説明が前提条件を示している。viewerアカウントがない顧客は実際のリスクが低いとわかり、 数百人の委託先にviewerロールを付与している顧客はそうではないとわかります。
- 回避策にアップグレード後の対応も含まれている。アップグレードで穴はふさがりますが、漏えいしたシークレットは元に戻らないため、 アドバイザリはローテーションすべきものを示しています。
コピーして使えるセキュリティアドバイザリのテンプレート
角括弧の部分を置き換えてください。セクションを削除するのは本当に該当しない場合だけにし、顧客が期待する箇所は空欄にせず、その旨を明記してください(たとえば「No workarounds are available」)。
[Company] Security Advisory [ADVISORY-ID]
[Vulnerability type] in [product] [component] allows [impact]
Advisory ID: [ADVISORY-ID]
CVE ID: [CVE-YYYY-NNNNN, or "requested"]
Published: [YYYY-MM-DD]
Last updated: [YYYY-MM-DD] (version [1.0])
Severity: [Critical/High/Medium/Low], CVSS [4.0] base score [N.N]
CVSS vector: [CVSS:4.0/AV:_/AC:_/AT:_/PR:_/UI:_/VC:_/VI:_/VA:_/SC:_/SI:_/SA:_]
Weakness: [CWE-NNN, CWE name]
Affected products
[Product] [branch] [first affected] up to and including [last affected]
[Product] [branch] [first affected] up to and including [last affected]
Fixed versions
[Product] [fixed version]
[Product] [fixed version]
Not affected
[Products and versions checked and not affected, and why]
Description
[What the flaw is and where it is. Enough detail to judge exposure;
no exploit code.]
Impact
[What an attacker can do, and what they need first: network access,
an account, a role, user interaction, a non-default setting.]
Workarounds
[Steps to reduce risk until users can upgrade, or "No workarounds
are available." Also anything to do after upgrading, such as
rotating secrets.]
Detection
[How users can tell whether they were attacked, if known.]
Credits
[Name and affiliation of the reporter, with their consent.]
Timeline
[YYYY-MM-DD] Reported
[YYYY-MM-DD] Confirmed
[YYYY-MM-DD] Fixed versions released, advisory published
References
CVE record: [URL]
Release notes: [URL]
Machine-readable: [CSAF, OSV or VEX URL]
Disclosure policy: [URL]
Revision history
1.0 [YYYY-MM-DD] Initial publication
人が読むアドバイザリと機械可読なアドバイザリ
人に向けてはWebページで十分です。しかし、数千台のデバイスや数百のサービスを持つ顧客には十分ではありません。 そのツールは、アドバイザリを自社で運用しているものと照合する必要があります。それを可能にするフォーマットには3つの系統があり、それぞれ異なるニーズに応えます。
| フォーマット | 概要 | 使う場面 |
|---|---|---|
| Webページ(およびPDF) | 人が読む形のアドバイザリ | 常に。ほかのすべてのフォーマットはここにリンクします。 |
| CSAF 2.0 | アドバイザリをJSONで表すOASIS標準。製品ツリー、製品ステータスのリスト、修正方法、改訂履歴、配布のルールを備える | ファームウェア、アプライアンス、エンタープライズソフトウェアなどの製品を、アドバイザリの取り込みを自動化している顧客(多くは産業分野や大企業の購買者)に販売している場合 |
| OSV | Open Source Vulnerabilityフォーマット。名前付きエコシステムのパッケージについて、バージョン範囲を含むJSONエントリーで記述します。 GitHub Advisory Databaseはこの形式でアドバイザリを公開しています。 | npm、PyPI、Maven、Goモジュールなどのエコシステムを通じてオープンソースパッケージを出荷している場合 |
| VEX(CSAF VEX、CycloneDX VEX、OpenVEX) | 製品が既知の脆弱性の影響を受けるか受けないか、そしてその理由を示すステートメント | 顧客が自社のSBOMをスキャンし、製品に影響しないコンポーネントのCVEについて問い合わせてくる場合 |
上の作成例をCSAF 2.0で表すと、csaf_security_advisoryドキュメントになります。アドバイザリIDは
document/tracking/idに、改訂履歴はdocument/tracking/revision_historyに、
影響を受けるバージョンと修正済みバージョンは各脆弱性のproduct_statusリストに、CWEは
cweオブジェクトに、回避策はremediationsに入ります。注意点が1つあります。CSAF 2.0のスコアはCVSS
v2とv3.xにしか対応していません。CVSS v4.0への対応はまだドラフトのCSAF 2.1で加わるため、CSAF 2.0のアドバイザリには
CVSS 3.1のベクトルを載せるか、4.0のベクトルを注記に記載します。
ゲートウェイをnpmパッケージとしても出荷しているチーム向けに、同じアドバイザリをOSVエントリーで表したもの(抜粋)です。
{
"id": "EXC-2026-007",
"aliases": ["CVE-2026-XXXXX"],
"summary": "Path traversal in export API allows reading server files",
"published": "2026-09-01T09:00:00Z",
"modified": "2026-09-15T09:00:00Z",
"severity": [
{
"type": "CVSS_V4",
"score": "CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N"
}
],
"affected": [
{
"package": { "ecosystem": "npm", "name": "@example/gateway" },
"ranges": [
{
"type": "SEMVER",
"events": [
{ "introduced": "3.9.0" },
{ "fixed": "3.9.7" },
{ "introduced": "4.0.0" },
{ "fixed": "4.2.2" }
]
}
]
}
],
"credits": [{ "name": "A. Researcher", "type": "FINDER" }]
}
範囲に、introducedとfixedの組が2つ含まれている点に注目してください。
OSVスキーマでは、いずれかの範囲に入るバージョン、
または明示的なversionsリストに含まれるバージョンが影響を受けるものとして扱われます。また、
last-affectedの境界は照合漏れの原因になり得るため、fixedの使用をlast_affectedよりも推奨しています。
判断の目安:Webページの公開とCVEの取得は常に行います。オープンソースパッケージを出荷しているなら、OSVを追加します。 通常はGitHub経由で公開します。機械可読なアドバイザリを求める組織に製品を販売している場合、またはEUの Cyber Resilience Actの下で事業を行っている場合は、CSAFを追加します。同法の第14条(8)は、 実際に悪用されている脆弱性についてユーザーに知らせる際、適切な場合には構造化された機械可読なフォーマットを用いるよう求めています。 顧客が自社コンポーネントに関するスキャナーの出力を送ってくるようになったら、VEXを追加します。 すべてのフォーマットを1つの記録から生成し、内容が食い違わないようにします。
GitHub Security Advisories
プロジェクトがGitHub上の公開リポジトリであれば、GitHubの リポジトリセキュリティアドバイザリ で一連の流れを1か所で完結できます。脆弱性を議論する非公開のドラフト、修正のための一時的なプライベートフォーク、CVEの申請、そして公開です。 4つの要素が組み合わさっています。
- リポジトリセキュリティアドバイザリ:リポジトリに属するドラフトと公開済みのアドバイザリ。
- プライベート脆弱性報告:リポジトリのAdvisoriesページにある「Report a vulnerability」ボタン。 研究者は公開のissueを開く代わりに、非公開で報告できます。
- GitHubによるCVE ID:GitHubはCNAであり、プロジェクトがほかのCNAの範囲に含まれていない限り、 アドバイザリにCVE IDを割り当てられます。
- GitHub Advisory Database:対応エコシステムでは、GitHubがアドバイザリをOSV形式でここに公開し、 そのパッケージに依存するリポジトリにDependabotアラートを送るために使うことがあります。
プライベート脆弱性報告を有効にする
公開リポジトリのオーナーと管理者は、次の手順で有効にできます。
- リポジトリのメインページでSettingsをクリックします。
- サイドバーのSecurity and qualityセクションでAdvanced Securityをクリックします。
- Private vulnerability reportingの横にあるEnableをクリックします。
そのうえで、SECURITY.mdと開示ポリシーからリンクします。
ドラフトアドバイザリを作成する
- リポジトリのメインページでSecurity and qualityタブを開きます。
- サイドバーのReportingでAdvisoriesをクリックし、New draft security advisoryをクリックします。
- タイトルを入力します。CVE identifierで、既存のCVE IDを入力するか、後でGitHubに申請することを選びます。
- 説明を書きます。脆弱性、その影響、パッチ、回避策、参照先です。
- Affected productsで、エコシステム、パッケージ名、影響を受けるバージョン、パッチ適用済みバージョンを設定します。 パッケージごとに製品を追加します。
- 深刻度を設定するか、Assess severity using CVSSを選んで計算ツールに入力します。
- WeaknessesにCWEを、Creditsに報告者を追加します。
- Create draft security advisoryをクリックします。
ドラフトは非公開のままです。ドラフトからは、共同作業者の追加、修正を準備するための一時的なプライベートフォークの作成、 報告者との詳細な議論ができます。
CVEを申請して公開する
- Security and quality、Advisoriesの順に進み、ドラフトを開きます。
- フォームの下部でRequest CVEをクリックします。CVEを申請してもアドバイザリは公開されません。 GitHubによると申請は通常72時間以内に審査されるため、早めに申請してください。
- 修正済みバージョンをリリースし、アドバイザリでそれらがパッチ適用済みバージョンとして記載されていることを確認します。
- Publish advisoryをクリックします。一時的なプライベートフォークは削除され、GitHubがCVEの詳細を公開し、 対応エコシステムではアドバイザリがGitHub Advisory Databaseに登録されます。Dependabotアラートには最大72時間かかることがあります。
パッチ適用済みバージョンなしで公開すると、Dependabotが安全なバージョンを提示せずにユーザーに警告する、とGitHubは注意を促します。 GitHubのアドバイザリデータベースはCVSS 3.1と4.0の両方に対応しています。手順は2026年11月時点の GitHub Docs に基づいています。GitHubの画面上のラベルは随時変更されます。
GitHubのアドバイザリは、GitHubが対応するエコシステムのオープンソースパッケージに適しています。ファームウェア、アプライアンス、 クローズドソースの製品の場合は、自社サイトで公開し、顧客が求める場合はCSAFでも公開し、CVEは自社のCNA、または自社を範囲に含むCNAから取得します。
公開のタイミング:時期とエンバーゴ
エンバーゴ(非公開の報告から公開までの期間)とその長さは、開示ポリシーで定めるべきものです。 アドバイザリの役割は、その期間内の適切な時点で公開されることです。典型的な公開日の流れは次のとおりです。
- 公開日より前:サポート対象のすべてのブランチで修正の準備ができ、CVE IDが予約され、アドバイザリとすべての機械可読版が作成・レビューされています。
- 事前通知(行う場合):大口顧客、自社製品を組み込んでいる下流のベンダー、調整機関に、エンバーゴの下で数日前にアドバイザリを渡し、 それぞれの顧客に答える準備ができるようにします。
- リリース:修正済みバージョンを配布します。
- 公開:アドバイザリのページ、CVEレコード、CSAFまたはOSVのドキュメント、フィードのエントリーを同時に公開します。理想的にはリリースから1時間以内です。
- 通知:メーリングリストと、影響を受ける顧客への直接の通知を行います。
順序は重要です。アドバイザリなしで修正を先に公開すると、防御側がアップグレードの必要性を知らないうちに、攻撃者がリリースの差分を調べられてしまいます。 修正なしでアドバイザリを公開するのが正しいのは、脆弱性がすでに公になっているか悪用されている場合だけです。その場合は、わかっていることを緩和策とともに公開し、 修正が出たら更新します。
Cyber Resilience Actの下では、実際に悪用されている脆弱性は、当局への報告という別の義務も発生させます。 Single Reporting Platformを通じた24時間以内の早期警告、その後の通知と最終報告です。これはアドバイザリではなく、公開もされません。 CRAの附属書Iは、セキュリティアップデートが利用可能になった時点で修正済みの脆弱性に関する情報を公開することもメーカーに求めており、 これはまさにアドバイザリが果たす役割です。CRAの要件をご覧ください。
公開場所:アドバイザリをどこに置くか
-
アドバイザリごとの安定したページ:
/security/advisories/exc-2026-007のように決して変わらないURLに置き、 さらにすべてのアドバイザリを製品、深刻度、日付とともに一覧にしたインデックスページを用意します。 - フィード:インデックスのRSSまたはAtomフィードがあれば、メーリングリストなしで購読できます。
-
CSAFプロバイダーメタデータ:CSAFを公開する場合は、
provider-metadata.jsonファイルと、 ドキュメントのディレクトリまたはROLIEフィードを用意し、ツールがスクレイピングせずにすべてのアドバイザリを見つけられるようにします。 役割と要件についてはCSAFをご覧ください。 -
security.txtでの案内:
Policyフィールドで開示ポリシーにリンクします。また、CSAF標準では、 ツールをプロバイダーメタデータに導くCSAFフィールドが定義されています。
Contact: mailto:[email protected]
Expires: 2027-09-30T23:00:00.000Z
Policy: https://example.com/security/disclosure-policy
CSAF: https://example.com/.well-known/csaf/provider-metadata.json
公開したアドバイザリは決して削除しないでください。誤りがわかった場合は、何が変わったかを示す改訂版を公開します。 脆弱性が実在しなかった場合は、アドバイザリを取り下げ済みとし、その理由を示します。
顧客への通知
公開することと読まれることは同じではありません。フィードを購読していない顧客は、スキャナーがCVEを検出するか、誰かに問い合わせを受けるまで、 アドバイザリに気付きません。深刻度が高および緊急のアドバイザリでは、次のことを行います。
- 影響を受けるバージョンを運用している顧客にメールする:リスト全体ではなく対象の顧客だけに、アドバイザリのリンクと取るべき1つの対応を伝えます。
- サポートチームと営業チームに説明する:公開前にアドバイザリと短いFAQを渡し、回答が一致するようにします。
- 下流のベンダーに伝える:自社製品を組み込んでいるベンダーが、自らのアドバイザリをすぐに続けて出せるようにします。
- フォローアップする:影響を受けるバージョンを使い続けている顧客に連絡します。
影響を受ける顧客だけにメールするには、各顧客がどの製品バージョンを運用しているかを把握している必要があります。 多くのベンダーに同時に影響したサードパーティコンポーネントの脆弱性については、テンプレートを含む サプライチェーン攻撃の後に顧客へ回答する方法をご覧ください。
CNAになるべきか
CVE Numbering Authority(CNA)は、合意された範囲(通常は自社製品)の脆弱性についてCVE IDを割り当て、CVEレコードを公開します。 CNAになると、CVEレコードが公開される時期を自社で管理でき、エンバーゴ中の詳細をほかのCNAと共有せずにIDを割り当てられ、レコードを自ら記述できます。
CVEプログラムによると、料金も契約もありません。 CNAには、公開の脆弱性開示ポリシー、新たな脆弱性の開示を公開する場(アドバイザリのページ)、そしてプログラムの利用規約への同意が求められます。 参加手続きは、登録フォーム、導入セッション、練習用の事例を通じて進みます。EUでは、 ENISAがRootとして テクノロジーベンダーやオープンソースプロジェクトを含む、その範囲内の組織を担当しています。
- 向いているのは、自社製品について定期的にCVEを公開し、すでにPSIRTとアドバイザリのページを運営していて、 タイミングを自社で管理したいベンダーです。
- 最初の一歩である必要はありません。年に数件しかCVEを公開しない場合や、製品がGitHub上のオープンソースパッケージで、 GitHubがアドバイザリの一部としてIDを割り当てられる場合です。
CNAにならずにCVE IDを取得する方法は、協調的脆弱性開示をご覧ください。
CRACIの役割:影響を受けるバージョン
アドバイザリの大部分は文章を書く作業です。エビデンスが必要な項目は影響を受けるバージョンであり、サードパーティのコンポーネントの脆弱性では、 正しく記載するのが最も難しい項目でもあります。自社のどのリリースが、推移的依存関係としての場合も含めて脆弱なバージョンを出荷したか、そしていつからか、です。
CRACIはGitHub Actionsのビルドを独自のランナーで実行し、推移的依存関係やCIキャッシュから復元されたパッケージを含め、 各ジョブが実際に取得したパッケージを記録します。各パッケージには、そのアドバイザリ(CVE、GHSAなどのID)が深刻度とともに表示されます。 ビルド履歴には、過去のすべてのビルドとそのSBOM、そして脆弱な依存関係を含んでいたビルドが示されるため、保持期間(デフォルトで180日、 Enterpriseではカスタム設定可能)内であれば、影響を受けていた期間を把握できます。セキュリティチームは検出結果をトリアージして修正を担当するチームに送り、 CRACIは脆弱性とその深刻度を関係者に通知します。脆弱性トラッキングをご覧ください。
実際に悪用されている脆弱性によってCRAの報告義務が発生した場合、CRACIは通知(早期警告、通知、最終報告)の内容を準備します。 提出は自社の担当者がSingle Reporting Platformを通じて行います。
CRACIが適さない場合
- アドバイザリの作成と公開。CRACIは、CSAFを含むいかなるフォーマットでも、セキュリティアドバイザリの作成や公開を行いません。 自社サイト、GitHub Security Advisories、またはCSAFツールを使ってください。
- 報告の受付。CRACIは研究者や顧客からの脆弱性報告を受け付けず、ケースとして追跡もしません。 開示用の受付窓口、GitHubのプライベート脆弱性報告、またはケース管理ツールを使ってください。
- 自社コードの脆弱性。CRACIは、ビルドが取得したパッケージとアドバイザリを照合します。 作成例のパストラバーサルのような自社コードの欠陥は、いつ入り込んだかを突き止めるのにコードレビューが必要です。
- GitHub Actions以外のビルド。CRACIは現在GitHub Actionsに対応しています。GitLab CIとJenkinsはロードマップに掲載されています。
- 保持期間より古いリリース。ビルド履歴の対象は、CRACIが記録して保持しているビルドです。
セキュリティアドバイザリに関するよくあるご質問
セキュリティアドバイザリとは何ですか?
セキュリティアドバイザリとは、製品の提供元がその製品の脆弱性について説明する告知です。影響を受ける製品とバージョン、深刻度、攻撃者に何ができるか、どのように修正または緩和するかを示します。通常はCVE IDが付き、修正が利用可能になった時点で公開されます。
セキュリティアドバイザリとセキュリティ情報の違いは何ですか?
アドバイザリは通常、1つの脆弱性または関連するいくつかの脆弱性を詳しく扱います。セキュリティ情報は、1つのリリースまたは期間の多数の修正をまとめたもので、決まったスケジュールで発行されることが多く、たとえばAndroidは毎月セキュリティ情報を公開しています。この2つの言葉を区別せずに使うベンダーもあります。
セキュリティアドバイザリには何を含めるべきですか?
アドバイザリIDとCVE ID、タイトル、ブランチごとの範囲で示した影響を受ける製品とバージョン、確認して影響がなかった製品、修正済みバージョン、完全なCVSSベクトルを伴う深刻度、CWE、説明、影響とその前提条件、回避策、謝辞、タイムライン、参照先、改訂履歴です。
GitHubでセキュリティアドバイザリを作成するにはどうすればよいですか?
公開リポジトリでSecurity and qualityタブを開き、Reportingの下のAdvisories、続いてNew draft security advisoryをクリックします。タイトル、説明、影響を受ける製品、深刻度、CWE、謝辞を入力してドラフトを保存します。修正がリリースされたら、必要に応じてCVEを申請し、Publish advisoryをクリックします。
GitHubにアドバイザリのCVE IDを割り当ててもらえますか?
はい。プロジェクトがほかのCNAの範囲に含まれていなければ可能です。GitHubはCVE Numbering Authorityです。ドラフトのアドバイザリからCVEを申請します。申請してもアドバイザリは公開されず、GitHubによると申請は通常72時間以内に審査されます。アドバイザリが公開されると、GitHubがCVEの詳細を公開します。
セキュリティアドバイザリは機械可読にすべきですか?
セキュリティアドバイザリはいつ公開すべきですか?
修正済みバージョンと同時に、エンバーゴの下で主要顧客と下流のベンダーに事前通知した後に公開します。それより早く緩和策とともに公開するのは、脆弱性がすでに公になっているか悪用されている場合だけにし、修正が出たらアドバイザリを更新します。
セキュリティアドバイザリを公開するにはCNAである必要がありますか?
いいえ。アドバイザリは誰でも公開できます。CVE Numbering Authorityであれば、自らCVE IDを割り当てられるというだけです。CNAでない場合は、自社製品を範囲に含むCNA、GitHub上のオープンソースプロジェクトであればGitHub、またはCNA of Last ResortがIDを割り当てられます。
影響を受けるリリースを把握する
アドバイザリの正確さは、影響を受けるバージョンの正確さで決まります。デモを予約して、GitHub Actionsのどのビルドに脆弱なパッケージが含まれていたかをご覧ください。
デモを予約