2026 年每日通報的 CVE 數量比前一年多 138%。全新推出:持續運作的 Fixbox。有漏洞的相依套件,修正並驗證。

PSIRT

資安公告:撰寫方法,附範本與完整實例

資安公告是漏洞影響您的產品時,客戶據以採取行動的文件。一份好的資安公告不需要客戶開支援工單,就能回答他們是否受影響、影響多嚴重,以及該怎麼做。本指南涵蓋各個欄位、一份完整的範例、機器可讀格式、GitHub Security Advisories,以及何時發布。

更新日期

什麼是資安公告?

資安公告(security advisory)是產品供應商發出的通知,說明產品中的漏洞:哪些產品與版本受影響、嚴重程度如何、攻擊者可能做什麼,以及使用者如何修正或緩解。它是寫給使用該產品的人看的,而且越來越常也寫給他們的工具看。

資安公告是協同漏洞揭露對外公開的那一端:發現者私下通報、供應商修正,而資安公告就是其他所有人得知此事的方式。在多數軟體與裝置公司中,資安公告由 PSIRT 撰寫,屬於更廣泛的產品資安計畫的一部分。

資安公告與資安通報、CVE 紀錄、VEX 及版本說明的比較

這些文件彼此重疊,團隊經常把它們混為一談:

文件 由誰發布 涵蓋內容 主要讀者
資安公告 產品的供應商,或協調者 您產品中的單一漏洞,或少數幾個相關漏洞:受影響版本、嚴重程度、修正 客戶的維運人員與資安團隊
資安通報(security bulletin) 供應商,通常依固定時程發布 彙整單一版本或單一期間內的多項修正。例如 Android 的資安通報固定在每月第一個星期一發布。 依週期進行修補的團隊
CVE 紀錄 CVE Numbering Authority(CNA) 單一漏洞的全球識別碼與最基本的描述:受影響產品、問題類型、描述,以及至少一個公開參考資料 漏洞資料庫與掃描工具
VEX 聲明 供應商 每個產品與漏洞的機器可讀狀態:受影響、未受影響、已修正、調查中 客戶的掃描工具
版本說明 供應商 某個版本中所有的變更,資安修正只是其中之一 任何要升級的人

常見的做法是:每個漏洞一份資安公告,以 CVE ID 連結到 CVE 紀錄,並由每個修正版本的版本說明,以及您若有發布的資安通報連結過來。「資安通報」與「資安公告」有時被當作同義詞使用;重要的是每個漏洞都有一個客戶可以引用的固定頁面。

資安公告應包含哪些內容

下列欄位是客戶會尋找的資訊,而且與本指南後面介紹的機器可讀格式一一對應。CVE Program 的 CNA 規則訂定了 CVE 紀錄的最低要求:至少一個受影響的產品與版本、漏洞的類型或成因(最好以 CWE 表示)、一段文字描述,以及一個公開參考資料。實用的資安公告會做得更多。

欄位 說明內容 常見錯誤
公告 ID 您自己的固定識別碼,例如 EXC-2026-007,再加上 CVE ID 只使用 CVE ID,但在您需要發布的那天,可能還沒有拿到它
標題 用一行寫出產品、漏洞類型與影響 「Product X 的資安更新」,等於什麼都沒說
受影響的產品與版本 每個受影響的產品與版本,依各發布分支列出範圍 「4.2.2 之前的版本」,錯誤地納入了從未有此錯誤的分支
未受影響 經檢查後確認未受影響的產品與版本 省略這一項,導致每位使用舊版本的客戶都來開工單
修正版本 每個受支援分支上的第一個修正版本 只列出最新版本
嚴重程度 評等與完整的 CVSS 向量,並註明 CVSS 版本 只給分數而沒有向量,沒有人能檢查,也無法依自身環境調整
弱點 CWE ID 與名稱 省略它;資料庫與 CVE 規則都預期會有這一項
描述 缺陷是什麼、位於何處,細節足以判斷暴露程度,但不附可用的攻擊程式 過於模糊,客戶無法判斷自己的設定是否暴露在風險中
影響 攻擊者能得到什麼,以及他們需要先具備什麼(存取權、角色、網路位置) 用文字重複 CVSS 指標,而不是說明後果
因應措施與緩解措施 如果今天無法升級該怎麼做,以及如何檢查自己是否已遭利用 明明更改設定就能阻擋攻擊,卻寫「無因應措施」
致謝 經本人同意後,註明發現並通報漏洞的人 為要求匿名的人具名致謝
時間軸 通報、確認、修正、發布 省略這一項,讓長時間的延遲看起來像是在隱瞞
參考資料 CVE 紀錄、版本說明、修正提交、機器可讀版本 連結到客戶無法開啟的內部工單
修訂歷程 首次發布後的每一次變更,附日期與版本 悄悄修改受影響版本

最困難的欄位是受影響版本。有漏洞的程式碼是在某個時間點引入,在另一個時間點修正,而每個受支援的分支都有各自的修正。如果漏洞是透過第三方元件引入的,問題就變成:您的哪些版本出貨了該元件有漏洞的版本,無論是直接相依或遞移相依。請參閱如何在所有建置中評估新的 CVE。

完整實例

以下是一個虛構產品的完整資安公告:Example Gateway,Example Corp 推出的自架式 API 閘道器,有兩個受支援的分支:3.9 與 4.x。有漏洞的端點是在 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

這份資安公告之所以有效,有三個原因:

  • 依分支列出範圍。「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

人類可讀與機器可讀的資安公告

對人來說,一個網頁就夠了。但對擁有數千台裝置或數百個服務的客戶來說並不夠,他們的工具需要把您的資安公告與自己執行的內容進行比對。有三類格式能做到這一點,各自滿足不同的需求:

格式 是什麼 適用時機
網頁(及 PDF) 供人閱讀的資安公告 一律需要。其他所有格式都會連回它。
CSAF 2.0 OASIS 的 JSON 資安公告標準,包含產品樹、產品狀態清單、修補措施、修訂歷程,以及發布規則 您向會自動化接收資安公告的客戶銷售韌體、設備或企業軟體等產品,這些客戶通常是工業與企業買家
OSV Open Source Vulnerability 格式:針對特定生態系中套件的 JSON 條目,附有版本範圍。GitHub Advisory Database 以此格式發布其資安公告。 您透過 npm、PyPI、Maven、Go modules 及類似生態系出貨開源套件
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 中。有一點要注意:CSAF 2.0 的評分只接受 CVSS v2 與 v3.x。CVSS v4.0 的支援要到 CSAF 2.1 才有,而 CSAF 2.1 仍是草案,因此 CSAF 2.0 資安公告要嘛附上 CVSS 3.1 向量,要嘛在附註中提供 4.0 向量。

同一份資安公告以 OSV 條目表示,供同時以 npm 套件形式出貨閘道器的團隊使用(節錄):

{
  "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。OSV schema 規定,只要版本落在任一範圍內,或出現在明確的 versions 清單中,就視為受影響;並建議使用 fixed 而非 last_affected,因為以最後受影響版本作為界限可能導致比對遺漏。

判斷原則:一律發布網頁與 CVE。如果您出貨開源套件,就加上 OSV,通常是透過 GitHub 發布。如果您向會要求機器可讀資安公告的組織銷售產品,或是受歐盟 Cyber Resilience Act 規範,就加上 CSAF;CRA 第 14(8) 條要求在告知使用者遭積極利用之漏洞時,於適當情況下採用結構化、機器可讀的格式。一旦客戶開始寄來關於您元件的掃描結果,就加上 VEX。所有格式都從同一筆紀錄產生,以免彼此矛盾。

GitHub Security Advisories

如果您的專案是 GitHub 上的公開儲存庫,GitHub 的 repository security advisories 能讓您在同一個地方完成整個流程:用私人草稿討論漏洞、用臨時私人分支進行修正、申請 CVE,以及發布。四個部分彼此搭配:

  • Repository security advisories:屬於您儲存庫的草稿與已發布資安公告。
  • Private vulnerability reporting:儲存庫 Advisories 頁面上的「Report a vulnerability」按鈕,讓研究人員能私下向您通報,而不是開一個公開 issue。
  • 由 GitHub 核發 CVE ID:GitHub 是 CNA,可以為您的資安公告指派 CVE ID,除非您的專案屬於其他 CNA 的範圍。
  • GitHub Advisory Database:對於受支援的生態系,GitHub 會以 OSV 格式在該資料庫中發布您的資安公告,並可能據此向相依於您套件的儲存庫發送 Dependabot 警示。

啟用 Private vulnerability reporting

公開儲存庫的擁有者與管理員可以啟用它:

  1. 在儲存庫的主頁上,點選 Settings。
  2. 在側邊欄的 Security and quality 區段中,點選 Advanced Security。
  3. 點選 Private vulnerability reporting 旁的 Enable。

接著從您的 SECURITY.md 與揭露政策連結到它。

建立資安公告草稿

  1. 在儲存庫的主頁上,開啟 Security and quality 分頁。
  2. 在側邊欄的 Reporting 下,點選 Advisories,然後點選 New draft security advisory。
  3. 輸入標題。在 CVE identifier 下,輸入既有的 CVE ID,或選擇稍後向 GitHub 申請。
  4. 撰寫描述:漏洞、影響、修補程式、因應措施與參考資料。
  5. 在 Affected products 下,設定生態系、套件名稱、受影響版本與已修補版本。每個套件各新增一個產品。
  6. 設定嚴重程度,或選擇 Assess severity using CVSS 並填寫計算器。
  7. 在 Weaknesses 下新增 CWE,並在 Credits 下新增通報者。
  8. 點選 Create draft security advisory。

草稿會保持私密。您可以從草稿新增協作者、建立臨時私人分支來準備修正,並與通報者討論細節。

申請 CVE 並發布

  1. 從 Security and quality 開啟草稿,然後點選 Advisories。
  2. 在表單底部點選 Request CVE。申請 CVE 不會讓資安公告公開,而 GitHub 表示通常會在 72 小時內審核申請,因此請及早申請。
  3. 發布修正版本,並確認資安公告將其列為已修補版本。
  4. 點選 Publish advisory。臨時私人分支會被刪除,GitHub 會發布 CVE 詳細資訊,而對於受支援的生態系,資安公告會進入 GitHub Advisory Database。Dependabot 警示最多可能需要 72 小時。

如果您在沒有已修補版本的情況下發布,GitHub 會警告 Dependabot 將在不建議安全版本的情況下向使用者發出警示。GitHub 的資安公告資料庫同時支援 CVSS 3.1 與 4.0。以上步驟依據截至 2026 年 11 月的 GitHub Docs;GitHub 介面中的標籤不時會變動。

GitHub 資安公告適用於 GitHub 所支援生態系中的開源套件。對於韌體、設備或閉源產品,請在您自己的網站上發布,在客戶預期的地方採用 CSAF,並向您自己的 CNA 或範圍涵蓋您的 CNA 取得 CVE。

何時發布:時機與禁運期

禁運期(embargo),也就是從私下通報到公開發布之間的期間,以及它應持續多久,屬於您揭露政策的範疇。資安公告的任務是在這段期間內的正確時刻發布。典型的發布日流程如下:

  1. 發布日之前:每個受支援分支的修正都已就緒、CVE ID 已保留,資安公告與每個機器可讀版本都已撰寫並審閱完成。
  2. 事先通知(如果您有提供):大型客戶、內嵌您產品的下游廠商與協調者,會在禁運期內提前幾天收到資安公告,以便準備回覆他們自己的客戶。
  3. 發布版本:推出修正版本。
  4. 公開發布:資安公告頁面、CVE 紀錄、CSAF 或 OSV 文件與訂閱來源條目同時上線,最好與版本發布在同一小時內。
  5. 通知:郵寄清單,以及直接通知受影響的客戶。

順序很重要。先發布修正卻沒有資安公告,攻擊者可以比對版本差異,防禦者卻不知道要升級。在沒有修正的情況下發布資安公告,只有在漏洞已經公開或已遭利用時才正確:此時就發布您所知道的資訊與緩解措施,並在修正推出時更新資安公告。

依 Cyber Resilience Act,遭積極利用的漏洞還會觸發另一項向主管機關通報的義務:在 24 小時內透過 Single Reporting Platform 提出早期預警,接著是通報與最終報告。那不是您的資安公告,也不公開。CRA 附件 I 也要求製造商在資安更新推出後,公開揭露已修正漏洞的資訊,而這正是資安公告的作用。請參閱 CRA 的要求。

發布:資安公告放在哪裡

  • 每份資安公告一個固定頁面,網址永不變動,例如 /security/advisories/exc-2026-007,再加上一個索引頁,列出每份資安公告及其產品、嚴重程度與日期。
  • 訂閱來源。索引頁的 RSS 或 Atom 訂閱來源,讓人們不需郵寄清單也能訂閱。
  • CSAF provider metadata,如果您發布 CSAF:一個 provider-metadata.json 檔案,以及文件的目錄或 ROLIE 訂閱來源,讓工具不需爬取網頁就能找到每份資安公告。角色與要求請參閱 CSAF。
  • 在 security.txt 中加上指引。Policy 欄位連結到您的揭露政策,而 CSAF 標準定義了一個 CSAF 欄位,將工具導向您的 provider metadata:
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,或有人問起時,才會看到資安公告。對於高與重大等級的資安公告:

  • 寄電子郵件給使用受影響版本的客戶,而不是整份名單,附上資安公告連結以及他們需要採取的那一個行動。
  • 在發布前向支援與業務團隊簡報,提供資安公告與簡短的常見問題,讓他們的回答與公告一致。
  • 告知內嵌您產品的下游廠商,讓他們自己的資安公告能迅速跟進。
  • 持續追蹤仍停留在受影響版本的客戶。

只寄信給受影響的客戶,前提是知道每位客戶使用哪些產品版本。對於同時波及許多廠商的第三方元件漏洞,請參閱供應鏈攻擊後如何回覆客戶,其中附有範本。

您是否應該成為 CNA?

CVE Numbering Authority(CNA)針對約定範圍內的漏洞指派 CVE ID 並發布 CVE 紀錄,範圍通常是自家產品。成為 CNA 能讓您掌控 CVE 紀錄的出現時間、在不與其他 CNA 分享禁運期中細節的情況下指派 ID,並自行撰寫紀錄。

根據 CVE Program,成為 CNA 不收費,也不需要簽約。CNA 必須有公開的漏洞揭露政策、公開發布新漏洞揭露的管道(您的資安公告頁面),並同意該計畫的使用條款。加入流程包括填寫註冊表單、參加介紹說明會與完成練習範例。在歐盟, 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 private vulnerability reporting 或案件追蹤工具。
  • 您自己程式碼中的漏洞。CRACI 將資安公告與您的建置所擷取的套件進行比對。像範例中的路徑遍歷這類位於您自己程式碼中的缺陷,需要透過程式碼審查找出它是何時引入的。
  • GitHub Actions 以外的建置。CRACI 目前支援 GitHub Actions;GitLab CI 與 Jenkins 已列入產品藍圖。
  • 早於保存期限的版本。建置歷史涵蓋 CRACI 已記錄並保存的建置。

資安公告:常見問題

什麼是資安公告?

資安公告是產品供應商發出的通知,說明產品中的漏洞:哪些產品與版本受影響、嚴重程度如何、攻擊者可能做什麼,以及如何修正或緩解。它通常附有 CVE ID,並在修正可用後發布。

資安公告與資安通報有何不同?

資安公告通常詳細說明單一漏洞,或少數幾個相關漏洞。資安通報則彙整單一版本或單一期間的多項修正,通常依固定時程發布;例如 Android 每月發布其資安通報。有些廠商將這兩個詞交替使用。

資安公告應包含哪些內容?

公告 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 詳細資訊。

資安公告應該是機器可讀的嗎?

越來越應該。為人發布網頁,並為自動化處理的客戶加上機器可讀版本:銷售給企業與工業的產品使用 CSAF,開源套件使用 OSV,並以 VEX 說明哪些已知漏洞不影響您的產品。這些都從同一筆紀錄產生。

資安公告應該在何時發布?

與修正版本同時發布,並在此之前於禁運期內事先通知重要客戶與下游廠商。只有在漏洞已經公開或正遭利用時,才提前發布並附上緩解措施,並在修正推出時更新資安公告。

我需要成為 CNA 才能發布資安公告嗎?

不需要。任何人都可以發布資安公告。成為 CVE Numbering Authority 只代表您可以自行指派 CVE ID。若不是 CNA,可以由範圍涵蓋您產品的 CNA、為 GitHub 上開源專案服務的 GitHub,或 CNA of Last Resort 指派 ID。

掌握哪些版本應列為受影響

資安公告的準確度取決於受影響版本。預約示範,了解您的哪些 GitHub Actions 建置含有具漏洞的套件。

預約示範