适用对象:使用 Microsoft Agent Framework(PyPI 上的 agent-framework 包)的 Python 开发者,以及运行 CI 或负责构建的人员。本文基于 GitHub 安全公告和 PyPI 页面撰写,不涉及攻击技术细节。
持续更新中:随着该组织发布更多信息,本文将随之更新
- 适用对象
使用 Microsoft Agent Framework(PyPI 上的 agent-framework 包)的 Python 开发者,以及运行 CI 或负责构建的人员。
- 已确认的影响范围查看表格 ↓
- 受影响版本
- 发布时间
- 在 PyPI 上的状态
另外1项
- 代码的行为
被列为可能涉及的项目
- 受影响环境中的凭证
- 尚未确认的事项
- 软件包如何被发布,以及微软是否给出任何原因说明
- 版本下架的时间
- 受影响环境的数量
另外1项
- 被窃取的数据是否已被使用
- 现在要做的事查看步骤 ↓
- 查找 1.26.1 或 1.26.2 的安装记录
- 重建任何安装过该版本的环境
- 轮换该环境可访问的凭证
另外2项
- 轮换之后,检查日志中是否有你不认识的使用记录
- 从现在起,固定版本并收窄构建的输入
- 核实来源(出处)全部来源 ↓
- GitHub Advisory Database,《agent-framework(PyPI)中的恶意代码》,GHSA-764m-3ppc-5m73(2026 年 11 月 18 日发布)— github.com
- 最后核实
- 截至 2026 年 11 月 19 日
续报计划与核实记录
该公告于 2026 年 11 月 18 日(UTC)发布。据本站核实,微软尚未发布其自身的安全通告。届时本文将随之更新。
如果你安装过,今天应该做什么
查找 1.26.1 或 1.26.2 的安装记录
在锁定文件、CI 日志、构建缓存、内部软件包镜像和容器镜像中搜索。如果你的构建在未固定版本的情况下使用了最新版本,请重点检查 11 月 17 日 20:35 UTC 之后运行的安装。
从 PyPI 下架并不会删除已经安装或缓存的副本。
重建任何安装过该版本的环境
公告建议,凡安装过任一版本的环境都应视为已暴露。请计划重新创建虚拟环境、容器和 CI 运行器,而不是进行清理。从缓存和镜像中删除受影响的版本,然后使用固定版本(例如 agent-framework==1.26.0)重新安装。
轮换该环境可访问的凭证
轮换在该环境中可见的所有凭证。按公告列出的类别分组处理。
- 环境变量中保存的令牌、密码和 API 密钥
- 云端(如 Azure)、npm、Git 和 Docker 的凭证文件
- Hugging Face 令牌、Azure DevOps 代理凭证和 .env 文件
- CI 令牌(公告称 1.26.2 还针对 GitHub Actions 令牌)
请先处理权限最大的凭证,例如云端管理员账户和 CI 密钥。撤销的顺序与 防范 npm 供应链蠕虫中的相同。
轮换之后,检查日志中是否有你不认识的使用记录
检查云端活动日志、Git 访问历史和软件包仓库的发布历史,查看是否有你未做过的操作。如果发现异常,也请轮换同一环境中的其他凭证。
从现在起,固定版本并收窄构建的输入
使用锁定文件和哈希值固定依赖,不要自动拉取新版本。延迟采用刚发布的新版本也有帮助。关于密钥存放位置,请参阅.env 文件和 API 密钥有哪些风险。
发生了什么(依据 GitHub 公告)
以下内容均基于 GitHub 安全公告数据库中的公告(GHSA-764m-3ppc-5m73,2026 年 11 月 18 日发布)。
2026 年 11 月 17 日 20:35 UTC
agent-framework 1.26.1 发布到 PyPI(仅 wheel 包)。同日 21:08 UTC
agent-framework 1.26.2 发布。之后
两个版本均从 PyPI 下架。公告显示两个版本相隔约 33 分钟。11 月 18 日
GitHub 发布该公告。
- 软件包
- PyPI 上的 agent-framework(Microsoft Agent Framework)
- 受影响版本
- 1.26.1 和 1.26.2;未列出已修复的版本
- 不受影响
- 1.26.0 及更早版本(依据公告)
- 运行方式(依据公告)
- 在 Python 启动时运行,因此在未导入 agent-framework 的情况下也会执行
- 窃取内容
- 环境变量、云端、Git、Docker 和 Hugging Face 的凭证文件,以及 CI 令牌;1.26.2 增加了 GitHub Actions 令牌
- 公告的建议
- 将环境视为已暴露,并轮换可访问的凭证,包括 CI 和 GitHub Actions 密钥
- 归因
- 公告称未将此事件归因于已知的攻击活动
已知与未知的内容
以下为截至 2026 年 11 月 19 日的情况。
| 项目 | 通告内容 | 状态 |
|---|---|---|
| 受影响版本 | agent-framework 1.26.1 和 1.26.2 | 已确认(GitHub 公告) |
| 发布时间 | 11 月 17 日,1.26.1 为 20:35 UTC,1.26.2 为 21:08 UTC | 已确认(GitHub 公告) |
| 在 PyPI 上的状态 | 两者均已下架;PyPI 项目上的最新版本为 1.26.0 | 已确认(公告;已核对 PyPI 页面) |
| 代码的行为 | 收集凭证并将其发送出去 | 已确认(GitHub 公告) |
| 受影响环境中的凭证 | 视为已暴露 | 可能(公告的建议) |
| 1.26.0 及更早版本 | 不在此次入侵范围内 | 不受影响(公告) |
| 软件包的发布方式 | 公告中未提及 | 未说明 |
| 微软的官方通告 | 据本站核实尚未找到 | 调查中 |
| 受影响环境的数量 | 未说明 | 未说明 |
| 被窃取数据的滥用情况 | 未说明 | 未说明 |
如何理解:时间窗口很短并不代表你是安全的
这两个版本上线的时间很短,但如果 CI 任务在未固定版本的情况下拉取最新版本,或者重建恰好在该时间窗口内运行,仍可能被拉取。判断的依据是你的环境是否安装过任一版本,而不是其他人安装了多少。本站不对尚未公布的数字进行推测。
软件包发布流程被滥用时可能发生什么
包管理器会安装以合法发布者名义发布的新版本。一般来说,当发布权限被滥用时,恶意代码会在看似正常更新的情况下进入保存有凭证的环境。公告要求将整个环境视为已暴露,正是基于这一点。
CI 和云端凭证可用于发布源代码、操作云端资源以及发布其他软件包,因此窃取行为可能扩散。两起较早的案例见LiteLLM 1.107.0 事件和TanStack、Nx Console 与 GitHub 相关事件链。
信息来源(公开记录)
本文的事实来自以下公开信息。恶意软件的具体内容、其连接的地址以及具体的指标值均未转载。
- GitHub Advisory Database,《agent-framework(PyPI)中的恶意代码》,GHSA-764m-3ppc-5m73(2026 年 11 月 18 日发布)— github.com
- agent-framework 的 PyPI 项目页面(2026 年 11 月 19 日核对;最新版本为 1.26.0,1.26.1 和 1.26.2 未列出)— pypi.org
更新记录
2026-11-19:首个版本,基于 GitHub 公告和 PyPI 页面。据本站核实,尚未找到微软的官方通告;待其发布后将予以更新。
延伸阅读
- 同类事件:LiteLLM 1.107.0 植入凭证窃取程序 / TanStack、Nx Console 与 GitHub 相关事件链 / Trivy 供应链入侵事件
- 被盗令牌的撤销顺序:防范 npm 供应链蠕虫
- 密钥存放位置:.env 文件和 API 密钥有哪些风险 / 泄露后仍然有效的凭证
- 术语:什么是恶意软件
- 其他 2026 年事件:2026 年的数据泄露与网络攻击