11-供应链与工程安全

依赖投毒原理

核心 15 分钟 更新于 2026-11-18 前置: kp-012

一句话定义

依赖投毒(dependency poisoning)指攻击者通过包名空间、版本发布或维护者身份等环节,让开发者”安装依赖”这一正常动作引入并自动执行恶意第三方代码——利用的是包管理”名字即信任”的结构性缺陷。

为什么重要

现代应用的绝大部分代码来自第三方依赖,动辄数百上千个,包仓库因此成为新的信任边界。而依赖安装普遍带构建钩子脚本,使”下载依赖”事实上等于”以开发者权限执行第三方代码”。一次投毒会沿依赖树放大到无数下游项目,防御必须上升到工程流程层。

前置知识

  • kp-012:信任边界与隔离模型——包仓库正是开发环境边界之外的实体。
  • 包管理器工作方式:依赖解析、语义化版本(semver)范围、锁文件(lockfile)。
  • npm/PyPI 等公共仓库的注册模型:任何人可注册新名字并发布版本。

核心概念

  • 依赖(dependency):项目引用的第三方包;依赖的依赖称为传递依赖(transitive dependency)。
  • 包仓库(registry):按”包名→版本→制品”索引的公共分发基础设施。
  • 安装钩子(install 脚本):包安装阶段自动执行的脚本,是”下载变执行”的关键机制。
  • typosquatting(拼写抢注):注册与知名包近似的名称以承接误装流量。
  • 维护者接管(account takeover):凭据窃取或社会工程获得合法包的发布权。
  • 包混淆(dependency confusion):内部私有包名被公共仓库同名包覆盖解析。
  • 来源证明(provenance):对”制品由谁、在什么环境、从哪份源码构建”的证明。

原理与机制

根本矛盾:包管理器的解析单位是”名字”,不验证名字背后是谁——信任建立在字符串而非身份之上。投毒类别学据此展开:

  • typosquatting(拼写抢注):名称与流行包仅一两个字符之差,利用手误与搜索惯性。防御:仓库做相似度告警,消费者侧显式声明并复核首次引入。
  • 合法包版本劫持与维护者账号接管:攻击面是发布权——凭据被钓取、令牌泄漏或权限被诱导转交后,攻击者发布版本号”正常”、内容被植入的更新,历史信誉为其背书。防御:发布端双因素与来源证明,消费端锁定版本并对新版本设观察期。
  • 传递依赖的隐蔽性:恶意代码可藏于二阶、三阶依赖或被接管的工具型小包——接触面广、维护者单一、无人审视,是审查盲区与信任传递衰减的叠加。
  • 包混淆与域名仿冒:私有源对未命中名称回退公共源时,攻击者抢注与内部包同名的公共包,构建机即拉到恶意版本;域名仿冒则仿冒官方站点误导安装。防御:私有源”仅私有”不回退、内部名预防性注册、源配置纳入审计。

攻击面分类:名字空间(抢注、混淆)、发布流程(账号、令牌)、解析顺序(源优先级与回退)、时间窗口(未被审计的新版本)。防御映射四层:依赖锁定(lockfile 变”自动解析”为”显式固定”)、私有源与白名单(收敛解析路径)、依赖审计与新鲜度维护(缩短恶意版本存活时间)、provenance 思想(把名字绑定到可验证的构建来源,机制见 kp-033)。检测映射:已知恶意包比对、安装脚本白名单、新依赖引入门槛。

实例或案例

  • 维护者接管类:2021 年公开披露的 ua-parser-js 事件——账号被入侵,连续几个版本携带窃取凭据与挖矿逻辑,数小时波及大量项目。呈现”合法名字+合法渠道+恶意内容”的组合,信誉无法替代身份验证。
  • 拼写抢注类:npm 与 PyPI 历史上多次公开报道的仿冒包类别——以流行工具的近似名注册,安装钩子窃取开发者环境信息,触发条件是手误与搜索排名。
  • 包混淆类:2021 年经负责任披露公开的 dependency confusion 案例——研究者注册与多家公司内部包同名的公共包,验证了”回退解析”这一攻击面的普遍存在。

常见误区

  • 提交了 lockfile 就安全:它只消除解析漂移,首装、升级、锁文件被篡改仍可引入恶意内容,必要非充分。
  • 知名包等于可信:信誉属于历史版本与原维护者,账号被接管后反而成为攻击的杠杆。
  • 只在运行期做漏洞扫描:安装钩子在安装时已执行,检测必须前置到引入与安装环节。
  • 配置了私有源就无虞:若允许回退公共源且无白名单,包混淆的解析路径依然存在。

自测题

  1. 为什么说”名字即信任”是依赖投毒的结构性缺陷? 答案要点:解析单位是包名字符串而非发布者身份;进入名字空间(抢注)或发布流程(接管)即可伪造这条信任。
  2. lockfile 防住了什么、防不住什么? 答案要点:防住解析漂移与版本不确定;防不住首次安装钩子执行、锁文件被篡改,以及锁定了一个已被投毒的版本。
  3. 包混淆的成立前提是什么?对应哪条防御? 答案要点:前提是私有源对未命中名称回退公共源;防御是”仅私有”不回退、内部名预防性注册与源配置审计。

公式或模型

本节不适用——依赖投毒是信任结构与流程问题,不存在普适数值公式;其分析模型是”信任传递链”,见「图示」。

图示

开发者 ──引用包名──> 包管理器
                      │ 按名字解析,不验证身份 ★缺陷根源
                      v
              ┌─────────────────┐
              │ 解析顺序 / 源配置 │<-- 攻击面:包混淆(回退公共源)
              └────────┬────────┘
                       v
              ┌─────────────────┐
              │  包仓库 registry │<-- 攻击面:名字空间(抢注)
              └────────┬────────┘            发布流程(账号接管)
                       v
              ┌─────────────────┐
              │ 制品 + 安装钩子  │----> 以开发者权限自动执行
              └─────────────────┘
防御四层:lockfile 锁定 / 私有源白名单 / 审计与新鲜度 / provenance

直观类比

写字楼茶水间的公共货架只认标签不认人:标签与知名饮料一字之差,拿错概率不小(拼写抢注);代运营账号被盗,同样的瓶子灌进假货(账号接管);内部专供饮品被贴同款标签放上公共货架,按单取货即取到假货(包混淆);多数人不追查配料的配料(传递依赖)。

与其他知识点的关系

  • kp-012:包仓库处于开发环境信任边界之外,“解析即信任”是隔离模型缺失的实例。
  • kp-032:依赖进入构建链后,解析劫持同样作用于构建机,是同一模型在 CI 场景的延续。
  • kp-033:provenance、签名与 SBOM 是投毒防御的证据层——从”信名字”升级为”验来源与成分”。

延伸阅读

  • SLSA(Supply-chain Levels for Software Artifacts)框架
  • in-toto 软件供应链证明规范
  • O’Reilly《Software Supply Chain Security》(Sasha Rosenbaum)
  • OWASP Top 10(Vulnerable and Outdated Components 类目)

相关知识点