security.txt
security.txt 是一個小型文字檔,定義於 RFC 9116,放在 /.well-known/security.txt,用來告訴資安研究人員如何向網站或產品的擁有者通報漏洞。
最後更新:2026年11月13日
security.txt 是組織發布在其網站上的純文字檔,用來說明如何向該組織通報資安漏洞。它定義於 RFC 9116,這是一份由 Edwin Foudil 與 Yakov Shafranovich 於 2022 年 4 月發布的資訊性(Informational)RFC。發現問題的研究人員會擷取 https://example.com/.well-known/security.txt,取得聯絡地址、揭露政策的連結,以及選擇性提供的加密金鑰,而不必猜測某個通用的客服地址。
放在哪裡
- 位置:
/.well-known/security.txt,透過 HTTPS 以text/plain搭配 UTF-8 字元集提供。 - **舊版路徑:**為了相容性,允許將檔案放在最上層的
/security.txt,也可以重新導向到 well-known 路徑。若兩者都存在,以 well-known 路徑為準。 - **範圍:**檔案只涵蓋提供它的那個主機,不包括子網域或上層網域。
www.example.com與shop.example.com各自需要自己的檔案或重新導向。
欄位
每一行都是一組 Name: value;欄位名稱不區分大小寫,以 # 開頭的行為註解。欄位中的每個網頁 URI 都必須使用 HTTPS。
| 欄位 | 必要 | 內容 |
|---|---|---|
| Contact | 是 | mailto:、tel: 或 https: 地址。可重複;順序代表偏好 |
| Expires | 是 | 恰好一次,採 RFC 3339 日期時間格式。建議設在一年以內 |
| Encryption | 否 | 用來加密通報之金鑰的連結,而非金鑰本身 |
| Policy | 否 | 漏洞揭露政策的連結 |
| Acknowledgments | 否 | 感謝研究人員之頁面的連結 |
| Preferred-Languages | 否 | 最多一次,語言標籤,例如 en, fi。若未提供,預設為英文 |
| Canonical | 否 | 此檔案預期所在位置的 URI;搭配簽章使用 |
| Hiring | 否 | 資安職缺的連結 |
其他欄位登錄於 IANA 的 security.txt 欄位登錄表,讀取方必須忽略無法辨識的欄位。其中兩個對產品資安團隊很重要:CSAF,由 OASIS CSAF 2.0 標準定義,指向 CSAF 提供者的 provider-metadata.json,讓工具能找到您的機器可讀資安公告(請參閱 CSAF);以及 Bug-Bounty,出自 CERT 的協同漏洞揭露指南。
完整範例
# Security contact for example.com
Contact: mailto:[email protected]
Contact: https://example.com/security/report
Expires: 2027-10-31T23:00:00.000Z
Encryption: https://example.com/.well-known/pgp-key.txt
Policy: https://example.com/security/disclosure-policy
Acknowledgments: https://example.com/security/hall-of-fame
Preferred-Languages: en, fi
Canonical: https://example.com/.well-known/security.txt
Hiring: https://example.com/careers/security
CSAF: https://example.com/.well-known/csaf/provider-metadata.json
只有兩行 Contact 與一行 Expires 是必要的。最精簡的檔案只有三行。
Expires
Expires 是必要欄位,目的是讓被遺忘的檔案不再被信任。RFC 9116 建議將日期設在一年以內,而研究人員應將過期的檔案視為已失效。實務上,請依時程更新:設定行事曆提醒,或建立一個在到期前一個月就會失敗的 CI 作業,兩種方法都可行。過期的 security.txt 等於告訴研究人員:沒有人在看這個信箱。
簽章
RFC 9116 建議以 OpenPGP 明文簽章(cleartext signature)簽署此檔案,並在已簽署的檔案中使用 Canonical,讓簽章同時驗證檔案預期所在的位置。簽署後的檔案會包住相同的欄位:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Contact: mailto:[email protected]
Expires: 2027-10-31T23:00:00.000Z
Canonical: https://example.com/.well-known/security.txt
-----BEGIN PGP SIGNATURE-----
...
-----END PGP SIGNATURE-----
RFC 將確認簽章金鑰確實屬於您的工作交給研究人員,因此請讓這件事變得容易,例如在同一台網頁伺服器以外的地方公布金鑰的指紋。
security.txt 做不到的事
- **它不授予任何測試許可。**RFC 明確說明了這一點;研究人員可以做什麼,應寫在您的揭露政策中。
- **它不是政策。**它指向政策。政策應包含的內容與範本,請參閱協同漏洞揭露。
- **它會招來雜訊。**公開的地址會收到垃圾郵件與自動化掃描工具的報告,因此請將它導向一個會進行分級研判的團隊,而不是某個人的信箱。
security.txt 適用於網站與網域。GitHub 上的開源專案通常會在儲存庫中使用 SECURITY.md 檔案達到相同目的。
與 CRACI 的關係
CRACI 不接收漏洞通報,也不發布 security.txt 檔案。由誰處理通報以及如何處理,請參閱 PSIRT 與協同漏洞揭露。