微软Agent包遭劫持:不导入也窃密

微软官方 Agent Framework 的两个 PyPI 版本被植入凭据窃取程序,可在 Python 启动时自动执行。恶意版本上线时间虽短,近20万月下载量和CI自动升级机制仍放大了供应链风险。
微软官方发布在 PyPI 的 agent-framework 软件包日前遭到供应链攻击,攻击者连续上传 1.26.1 和 1.26.2 两个恶意版本,目标直指开发者电脑、CI/CD Runner 与云环境中的登录凭据和身份令牌。
这起事件最危险的地方不是恶意代码隐藏得多深,而是受影响环境根本不需要执行 import agent_framework。只要恶意 wheel 已安装,Python 解释器正常启动,就可能触发藏在 .pth 文件里的窃密逻辑。
截至北京时间 2026 年 11 月 19 日,PyPI 已删除相关恶意版本,但是否有开发者凭据被实际盗用仍未明确。安装过相关版本的本地环境、容器镜像、构建缓存和自托管 Runner 不会因为 PyPI 下架而自动恢复,受影响团队仍需按凭据已经泄露的标准完成排查。

两个恶意版本,前后只隔了两分钟
软件供应链攻击是攻击者通过开发依赖、构建流程或分发渠道植入恶意代码,借助开发者对上游软件的信任扩大感染范围。此次事件针对的不是一个仿冒名称包,而是微软官方 agent-framework 项目在 PyPI 上的正式分发入口,因此风险等级明显高于常见的拼写抢注攻击。
根据 JFrog Security Research 和 OX Security 对恶意 wheel 的分析,agent-framework 1.26.1 于 11 月 17 日 20:35 UTC,也就是北京时间 11 月 18 日 4:35 上线。PyPI 在 31 分钟后的 21:06 UTC 将其隔离,但攻击者仅等待两分钟,就在 21:08 UTC 上传了第二个恶意版本 1.26.2。
第二轮攻击只维持了约 8 分钟。到 21:16 UTC,两个未授权版本均已从 PyPI 删除,从第一个版本上线到全部清除,整个事件窗口约为 41 分钟。
| 事件节点 | UTC 时间 | 北京时间 | 持续时间或结果 |
|---|---:|---:|---|
| 1.26.1 上传 | 11 月 17 日 20:35 | 11 月 18 日 04:35 | 恶意版本首次出现 |
| 1.26.1 被隔离 | 11 月 17 日 21:06 | 11 月 18 日 05:06 | 上线 31 分钟后被隔离 |
| 1.26.2 上传 | 11 月 17 日 21:08 | 11 月 18 日 05:08 | 距首次隔离仅 2 分钟 |
| 两个版本被删除 | 11 月 17 日 21:16 | 11 月 18 日 05:16 | 第二个版本存活约 8 分钟 |
短暂上线不等于影响有限。OX Security 统计该软件包月下载量为 192,534 次,JFrog 给出的周下载量约为 40,000 次;更关键的是,Renovate 等自动化依赖机器人在 1.26.1 发布约 6 分钟后,已经开始向下游仓库创建升级 Pull Request。
近 20 万月下载量也不能直接等同于近 20 万名受害者。下载统计通常包含 CI 重复安装、镜像构建、缓存刷新、安全扫描和同一用户的多次下载,目前没有可靠公开证据可以证明实际中招人数,更不能仅凭周下载均值推算恶意版本在 31 分钟内的下载次数。
Agent Framework 为什么会成为高价值目标
Microsoft Agent Framework 是微软面向 Python 开发者推出的开源智能体开发框架,用于编排模型、工具、工作流以及多智能体之间的交互。开发者可以用它构建会调用外部服务、执行复杂任务并与其他智能体协作的应用。
Agent 框架天然处在敏感数据密集区。一个普通前端依赖通常只能接触构建目录,而智能体开发环境往往同时配置 OpenAI、Azure、AWS、GitHub、Hugging Face、Docker 和模型仓库凭据,还可能连接生产数据库、向量数据库及企业内部系统。
这意味着攻击者劫持一个 Agent 开发依赖,拿到的可能不是单个应用密钥,而是一整套云端身份。尤其在 CI/CD 环境里,同一个 Runner 经常具备读取私有仓库、推送容器镜像、部署云资源和签发短期令牌的权限,攻击者一旦获得这些身份,就有机会从开发机横向进入生产环境。
微软的官方 GitHub 仓库用于公开 Agent Framework 源代码和正常开发记录,但安全研究人员发现,两个恶意 wheel 是在微软正常上游 CI 流程之外重新打包的。相关版本缺少与正常发布对应的 Git 标签和构建记录,这说明 PyPI 上的制品与公开源码之间出现了断裂。
目前仍不能确定攻击者究竟通过何种方式获得发布能力。可能性包括维护者账户失守、发布令牌泄露、受信发布配置被滥用,或其他分发权限遭到突破,但在微软、PyPI或调查团队公布结论前,不应把某一种路径当成既定事实。
不用 import,Python 一启动就执行
.pth 文件是 Python site 模块处理站点目录时读取的一类路径配置文件,除添加模块搜索路径外,其中以 import 开头的代码行还可以在解释器启动阶段执行。这个原本用于环境初始化和兼容性配置的机制,被攻击者改造成了静默启动钩子。
两个恶意版本分别加入了 agent_framework_meta.pth 和 af_runtime_diag.pth。当 wheel 被安装到 site-packages 后,Python 在常规启动过程中处理这些文件,恶意逻辑因此可以在后台运行,无需业务代码显式导入 Agent Framework。
| 对比项 | 正常 Python 包行为 | 此次恶意版本行为 |
|---|---|---|
| 触发条件 | 业务代码显式导入或调用 | Python 启动并加载 site 即可能触发 |
| 恶意入口 | 通常藏在模块函数中 | 藏在 site-packages 内的 .pth 文件 |
| 影响范围 | 使用该库的进程 | 同一环境内启动的其他 Python 程序也可能触发 |
| 开发者感知 | 调用链相对容易追踪 | 不导入包也执行,常规代码审查难发现 |
| 下架后的状态 | 新安装无法获取 | 已安装环境、镜像和缓存仍可能残留 |
这种设计绕开了很多团队的直觉式检查。开发者可能只查看应用是否调用了 Agent Framework,或者认为某个依赖只是被装进环境但没有启用,因此不会产生影响;实际上,只要对应 .pth 文件仍在解释器会扫描的目录中,其他 Python 命令、测试任务和构建脚本都可能成为触发器。
使用 python -S 阻止自动加载 site 模块,在特定情况下可能绕过 .pth 处理,但这不是可靠的修复方案。生产环境不能把改变解释器启动参数当作清理恶意软件的替代品,正确做法仍是隔离主机、重建环境并轮换凭据。
攻击者瞄准的是整条云开发链
恶意程序的目标并不限于一个模型服务。安全团队分析显示,它会收集环境变量、本地配置文件、进程信息,以及 Azure、AWS、GitHub、Docker、Hugging Face、OpenAI 等服务的凭据。
1.26.2 还扩大了对 CI 身份的攻击范围。该版本加入 GitHub Actions OIDC 令牌请求能力,并会自动搜索 GitHub Runner 相关目录,说明攻击者不满足于读取开发者硬盘上已有的静态密钥,还试图利用工作负载身份机制主动获取新的短期令牌。
| 凭据或数据类型 | 潜在位置 | 泄露后的主要风险 |
|---|---|---|
| Azure CLI 与 Managed Identity 令牌 | CLI 缓存、元数据服务、环境变量 | 访问订阅资源、存储、密钥库或部署系统 |
| AWS 凭据 | 环境变量、本地配置文件、实例角色 | 读取对象存储、调用云服务或创建新资源 |
| GitHub Token 与 Actions OIDC | Runner 环境、工作流上下文 | 读取私有仓库、篡改工作流或换取云端身份 |
| Docker 凭据 | Docker 配置文件 | 拉取私有镜像或向镜像仓库推送污染制品 |
| Hugging Face 与 OpenAI 凭据 | 环境变量、.env、配置文件 | 调用模型服务、读取私有资源并产生费用 |
| Git、pip、npm 配置 | 用户目录、项目配置 | 访问私有代码和软件包,继续扩大供应链攻击 |
| 进程与本地文件信息 | 运行中进程、JSON 和环境配置 | 识别高价值服务并辅助横向移动 |
OIDC 令牌是由身份提供方签发的短期身份凭证,通常用于让 CI 工作流在不保存长期云密钥的情况下访问云资源。它比长期密钥更安全,但前提是令牌申请发生在可信环境中;如果 Runner 本身已被恶意代码控制,攻击者可以在授权窗口内代表工作流申请和使用令牌。
短期令牌过期也不意味着风险自然归零。攻击者可能已利用令牌创建新的服务主体、部署密钥、访问令牌或云资源,因此团队不仅要轮换现有密钥,还要检查攻击窗口之后出现的身份变更、异常授权和资源操作。
31 分钟暴露了自动更新的另一面
自动依赖升级是把上游新版本快速带入项目的工程机制,通常由 Renovate、Dependabot 或内部机器人创建升级请求并触发测试。它能缩短安全补丁落地时间,也会在上游发布渠道失守时加快恶意版本传播。
此次事件说明,仅用语义化版本和测试通过来判断升级安全已经不够。攻击者上传的 wheel 可以保留原项目绝大部分正常代码与功能,常规单元测试照样通过,而新增的 .pth 文件并不需要修改业务模块,更不容易被功能测试发现。
锁定依赖版本同样不是万能答案。精确 pin 可以防止环境自动漂移到 1.26.1,但如果团队的升级机器人自动修改锁文件,或者构建流程每次都解析最新可用版本,恶意版本仍可能进入 Pull Request、测试 Runner和制品缓存。
真正有效的防线是把源码、构建身份和最终制品连起来验证。企业应要求关键依赖具备可验证的来源证明、可信发布机制和构建签名,同时对 PyPI wheel 与上游 Git 标签进行差异检查;只看包名旁边的官方身份,并不足以证明某个具体文件确实由官方 CI 构建。
安装过 1.26.1 或 1.26.2,应该立即做什么
受影响团队应把安装过两个恶意版本的环境视为已经发生凭据暴露,而不是等待是否出现异常账单。恶意程序的执行时机早、采集范围广,单纯卸载软件包无法撤回已经外传的令牌。
建议按照以下顺序处理:
- 立即隔离相关主机和 Runner。 暂停其网络连接与生产权限,避免继续外传信息或执行横向操作。
- 确认安装和构建记录。 检索包管理日志、CI 日志、容器构建历史、SBOM、锁文件及缓存,查找
agent-framework==1.26.1和agent-framework==1.26.2。 - 检查恶意启动文件。 搜索 Python 环境中的
agent_framework_meta.pth、af_runtime_diag.pth及来源不明的.pth文件,但不要因为文件已不存在就排除泄露可能。 - 销毁并重建环境。 删除虚拟环境、重建容器镜像、清理 wheel 缓存和构建层;高价值开发机及自托管 Runner 应优先从可信基线重装。
- 回退到已知安全版本。 调查资料建议暂时使用
1.26.0,并在恢复安装前核对官方仓库、哈希与组织内部制品记录。 - 轮换所有可接触凭据。 范围应包括 Azure、AWS、GitHub、Docker、Hugging Face、OpenAI、Git、pip、npm,以及
.env和 JSON 配置中的其他密钥。 - 撤销会话与工作负载身份。 除修改密码外,还要撤销个人访问令牌、部署密钥、服务主体凭据和仍有效的会话,检查 OIDC 信任关系及 Managed Identity 权限。
- 审计云端和代码平台日志。 重点查看恶意版本安装后出现的陌生 IP、令牌签发、私有仓库读取、权限变更、镜像推送及云资源创建行为。
- 扩大下游排查范围。 检查在受影响 Runner 上生成或发布的软件包、容器和部署制品,防止被污染的产物继续进入其他环境。
凭据轮换必须在可信设备上完成。如果开发机仍残留启动钩子,用户在同一台机器上创建的新令牌可能再次被窃取,形成看似已经修复、实际持续泄露的循环。
这不是 Agent 框架的功能漏洞,而是发布信任失守
此次事件不应被简单理解为 Agent Framework 本身存在一个普通代码漏洞。现有分析更接近分发渠道被滥用:攻击者重新打包正常 wheel、加入恶意启动文件,再利用官方包的发布身份将其送到 PyPI。
这一差别会直接影响防守方式。代码漏洞通常可以通过升级到修复版本解决,而发布身份遭到滥用后,团队必须进一步核验制品来源、清理缓存、轮换凭据并审计上游发布流程。
微软 Agent Framework 的 AI 属性放大了事件关注度,但攻击手法并不依赖大模型。任何能把 .pth 文件装入 Python 环境、同时拥有大量下载量和自动升级链路的软件包,都可能复制相同路径;Agent 项目只是因为凭据更多、云权限更集中,成为更有价值的入口。
我们的判断是,这次攻击技术上并不复杂,却准确击中了现代 AI 工程最薄弱的一环:开发团队越来越依赖自动化安装、自动升级和短期身份,却仍在用包名、维护者品牌和测试是否通过来判断制品可信度。
PyPI 在 31 分钟内隔离首个版本,响应速度值得肯定,但第二个版本两分钟后再次上传,也暴露出发布身份在初次告警后没有被立刻彻底阻断。对于每月近 20 万次下载的官方软件包,分钟级窗口已经足以让依赖机器人、临时 CI 和容器构建任务把风险带到下游。
参考来源
- IT之家:微软官方 PyPI 包 Agent Framework 遭劫持:事件概况、恶意版本存活时间及凭据窃取范围。
- Microsoft Agent Framework 官方 GitHub 仓库:项目源码、版本记录和官方开发信息。



