扫描不可信项目为何危险?OSV-SCALIBR的unsafe插件与沙箱安全机制全解析
扫描不可信项目为何危险?OSV-SCALIBR的unsafe插件与沙箱安全机制全解析
使用 OSV-SCALIBR 做软件成分分析(SCA)时,一个容易被忽视的问题浮出水面:扫描本身就可能"中招"。当分析器去解析一个陌生项目的依赖时,它会不会执行项目里的恶意代码?🔒 OSV-SCALIBR 通过一套名为 unsafe 插件 + 沙箱能力校验 的安全机制来回答这个问题——默认拦截高危动作,显式授权后才能放行。
🔎 什么是 OSV-SCALIBR:不只是找漏洞的工具
OSV-SCALIBR 是 Google 开源的一个可扩展软件成分分析库,核心能力包括:
- 📦 文件系统扫描器:提取已安装的语言包清单,生成 SBOM
- 🐳 容器镜像分析(按 layer 解析)
- 🛠️ Guided Remediation:为传递性漏洞自动生成升级补丁
- 🧩 插件化架构:内置提取器(Extractor)、检测器(Detector)、富集器(Enricher)、标注器(Annotator)
理解它的安全设计,先要理解它的插件模型。
🧩 插件与能力(Capabilities)模型:安全的第一道门槛
OSV-SCALIBR 的每个插件都通过 Requirements() 声明自己需要什么样的运行环境。这个"能力清单"定义在 plugin/plugin.go 的 Capabilities 结构体中:
type Capabilities struct {
OS OS // 目标操作系统(Linux/Windows/Mac)
Network Network // 是否提供网络访问
DirectFS bool // 能否直接用文件系统 API 访问
RunningSystem bool // 是否扫描真实的运行系统
// 关键点:是否允许运行"unsafe"插件。
// 意味着扫描器处于沙箱中,或扫描目标可被信任。
// 某些插件(如 Rust 可达性富集器)在不可信目标上
// 可能触发远程代码执行(RCE),因此必须显式开启此项。
AllowUnsafePlugins bool
}
💡 这段注释点破了整个机制的核心:"unsafe" 不是指代码写得差,而是指该插件可能"动手"——执行构建逻辑、访问外部资源,从而在恶意输入下被武器化。
当插件的"要求"超过环境的"能力"时,插件就会被拒绝启用。校验逻辑见 plugin/plugin.go#L139 的 ValidateRequirements 函数:
if p.Requirements().AllowUnsafePlugins && !capabs.AllowUnsafePlugins {
errs = append(errs, "plugin requires --allow-unsafe-plugins to be enabled. "+
"Make sure you're scanning a trusted artifact before enabling this setting.")
}
⚠️ 扫描不可信项目为何危险:3 个真实"unsafe"插件
OSV-SCALIBR 中有 3 个插件被标记为 unsafe,每一个都对应一类现实威胁:
| 插件名 | 类型 | 危险根源 | 触发场景 |
|---|---|---|---|
reachability/rust |
富集器 | 调用 Rust 原生工具链,编译整个项目 | 项目里的 build 脚本、build-time 逻辑会"原样执行" |
transitivedependency/pomxml |
富集器 | 跟随 pom.xml 中声明的注册表 |
pom.xml 可指向恶意 Maven 仓库 |
bazel/aspect |
提取器 | 主动调用 bazel build 命令 |
执行目标项目里的宏、action、repository rules |
1️⃣ Rust 可达性分析:为什么"分析代码"会执行代码?
看 enricher/reachability/rust/rust.go 的声明,注释写得很直白:
func (*Enricher) Requirements() *plugin.Capabilities {
return &plugin.Capabilities{
...
// Rust 可达性分析使用原生工具链,因此被扫描项目
// 中定义的任意脚本或构建期逻辑都会"原样执行"。
// 启用此插件前,请确保你信任源代码。
AllowUnsafePlugins: true,
}
}
它的 Enrich 方法会调用 cargo build 编译整个 Rust 项目(rust.go#L99-L115),然后从 DWARF 调试信息里提取函数调用关系,判断漏洞是否真的可被触发。
这正是价值与风险并存之处:
价值:能区分"装了带漏洞的库"和"漏洞代码真的被调用"
风险:cargo build 会执行 build.rs、build-time 脚本等任意逻辑
如果你扫描一个陌生 Rust 仓库,开启这个插件等于给对方的 build.rs 在你机器上"开后门"的机会。🚨
2️⃣ Maven 依赖解析:注册表劫持的隐患
enricher/transitivedependency/pomxml/pomxml.go 的注释点出了另一类攻击面:
// 此富集器会跟随 pom.xml 中定义的注册表。
// 如果注册表指向恶意仓库,则存在风险。
AllowUnsafePlugins: true,
pom.xml 里可以自定义 <repositories>。攻击者把仓库地址替换成一个投毒的 Maven 私服,你的分析器就会从中拉取恶意构件。这类"供应链投毒"在现实中已屡见不鲜。
3️⃣ Bazel 提取器:调用 bazel build 的代价
extractor/filesystem/bazel/aspect/aspect.go 的理由最"硬核":
// 此插件需要 AllowUnsafePlugins,因为它主动调用 `bazel build` 命令,
// 该命令会在宿主机上执行任意宏、action 和 repository rules。
return &plugin.Capabilities{RunningSystem: true, DirectFS: true, AllowUnsafePlugins: true}
bazel build 本身就是完整的构建执行器,能跑 Shell 命令、下载任意仓库。用它的副作用来"读"依赖清单,威力大,风险也大。
🛡️ 沙箱机制如何挡住风险:三道防线
理解了危险来源,再看 OSV-SCALIBR 如何默认拒绝这些动作,层层设防:
第一道:--allow-unsafe-plugins 默认关闭
CLI 参数注册于 binary/scalibr/scalibr.go,帮助文案就是安全声明:
"Allows enablement of unsafe plugins which could trigger Remote Code
Execution when run on malicious input. Make sure you're running SCALIBR
on trusted artifacts before enabling this setting."
注意它默认值是 false——不显式打开,高危插件一律不跑。这是"安全默认值"(secure by default)的典型实践。
第二道:能力校验自动禁用
plugin/plugin.go 的 FilterByCapabilities 会遍历插件列表,对每个不满足要求的插件打印警告并跳过,而不是崩溃:
func FilterByCapabilities(pls []Plugin, capabs *Capabilities) []Plugin {
result := []Plugin{}
for _, pl := range pls {
if err := ValidateRequirements(pl, capabs); err == nil {
result = append(result, pl)
} else {
log.Warnf("Disabling plugin %q: %v", pl.Name(), err)
}
}
return result
}
第三道:显式错误提示,而非静默失败
若你强制启用了某个插件但没给 unsafe 权限,ValidateRequirements 会返回明确错误(见上文),而不是"悄悄少跑了一个插件"。这让使用者清楚地知道自己被拦住了,需要主动决策。
✅ 这套机制的精髓:把"是否信任被扫描物"的决策权交还给用户,而不是替用户赌一把。
📋 如何在真实场景安全使用(CI/CD 最佳实践)
针对新手和普通用户,给出几条可直接落地的建议:
1. 扫描不可信目标 → 保持默认,别开 unsafe 插件
扫描来源不明的仓库、第三方镜像、公开数据集时,不要加 --allow-unsafe-plugins。这样 reachability/rust、bazel/aspect、transitivedependency/pomxml 都会被自动跳过,换来一个"安全但信息略少"的扫描结果。这是稳妥的默认姿势。🛡️
2. 确需这些插件 → 先在沙箱里跑
如果业务上必须拿到 Rust 可达性 / Maven 传递依赖,正确做法是隔离执行:
- 在 容器(Docker/Podman)里运行分析器,而非宿主机
- 在一次性 CI 环境里跑,跑完即销毁
- 用非 root 用户运行,限制文件系统与网络出口
"沙箱 + unsafe 插件"组合才是 OSV-SCALIBR 注释里那句 "the scanner is either sandboxed or is not running on untrusted artifacts"(扫描器要么被沙箱化,要么不扫描不可信目标)的本意。
3. 用能力过滤代替盲目开启
作为库调用时,可通过 Capabilities + FilterByCapabilities 精确控制。例如声明"离线、无直接文件系统访问",高风险插件自然被过滤掉,无需逐一禁用。参见 README.md 的 "Creating + running custom plugins" 章节。
4. 关注扫描结果中的插件状态
OSV-SCALIBR 会记录每个插件的运行状态(成功/部分成功/失败)与失败原因(见 plugin/plugin.go 的 Status / ScanStatus)。若某个插件因 unsafe 权限被禁用,日志里会有 Disabling plugin ... 警告——看见它,就确认防线生效了。
🧪 测试如何守护这套机制
OSV-SCALIBR 用单元测试固化了"默认拒绝"的行为。在 plugin/plugin_test.go 中:
"Unsafe plugins not allowed":插件要求 unsafe、环境未授权 → 期望报错"Unsafe plugins allowed":两边都允许 → 期望通过
这保证未来任何改动都不会在不知不觉中削弱安全默认值——回归测试会立刻报警。
📚 关键源码与文档导航
| 内容 | 路径 |
|---|---|
| 能力模型与 unsafe 校验 | plugin/plugin.go |
| unsafe 单元测试 | plugin/plugin_test.go |
CLI --allow-unsafe-plugins 定义 |
binary/scalibr/scalibr.go |
| Rust 可达性(unsafe) | enricher/reachability/rust/rust.go |
| Maven 依赖解析(unsafe) | enricher/transitivedependency/pomxml/pomxml.go |
| Bazel 提取器(unsafe) | extractor/filesystem/bazel/aspect/aspect.go |
| 官方插件清单与 unsafe 警告 | docs/supported_inventory_types.md |
| 插件开发指南 | docs/new_enricher.md |
官方文档也在 docs/supported_inventory_types.md 末尾给出醒目警告:
⚠️ Warning: Plugins marked with * are considered "unsafe" and require the
--allow-unsafe-pluginsflag. These plugins can be risky when run on untrusted artifacts as they may execute build-time logic defined within the project or follow external registries specified in the scanned artifacts. Please ensure you trust the source code and artifacts before proceeding.
🎯 一句话总结
扫描软件不是"只读"操作——OSV-SCALIBR 把"会动手"的插件标记为 unsafe,默认拒绝它们,只有在你显式声明"我信任这个目标"或"我在沙箱里"时,才通过 --allow-unsafe-plugins 放行。理解并善用这套机制,你就能在拿全情报与守住主机安全之间找到平衡点。🔐