資安指南

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 或建置流程的人員。

已確認的影響範圍查看表格 ↓

列為可能涉及的項目

  • 受影響環境中的憑證
尚未確認的事項
  • 套件如何發布,以及 Microsoft 是否說明成因
  • 版本何時被移除
  • 受影響環境的數量
另外1項
  • 被竊取的資料是否已遭濫用
現在要做的事查看步驟 ↓
  1. 尋找 1.26.1 或 1.26.2 的紀錄
  2. 重建任何安裝過該版本的環境
  3. 輪換該環境可存取的憑證
另外2項
  1. 輪換後,檢查紀錄中是否有你不認得的使用行為
  2. 從現在起,固定版本並縮小建置的輸入範圍
最後查證
截至 2026 年 11 月 19 日
續報計畫與查證紀錄

公告於 2026 年 11 月 18 日(UTC)發布。據本站所能查證,Microsoft 尚未發布自身的安全通告。屆時本文將更新。

若你已安裝,今天該做什麼

1

尋找 1.26.1 或 1.26.2 的紀錄

請搜尋 lockfile、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

從現在起,固定版本並縮小建置的輸入範圍

請使用 lockfile 與雜湊值固定依賴版本,並避免自動拉取新版本。延後採用剛發布的新版本也有幫助。關於密鑰的存放位置,請參閱 .env 檔案與 API 金鑰的風險在哪裡。

發生了什麼(依 GitHub 公告)

以下內容皆依據 GitHub Advisory Database 中的公告(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 及更早版本不在此次入侵範圍內不受影響(公告)
套件如何發布公告未提及未說明
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 的通告;一旦發布,本文將更新。

延伸閱讀

最新快訊

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

請在 lockfile、CI 紀錄、建置快取與內部鏡像中搜尋 agent-framework 1.26.1 或 1.26.2 的拉取紀錄。若你的建置未固定版本,請檢查 11 月 17 日那段時間內是否有任何安裝執行。

Q如果我安裝過,該怎麼辦?
A

公告建議將該環境視為已暴露,並輪換可從該環境存取的憑證,包括 CI 與 GitHub Actions 的密鑰。請重建該環境,並從快取與鏡像中刪除受影響的版本。

Q事件的成因是什麼?
A

公告未將此事件與已知的攻擊行動連結,也未說明套件是如何發布的。據本站所能查證,Microsoft 尚未公布成因的說明。