対策・学習10分で読める

Microsoft Agent Framework(PyPIの agent-framework 1.26.1・1.26.2)の改ざん:入れた環境の認証情報を回収し直す人がやること

PyPIの agent-framework 1.26.1と1.26.2に認証情報を盗むコードが入っていました。GitHubの勧告にもとづき、対象の版、公開時間、入れてしまった環境で回すべき認証情報を整理します。

本文を読む
公開日
更新日
最終確認
目次

対象:PythonでMicrosoft Agent Framework(PyPIの agent-framework)を使っている開発者、CIやビルドを管理している人。本記事はGitHubのセキュリティ勧告とPyPIの掲載状況にもとづく解説で、攻撃手順は扱いません。

続報待ち:この記事は公式発表に合わせて更新します

対象者

PythonでMicrosoft Agent Framework(PyPIの agent-framework)を使っている開発者、CIやビルドを管理している人。

影響が確認された範囲表で見る ↓
  • 対象の版
  • 公開時刻
  • PyPIでの状態
さらに1件
  • 悪意あるコードの内容

可能性があるとされた項目

  • 入れた環境の認証情報
未確認事項
  • 侵入の経路と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を入れた記録を探す

ロックファイル、CIのログ、ビルドのキャッシュ、社内のパッケージミラー、コンテナのイメージを調べます。版を固定せず「最新」を入れる設定だった環境は、11月17日(UTC)の20:35〜に走ったインストールを重点的に見ます。

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分の間に2版が出たことを示す。
  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の勧告)
公開時刻1.26.1は20:35 UTC、1.26.2は21:08 UTC(11月17日)確定(GitHubの勧告)
PyPIでの状態両版とも削除済み。PyPIのプロジェクトで最新は1.26.0確定(勧告、PyPIの掲載で確認)
悪意あるコードの内容認証情報を集めて外部へ送る確定(GitHubの勧告)
入れた環境の認証情報漏えいしたものとして扱う可能性(勧告の指示)
1.26.0以前対象外含まれない(勧告)
侵入の経路勧告に記載なし記載なし
Microsoftの発表確認できた範囲では未公表調査中
影響を受けた環境の数記載なし記載なし
盗まれた情報の悪用記載なし記載なし

読み方の注意:公開が短時間でも、安全とは限らない

2つの版が公開されていた時間は短い一方で、版を固定せず自動で最新を取り込む設定のCIや、再ビルドが走る環境は、その間に取り込む可能性があります。「どれくらいの人が入れたか」ではなく、自分の環境に入ったかどうかで判断してください。当サイトは、公表されていない件数を推測しません。

版を自動で取り込む環境で何が起きうるか

パッケージ管理の仕組みは、正規の公開者の名前で新しい版が出ると、そのまま取り込まれます。一般に、公開の権限が悪用されると、見た目は正規の更新のまま、認証情報を持つ環境に悪意あるコードが届きます。今回の勧告も、版が増えただけで環境が漏えいした扱いになる点を示しています。

CIやクラウドの認証情報は、ソースコードの公開、クラウドの操作、ほかのパッケージの公開などに使えるため、持ち出されると影響が連鎖します。この連鎖の例は、LiteLLM 1.107.0の事案とTanStack・Nx Consoleの事案で整理しています。

出典(公開記録)

本記事の事実関係は以下の公開情報にもとづきます。マルウェアの中身の詳細、送信先、個別の指標値は載せません。

  • GitHub Advisory Database「Malicious code in agent-framework (PyPI)」GHSA-764m-3ppc-5m73(2026年11月18日公開) — github.com
  • PyPI「agent-framework」のプロジェクトのページ(2026年11月19日に確認。最新版は1.26.0で、1.26.1・1.26.2は掲載されていない) — pypi.org

更新履歴

2026-11-19:初版。GitHubの勧告とPyPIの掲載状況にもとづく。Microsoftの発表は確認できた範囲では見つからず、出たら更新します。

次に読む

最新の速報

速報の一覧 →

よくある質問

Qどの版が影響を受けますか?
A

GitHubの勧告は、PyPIの agent-framework の1.26.1と1.26.2を対象とし、修正版はないとしています。1.26.0以前は対象外とされています。どちらも2026年11月17日に公開され、現在はPyPIから削除されています。

Qいつ公開されていましたか?
A

勧告によると、1.26.1は20:35 UTC(日本時間11月18日5:35)、1.26.2は21:08 UTC(同6:08)に公開されました。削除された時刻は勧告に書かれていません。

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

勧告は、特定のキャンペーンに結びつけておらず、侵入の経路には触れていません。Microsoftによる原因の説明は、確認できた範囲では公表されていません。