微软智能体框架两版 PyPI 包被植入恶意代码
据文章援引的安全公告,PyPI 上的 agent-framework 1.26.1 和 1.26.2 含有在 Python 启动时运行的凭证窃取代码。两版已被移除,文中列出的最后一个未受影响版本是 1.26.0。
AI 深度解读
2026 年 11 月 17 日晚(UTC),Microsoft 的 agent-framework 在 PyPI 上出现了两个带凭据窃取代码的版本:1.26.1 和 1.26.2。两版当晚下架,但构建镜像、内部镜像源和 pip 缓存仍可能留着它们。
最容易漏查的是 CI。一个以 React 或 Node 为主的项目,只要构建流水线装过这个 Python 包,就要核对当时实际装了哪个版本。命中后先别运行 python 或 pip,因为窃取代码会在 Python 启动时执行。
两个版本都下架了,为什么还要查旧构建?
GitHub 安全公告 GHSA-764m-3ppc-5m73 把受影响范围限定在 PyPI 上的 agent-framework 元包。元包主要负责拉入其他依赖,两版都指定了 agent-framework-core[all]==1.26.0,恶意文件却随元包自己的 wheel 发布。只装 agent-framework-core 的项目不在此次影响范围内。Endor Labs 检查了 22 个同系列的 agent-framework-* 包,未发现它们在 11 月 12 日后发布新版本。原文也没有报告 npm 或 NuGet 包遭篡改,两者的凭据在窃取范围内。
1.26.1 和 1.26.2 分别约在 20:35 和 21:08 UTC 上传,均只发布了 wheel。1.26.2 在第一版被撤下后仍能上传,说明发布通道当时仍可用。各来源对第二版的下架时间略有出入,Wiz 称两版在 21:30 UTC 前均已撤下。公告列出的最后一个干净版本是 11 月 12 日发布的 1.26.0,该版本及更早版本不受影响,公告也未列出更新的修复版本。
如果流水线用了 pip install agent-framework,或声明了 agent-framework>=1.x 这类浮动范围,优先查 11 月 17 日约 20:35 至 21:30 UTC 的构建。使用 Artifactory、Nexus 或 pip 缓存的团队还要往后查,因为上游撤包后,缓存仍可能把旧 wheel 交给下一次构建。
为什么业务没导入这个包,凭据也可能泄露?

恶意 wheel 把 .pth 文件放进 site-packages。Python 启动并处理这个目录时,可以执行 .pth 中的导入语句,所以业务代码即使从未 import agent_framework,同一环境里启动 pip 也可能触发载荷。1.26.1 用 agent_framework_meta.pth 加载 agent_framework_meta/_telemetry.py。1.26.2 改用 af_runtime_diag.pth 和顶层的 af_runtime_diag.py,还恢复了原来的 __init__.py,让改动更难察觉。
根据公告和研究团队的分析,载荷会筛选名称含 TOKEN、SECRET、KEY、AZURE、AWS、GITHUB、OPENAI、HF_、NPM 或 CI_ 等字符串的环境变量,并尝试读取最多 300 个其他进程的环境。它也会查找 ~/.azure、.npmrc、.netrc、.git-credentials、.docker/config.json、pip.conf、Hugging Face token,以及 /app 和 /workspace 下的 .env 或 JSON 文件。
风险还包括临时身份。载荷会向 Azure 实例元数据端点请求约十余种服务的托管身份令牌,并收集 Azure DevOps 流水线令牌。1.26.2 还会尝试获取拥有 id-token: write 权限的 GitHub Actions 作业的 OIDC 令牌。收集到的数据会通过一次 HTTP POST 发往 webhook.site,原文列出的 User-Agent 是 af-runtime-diagnostics/1 和 runtime-diagnostics/1。
装过以后,重建环境和审计凭据要怎么做?
先从环境外核对安装记录。在 uv.lock、poetry.lock、requirements*.txt 和 CI 日志里搜索 agent-framework==1.26.1、agent-framework==1.26.2,以及 agent_framework-1.26.1、agent_framework-1.26.2 开头的 wheel。也要看 11 月 17 日以来构建的容器镜像。用 find 或 ls 检查可疑环境的 site-packages,避开可能再次触发载荷的 python 和 pip。
找到恶意版本后,从干净基础环境重建虚拟环境和镜像,固定 agent-framework==1.26.0,用 pip install --require-hashes 或 uv、Poetry 锁文件校验依赖,并在包代理上封禁两个恶意版本。凭据轮换要按当时环境能读到的范围做,包括 OpenAI、Azure OpenAI、Anthropic 等服务的密钥,云和 CI 凭据,GitHub、npm、PyPI 和 Hugging Face 的令牌,Docker 仓库登录凭据、.env 里的数据库连接串,以及开发机上保存的 Azure CLI 会话和 Git 凭据。
轮换后还要查已签发的短期令牌。被取走的托管身份和 OIDC 令牌可能一直有效到过期,Wiz 提到 Azure 令牌最长可达 24 小时。查构建机或服务器的出站日志时,可用上面的域名和 User-Agent 缩小范围。在 Entra ID 里查托管身份和服务主体的登录、令牌使用、新增联合凭据和角色分配。命中过 1.26.2 且开了 id-token: write 的作业,还要去 AWS、Azure 或 GCP 看它联邦到的角色实际执行了什么。GitHub 的部署密钥、个人访问令牌和 Actions secrets,以及模型服务商后台的用量、模型和 API key,也在核查范围内。
我的判断
锁版本加哈希,是这篇最能直接落地的建议。只看包名或仓库归属,无法判断构建时下载的 wheel 是否符合预期。让新版本晚几天再进入构建,确实能避开一部分短时投毒,但收益取决于异常能否及时被发现。原文没有给出对照数据,延迟升级属于经验建议。升级到高于 1.26.0 的版本前,可以核对仓库是否有对应 tag,同时继续校验实际安装的文件。
根因和影响范围也要分开判断。Wiz 推测,攻击者使用了 Microsoft 内部发布流水线遭泄露的客户端证书,证书如何取得仍未知。项目维护者据报道确认了撤包和调查,截至 11 月 20 日,原文称 Microsoft 尚未发布公告。Wiz 在能观察到的外传请求里只看到少量真实受害者数据,这只反映其观测范围。自己的构建一旦确认装过恶意版本,仍应按该环境可访问的凭据处理。
能拿来做什么
- 如果前端或 Node 仓库会在 CI 里拉起 Python agent 服务,顺着工作流检查每一步的安装命令,确认它实际消费了锁文件,并从构建日志核对解析出的版本。
- 如果两个版本都没在锁文件里出现,再查 11 月 17 日以来实际构建过的镜像和内部包代理。事发后提交的锁文件无法还原历史安装结果。
- 检查 GitHub Actions 的 job 级权限,把
id-token: write留给需要联邦登录的部署作业,并从安装依赖、构建和测试的环境中移出生产密钥。