安全掃描器 API

Bun 的套件管理器可以在安裝軟體包之前掃描它們，以捕獲供應鏈攻擊和已知漏洞。

快速開始

在您的 bunfig.toml 中設定安全掃描器：

[install.security]
scanner = "@oven/bun-security-scanner" # 範例名稱，請替換為您掃描器的包名

設定掃描器後，Bun 將：

• 在安裝前掃描所有軟體包
• 顯示安全警告和公告
• 如果掃描器發現致命公告，則取消安裝

工作原理

安全掃描器會在執行 bun install、bun add 及其他包操作時分析包。它們可以檢測：

• 已知安全漏洞（CVE）
• 惡意包
• 許可證合規問題

安全級別

掃描器報告兩種嚴重等級的問題：

• fatal - 立即停止安裝，傳回非零退出碼
• warn - 在互動式終端中提示是否繼續；在 CI 環境中立即退出

使用預建置掃描器

安全公司會將 Bun 安全掃描器作為 npm 包釋出。

安裝掃描器

從 npm 安裝安全掃描器：

bun add -d @oven/bun-security-scanner

設定掃描器

安裝後，在您的 bunfig.toml 中進行設定：

[install.security]
scanner = "@oven/bun-security-scanner" # 範例名稱，請替換為您掃描器的包名

企業設定

一些企業級掃描器通過環境變數獲取身份驗證資訊和其他設定：

# 例如可以放在 ~/.bashrc 中
export SECURITY_API_KEY="your-api-key"

# 掃描器會自動使用這些憑證
bun install

請查閱掃描器的文件，瞭解需要設定的環境變數以及其他必需的設定。

自定義掃描器開發

完整的範例（含測試和 CI 設定）請檢視官方模板： github.com/oven-sh/security-scanner-template。

相關連結

• 設定（bunfig.toml）
• 套件管理器
• 安全掃描器模板