安全指南

Microsoft Agent Framework 在 PyPI 上的版本(agent-framework 1.26.1 和 1.26.2)被植入凭证窃取程序:如果你安装过,需要轮换什么

PyPI 上的 agent-framework 1.26.1 和 1.26.2 包含窃取凭证的代码。依据 GitHub 安全公告:受影响版本、时间窗口以及需要轮换的内容。

发布于 2026-11-19 更新于 2026-11-19 最后核实 2026-11-19 3 分钟阅读
本页目录

适用对象:使用 Microsoft Agent Framework(PyPI 上的 agent-framework 包)的 Python 开发者,以及运行 CI 或负责构建的人员。本文基于 GitHub 安全公告和 PyPI 页面撰写,不涉及攻击技术细节。

持续更新中:随着该组织发布更多信息,本文将随之更新

适用对象

使用 Microsoft Agent Framework(PyPI 上的 agent-framework 包)的 Python 开发者,以及运行 CI 或负责构建的人员。

已确认的影响范围查看表格 ↓
  • 受影响版本
  • 发布时间
  • 在 PyPI 上的状态
另外1项
  • 代码的行为

被列为可能涉及的项目

  • 受影响环境中的凭证
尚未确认的事项
  • 软件包如何被发布,以及微软是否给出任何原因说明
  • 版本下架的时间
  • 受影响环境的数量
另外1项
  • 被窃取的数据是否已被使用
现在要做的事查看步骤 ↓
  1. 查找 1.26.1 或 1.26.2 的安装记录
  2. 重建任何安装过该版本的环境
  3. 轮换该环境可访问的凭证
另外2项
  1. 轮换之后,检查日志中是否有你不认识的使用记录
  2. 从现在起,固定版本并收窄构建的输入
最后核实
截至 2026 年 11 月 19 日
续报计划与核实记录

该公告于 2026 年 11 月 18 日(UTC)发布。据本站核实,微软尚未发布其自身的安全通告。届时本文将随之更新。

如果你安装过,今天应该做什么

1

查找 1.26.1 或 1.26.2 的安装记录

在锁定文件、CI 日志、构建缓存、内部软件包镜像和容器镜像中搜索。如果你的构建在未固定版本的情况下使用了最新版本,请重点检查 11 月 17 日 20:35 UTC 之后运行的安装。

从 PyPI 下架并不会删除已经安装或缓存的副本。

2

重建任何安装过该版本的环境

公告建议,凡安装过任一版本的环境都应视为已暴露。请计划重新创建虚拟环境、容器和 CI 运行器,而不是进行清理。从缓存和镜像中删除受影响的版本,然后使用固定版本(例如 agent-framework==1.26.0)重新安装。

3

轮换该环境可访问的凭证

轮换在该环境中可见的所有凭证。按公告列出的类别分组处理。

  • 环境变量中保存的令牌、密码和 API 密钥
  • 云端(如 Azure)、npm、Git 和 Docker 的凭证文件
  • Hugging Face 令牌、Azure DevOps 代理凭证和 .env 文件
  • CI 令牌(公告称 1.26.2 还针对 GitHub Actions 令牌)

请先处理权限最大的凭证,例如云端管理员账户和 CI 密钥。撤销的顺序与 防范 npm 供应链蠕虫中的相同。

4

轮换之后,检查日志中是否有你不认识的使用记录

检查云端活动日志、Git 访问历史和软件包仓库的发布历史,查看是否有你未做过的操作。如果发现异常,也请轮换同一环境中的其他凭证。

5

从现在起,固定版本并收窄构建的输入

使用锁定文件和哈希值固定依赖,不要自动拉取新版本。延迟采用刚发布的新版本也有帮助。关于密钥存放位置,请参阅.env 文件和 API 密钥有哪些风险。

发生了什么(依据 GitHub 公告)

以下内容均基于 GitHub 安全公告数据库中的公告(GHSA-764m-3ppc-5m73,2026 年 11 月 18 日发布)。

  1. 2026 年 11 月 17 日 20:35 UTC

    agent-framework 1.26.1 发布到 PyPI(仅 wheel 包)。
  2. 同日 21:08 UTC

    agent-framework 1.26.2 发布。
  3. 之后

    两个版本均从 PyPI 下架。公告显示两个版本相隔约 33 分钟。
  4. 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 页面。据本站核实,尚未找到微软的官方通告;待其发布后将予以更新。

延伸阅读

最新快讯

FAQ

Q哪些版本受影响?
A

GitHub 公告列出了 PyPI 上的 agent-framework 1.26.1 和 1.26.2,且未列出已修复的版本。公告称 1.26.0 及更早版本不受影响。两个版本均于 2026 年 11 月 17 日发布,目前已从 PyPI 下架。

Q它们何时上线?
A

据公告,1.26.1 于 2026 年 11 月 17 日 20:35 UTC 发布,1.26.2 于同日 21:08 UTC 发布。公告未给出下架时间。

Q恶意代码会窃取什么?
A

公告称,它会收集名称看似与令牌或密码有关的环境变量、云端、软件包和 Git 工具的凭证文件以及 CI 令牌,并将其发送出去。公告称 1.26.2 增加了 GitHub Actions 令牌。

Q如何检查自己是否安装过?
A

在锁定文件、CI 日志、构建缓存和内部镜像中搜索是否拉取过 agent-framework 1.26.1 或 1.26.2。如果你的构建没有固定版本,请检查是否有安装操作发生在 11 月 17 日的时间窗口内。

Q如果安装过,应该怎么做?
A

公告建议将该环境视为已暴露,并轮换该环境可访问的凭证,包括 CI 和 GitHub Actions 密钥。请重建该环境,并从缓存和镜像中删除受影响的版本。

Q事件的原因是什么?
A

公告未将此事件与已知的攻击活动关联,也未说明软件包是如何被发布的。据本站核实,微软尚未公布事件原因的说明。