適用對象:使用 Microsoft Agent Framework(PyPI 上的 agent-framework 套件)的 Python 開發者,以及負責 CI 或建置流程的人員。本文依據 GitHub 安全公告與 PyPI 套件頁面撰寫,不涵蓋攻擊技術細節。
進行中:隨著組織發布更多資訊,本文將持續更新
- 適用對象
使用 Microsoft Agent Framework(PyPI 上的 agent-framework 套件)的 Python 開發者,以及負責 CI 或建置流程的人員。
- 已確認的影響範圍查看表格 ↓
列為可能涉及的項目
- 受影響環境中的憑證
- 尚未確認的事項
- 套件如何發布,以及 Microsoft 是否說明成因
- 版本何時被移除
- 受影響環境的數量
另外1項
- 被竊取的資料是否已遭濫用
- 現在要做的事查看步驟 ↓
- 尋找 1.26.1 或 1.26.2 的紀錄
- 重建任何安裝過該版本的環境
- 輪換該環境可存取的憑證
另外2項
- 輪換後,檢查紀錄中是否有你不認得的使用行為
- 從現在起,固定版本並縮小建置的輸入範圍
- 查證來源(出處)全部來源 ↓
- GitHub Advisory Database,「Malicious code in agent-framework (PyPI)」,GHSA-764m-3ppc-5m73(2026 年 11 月 18 日發布)— github.com
- 最後查證
- 截至 2026 年 11 月 19 日
續報計畫與查證紀錄
公告於 2026 年 11 月 18 日(UTC)發布。據本站所能查證,Microsoft 尚未發布自身的安全通告。屆時本文將更新。
若你已安裝,今天該做什麼
尋找 1.26.1 或 1.26.2 的紀錄
請搜尋 lockfile、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 存取歷史與套件倉庫的發布歷史,查看是否有你未執行的操作。若發現異常,也請輪換該環境中的其他憑證。
從現在起,固定版本並縮小建置的輸入範圍
請使用 lockfile 與雜湊值固定依賴版本,並避免自動拉取新版本。延後採用剛發布的新版本也有幫助。關於密鑰的存放位置,請參閱 .env 檔案與 API 金鑰的風險在哪裡。
發生了什麼(依 GitHub 公告)
以下內容皆依據 GitHub Advisory Database 中的公告(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 及更早版本 | 不在此次入侵範圍內 | 不受影響(公告) |
| 套件如何發布 | 公告未提及 | 未說明 |
| Microsoft 自身的通告 | 據本站查證尚未找到 | 調查中 |
| 受影響環境數量 | 未說明 | 未說明 |
| 被竊資料遭濫用的情形 | 未說明 | 未說明 |
如何解讀:時間窗口短並不代表你安全
這兩個版本上線的時間很短,但若 CI 工作未固定版本而直接抓取最新版,或建置恰好在該時段執行,仍可能拉取到它們。請以你的環境是否安裝過任一版本來判斷,而非看有多少其他人受影響。本站不會推測尚未公布的數字。
當套件發布流程遭濫用時可能發生什麼
套件管理工具會安裝以合法發布者名義發布的新版本。一般而言,當發布權限遭到濫用,惡意程式碼便可能在看似正常更新的情況下,進入保有憑證的環境。公告要求將整個環境視為已暴露,正是基於此種情況。
CI 與雲端憑證可用於發布原始碼、操作雲端資源及發布其他套件,因此竊取的影響可能擴散。兩個較早的案例請見 LiteLLM 1.107.0 事件與 TanStack、Nx Console 與 GitHub 的連鎖事件。
資料來源(公開紀錄)
本文事實來自以下公開資訊。惡意程式的詳細內容、其連線的位址及具體的指標值均未收錄。
- GitHub Advisory Database,「Malicious code in 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 套件頁面撰寫。據本站所能查證,尚未找到 Microsoft 的通告;一旦發布,本文將更新。
延伸閱讀
- 同類事件:LiteLLM 1.107.0 夾帶竊取憑證程式 / TanStack、Nx Console 與 GitHub 的連鎖事件 / Trivy 供應鏈入侵事件
- 被竊權杖的撤銷順序:防禦 npm 供應鏈蠕蟲
- 密鑰的存放位置:.env 檔案與 API 金鑰的風險在哪裡 / 仍然有效的外洩憑證
- 名詞解釋:什麼是惡意軟體
- 其他 2026 年事件:2026 年的資料外洩與網路攻擊