微软官方在 PyPI 上发布的 Agent Framework 开发包出现供应链劫持事件,攻击者拿到包发布权限,先后上传 1.26.1、1.26.2 两个带恶意代码的版本,恶意程序依靠.pth 钩子实现 Python 启动自动运行,就算代码里没有导入 Agent Framework 包也会触发,专门抓取 Azure、GitHub、OpenAI、AWS 等平台的登录凭证、云令牌,虽然两个恶意版本很快被 PyPI 隔离,但只要开发者在 CI 流水线、本地开发环境安装过这两个版本,敏感密钥就有泄露风险,这个包本身是用来开发 AI 智能体的工具,每月下载量接近 20 万,面向大量 AI 开发人员,所以这次供应链攻击的影响范围值得重视。
一、两个恶意版本基础信息对比
| 版本号 | 上线时长 | 新增恶意能力 |
|---|---|---|
| 1.26.1 | 31 分钟 | 读取环境变量、本地凭据配置文件、进程内密钥,收集 Azure、AWS、GitHub、OpenAI、Docker 等凭证 |
| 1.26.2 | 8 分钟 | 保留原有窃取逻辑,新增 GitHub Actions OIDC 令牌拉取、扫描 GitHub Runner 目录的能力 |
二、攻击原理和恶意代码运行逻辑
- 攻击者劫持了 Agent Framework 的 PyPI 维护账号,不是仿冒名字的 typosquat 钓鱼包,是官方包本身被篡改。
- 恶意包安装后写入.pth 启动钩子文件,属于 Python 全局启动机制,只要启动 Python 解释器,恶意代码自动执行,不需要 import 包。
- 自动扫描系统里的密钥文件、环境变量,主动向 Azure 托管身份、GitHub Actions 接口申请临时令牌。
- 收集到的凭据会经过压缩、base64 编码,外传至攻击者预设的 webhook 站点地址。
- 没有系统持久化,删除 agent-framework 包和对应的.pth 文件之后,恶意代码就不会再运行,但已经被偷走的密钥风险依然存在。
三、已经安装涉事版本的应急处理步骤
- 先检查项目依赖锁文件,确认是否安装过 1.26.1、1.26.2 版本的 agent-framework。
- 执行卸载命令 pip uninstall agent-framework,手动检查 site-packages 目录,删除残留的恶意.pth 钩子文件。
- 全部受影响环境,立刻轮换所有相关密钥:Azure、GitHub、OpenAI、Hugging Face、AWS、Docker 令牌。
- 核查 CI/CD 流水线日志、出站流量,查看有没有向可疑 webhook 地址发起外发请求。
- 回滚到干净版本 1.26.0,后续安装前开启依赖签名校验、SBOM 扫描。
- 流水线增加依赖版本锁定,禁止自动升级到未审计的版本。
四、风险小结
这次 Agent Framework 劫持属于典型高危害开源供应链攻击,危害重点在 CI 自动化环境,流水线里的云身份权限通常很高,一旦被窃取后果严重。1.26.0 是安全干净版本,1.26.1、1.26.2 两个版本不要使用;虽然恶意版本存活时间很短,但只要有任意一台开发机、流水线节点装过,就必须做密钥轮换,不能因为包很快下架就忽略风险。
【常见问题】
问题 1:被劫持的 Agent Framework 恶意包,是不是必须代码 import 这个包才会触发窃取?
回答 1:不是,Agent Framework 恶意版本依靠.pth 启动钩子,只要启动 Python 解释器就自动运行,不需要在代码里导入 Agent Framework 包,CI 流水线只要执行 pip install 就埋下风险。
问题 2:Agent Framework PyPI 劫持事件里,哪些版本是危险版本?安全版本是哪个?
回答 2:危险版本是 1.26.1 和 1.26.2,1.26.0 是本次事件前的干净安全版本,开发者使用 Agent Framework 需要避开这两个恶意版本。
问题 3:安装了恶意 Agent Framework 包,删掉包之后风险就完全消失了吗?
回答 3:不会,删除 Agent Framework 包只能阻止恶意代码继续运行,已经被窃取的登录凭据、云令牌依然有效,必须主动轮换密钥,检查出站日志确认数据有没有外泄。
问题 4:这次 Agent Framework 劫持和普通名字仿冒 PyPI 包攻击有什么不一样?
回答 4:普通仿冒包是仿冒相似包名钓鱼,而 Agent Framework 是微软官方包的维护账号被劫持,直接在官方包名下上传恶意版本,开发者正常安装官方包也会中招,信任门槛更高。
【参考资料】
[2026-11-19](微软官方 PyPI 包 Agent Framework 遭劫持,攻击者植入窃取登录凭据的恶意软件)IT 之家
[2026-11-18](Microsoft agent-framework Compromised Twice on PyPI)SafeDep
[2026-11-18](Microsoft agent-framework PyPI Package Compromised)StepSecurity
[2026-11-17](Microsoft agent-framework compromised on PyPI: 1.26.1 and 1.26.2 ship a credential stealer)Chainguard
【免责声明】
本文内容基于安全厂商公开的 Agent Framework 劫持事件分析,恶意版本的行为、处置方案仅作为安全参考;实际环境需要结合自身权限、密钥体系做审计,供应链攻击的排查存在不确定性,不构成安全兜底方案。
