Pada 17 November 2026 pukul 20.35 UTC, PyPI menerima unggahan versi 1.26.1 paket agent-framework. Nama itu bukan nama asing bagi praktisi AI: paket tersebut milik Microsoft, menjadi fondasi banyak aplikasi AI agent, dan menurut SecurityWeek mencatat sekitar 190 ribu unduhan per bulan. Tiga puluh tiga menit berselang, versi 1.26.2 menyusul. Pukul 21.30 UTC, kedua versi itu lenyap dari PyPI. Jadi dalam rentang kurang dari satu jam, siapa pun yang menjalankan perintah pemasangan pada waktu yang salah sudah memasang malware, bukan pustaka.
Insiden ini layak menjadi perhatian bukan karena namanya besar. Polanya kini berulang: penyerang tidak membobol aplikasi Anda, tetapi meracuni rantai pasok perangkat lunak yang Anda percaya. Sebuah tim di Jakarta bisa tidak pernah menyentuh kode berbahaya secara sadar, namun tetap kehilangan token Azure dan kredensial GitHub hanya karena satu perintah pemasangan yang terlihat rutin.
Kronologi satu jam yang mengubah paket resmi
Tim riset Wiz merekonstruksi urutan kejadian hampir ke menit. Rilis sah 1.26.0 terbit pada 12 November dan menyertakan wheel sekaligus arsip sumber (sdist). Pola itu berubah pada 17 November.
| Waktu (UTC) | Peristiwa |
|---|---|
| 12 Nov 18.25 | Rilis sah 1.26.0 (wheel + sdist) |
| 17 Nov 20.35 | Versi jahat 1.26.1 muncul di PyPI |
| 17 Nov 21.08 | Versi jahat 1.26.2 menyusul, selisih 33 menit |
| 17 Nov 21.30 | PyPI menghapus kedua versi |
Perhatikan satu detail kecil yang penting. Versi jahat hanya berisi wheel tanpa arsip sumber, sementara rilis sah Microsoft selalu menyertakan keduanya. Selain itu, Wiz tidak menemukan kode berbahaya yang cocok di repositori GitHub Microsoft, sehingga kuat dugaan bahwa paket itu muncul di luar alur rilis normal.
Mengapa pemasangan saja sudah cukup
Banyak developer percaya paket berbahaya baru aktif ketika kode memanggil import. Pada kasus ini kepercayaan itu keliru total. Versi 1.26.1 menjatuhkan berkas agent_framework_meta.pth ke akar site-packages, sedangkan versi 1.26.2 memakai af_runtime_diag.pth.
Python mengeksekusi berkas .pth setiap kali interpreter menyala. Artinya stealer berjalan pada setiap proses Python di lingkungan tersebut, bahkan ketika aplikasi tidak pernah mengimpor agent-framework. Stealer kemudian memisahkan diri ke sesi baru lewat os.setsid(), atau memakai daemon thread bila fork tidak ada, lalu menandai dirinya dengan variabel _AF_TEL=1 agar tidak berjalan dua kali.
Penamaan internal juga sengaja membosankan: modul _telemetry, deskripsi “Lightweight runtime hook”, dan user-agent yang menyerupai telemetri SDK. Tujuannya jelas, yaitu agar aktivitas itu tampak seperti telemetri biasa ketika muncul di log sistem. Karena itu, pemeriksaan manual pada daftar paket yang sudah masuk sering tidak menemukan apa pun yang mencurigakan.
Daftar harta yang menjadi incaran
Fokus pencuri adalah kredensial cloud dan CI. Cakupannya luas karena satu lingkungan developer biasanya menyimpan banyak rahasia sekaligus.
| Kategori | Contoh yang dikumpulkan |
|---|---|
| Variabel lingkungan | Nama yang memuat TOKEN, SECRET, PASSWORD, KEY, AZURE, AWS, GITHUB, OPENAI, HF_, NUGET, PIP |
| Proses lain | Nilai rahasia dari hingga 300 berkas /proc/*/environ |
| Berkas kredensial | ~/.azure/, .npmrc, pip.conf, .netrc, .git-credentials, .docker/config.json, token Hugging Face, .env di /app dan /workspace |
| Token Azure | Managed identity lewat IMDS untuk ARM, Graph, Key Vault, Storage, Azure AI/ML, Container Registry |
| Token OIDC | Azure DevOps (kedua versi) dan GitHub Actions pada versions 1.26.2 |
Penyerang mengemas seluruh hasil menjadi satu dokumen JSON, mengompresnya dengan zlib, meng-encode base64, lalu mengirimkannya lewat satu POST HTTPS ke alamat webhook.site yang tertulis langsung di kode. Tidak ada kanal cadangan, dan setiap kegagalan berlalu tanpa percobaan ulang.
Justru kanal murah itu membatasi dampak. webhook.site gratis hanya menerima 100 permintaan dan kedaluwarsa setelah tujuh hari. Wiz mengonfirmasi 50 permintaan masuk, dan hanya 17 di antaranya berasal dari tiga kasus korban yang benar-benar berhasil. Meski begitu, tiga korban sudah cukup: satu token managed identity yang masih berlaku dapat membuka Key Vault, Storage, dan Container Registry sekaligus.
Akar masalah bukan celah di kode
Wiz menduga penyerang menguasai sertifikat klien dan private key untuk Microsoft ESRP, layanan internal yang menandatangani dan menerbitkan paket tersebut. Filter IP ESRP menolak upaya pertama dari AWS, lalu upaya kedua dari ruang IP milik Microsoft berhasil. Alat penyerang bahkan mengidentifikasi dirinya sebagai Cairn, framework pentest AI open source, dan melaporkan progres ke webhook yang sama.
SafeDep mencatat satu akun maintainer PyPI bernama vibiret yang baru muncul pada hari serangan dengan izin publikasi untuk paket ini dan lima proyek terkait. Belum ada konfirmasi atas keterlibatan langsung akun tersebut. Namun temuan itu menunjukkan titik lemah yang jauh lebih umum: izin publikasi pada PyPI masih terlalu mudah menumpuk di satu akun, dan tim jarang memperlakukan sertifikat rilis sebagai aset bernilai tinggi.
Enam langkah memeriksa proyek Anda malam ini
Anda tidak perlu menunggu pengumuman resmi untuk mulai memeriksa. Anda cukup menjalankan enam langkah berikut sekali di mesin developer dan runner CI.
- Cari versi di lockfile dan riwayat CI. Jalankan
grep -rn "agent-framework" requirements*.txt pyproject.toml uv.lock poetry.lockdan periksa log build yang menyebut 1.26.1 atau 1.26.2. - Periksa isi site-packages. Cari
agent_framework_meta.pth,agent_framework_meta/_telemetry.py,af_runtime_diag.pth, danaf_runtime_diag.py. Bila salah satunya ada, setiap proses Python di lingkungan itu sudah menjalankan payload. - Cocokkan hash wheel. Wheel 1.26.1 memiliki SHA256
d27fa34414e6...dan 1.26.23d20a8bc9135.... Kecocokan berarti paket di lingkungan itu memang versi jahat. - Periksa lalu lintas keluar. Cari alamat
webhook.site/d381fd80-ec62-42ad-8f5c-d1b15103c9bbdi log proxy dan DNS. Respons 200 berarti server penyerang menerima data korban. - Kunci ulang ke 1.26.0 atau versi lebih baru yang sudah jelas bersih, lalu bangun ulang lingkungan dari nol. Menghapus berkas .pth saja tidak memulihkan kredensial yang sudah keluar.
- Rotasi kredensial. Ganti semua rahasia yang pernah ada di lingkungan tersebut: sesi Azure CLI, PAT Azure DevOps, token npm, PyPI, NuGet, Docker, Hugging Face, serta kredensial git.
Untuk tim yang memakai Azure, langkah lanjutan yang sering terlewat adalah audit identitas. Token managed identity dan token hasil pertukaran OIDC berlaku hingga 24 jam, jadi periksa log sign-in untuk identitas mana pun yang punya akses dari VM, App Service, node AKS, atau pipeline yang memasang versi jahat.
Pengerasan yang bertahan lebih lama
Pemeriksaan di atas menyelesaikan insiden hari ini. Agar tidak mengulang pola yang sama, kunci versi dan kunci hash. Perintah berikut menghasilkan lockfile berisi hash untuk setiap dependensi, termasuk dependensi transitif.
# Bangun lockfile dengan hash
pip-compile --generate-hashes --output-file requirements.txt requirements.in
# Pasang dengan penegakan hash: artifact dengan isi berbeda gagal lolos
pip install --require-hashes -r requirements.txt Dengan --require-hashes, penyerang yang menerbitkan ulang artifact dengan nomor versi sama tetap gagal masuk. Selain itu, hindari extra-index-url pada indeks privat, karena setelan itu membuat pip membandingkan dua indeks sekaligus dan membuka jalan dependency confusion. Untuk paket yang tim Anda terbitkan, pakai Trusted Publishing berbasis OIDC supaya tidak ada token unggah berumur panjang yang menetap di CI.
Kebiasaan ini melengkapi langkah dasar yang sudah saya bahas di panduan keamanan di hari pertama aplikasi, terutama soal pemisahan rahasia produksi dari lingkungan build. Prinsipnya sederhana: jalankan pemasangan dependensi di lingkungan yang tidak memegang kredensial produksi.
Bagian yang sering terlewat: image dan cache
Insiden seperti ini hampir selalu meninggalkan jejak di tempat yang jarang Anda periksa. Cache pip di runner CI dapat menyimpan wheel jahat berbulan-bulan, dan image container yang Anda bangun pada 17 November memuat paket tersebut secara permanen. Karena itu, bangun ulang image dari Dockerfile bersih, bukan menambal layer lama. Praktik multi-stage build membantu di sini karena setiap pembangunan ulang memakai basis yang bersih dan dependensi tidak menumpuk di layer lama.
Sebagai perbandingan, insiden serupa menimpa paket Python Microsoft lain, durabletask, setelah penyerang mencuri token PyPI-nya. Artinya pola serangan pada rilis resmi bukan kejadian tunggal, melainkan tren yang perlu Anda asumsikan akan berulang.
Jika tim Anda memakai model bahasa lewat API pihak ketiga, risiko yang sama berlaku pada kunci API. Saya sudah merangkum langkah pengamanannya di artikel mengamankan kunci API AI dari penyalahgunaan, dan sebagian besar prinsipnya sejalan: rotasi cepat, batasi cakupan, serta pisahkan kunci per lingkungan.
Kesimpulan
Serangan pada agent-framework menunjukkan bahwa kepercayaan pada nama besar bukan kontrol keamanan. Penyerang tidak perlu menulis kode aplikasi Anda; mereka cukup memakai jalur rilis resmi selama 55 menit. Pertahanan yang realistis terdiri dari tiga lapis: kunci versi dengan hash, lingkungan build tanpa kredensial produksi, dan kemampuan mendeteksi eksekusi otomatis seperti berkas .pth di site-packages.
Pada akhirnya, pertanyaan yang perlu Anda ajukan bukan apakah pustaka itu populer, melainkan apakah Anda bisa membuktikan isi artifact yang Anda pasang. Bila jawabannya belum, mulai dari satu proyek hari ini: buat lockfile berhash, lalu jalankan pemasangan dengan penegakan hash di CI.
Referensi
- Wiz Research: Microsoft agent-framework Compromised
- SecurityWeek: Microsoft Agent Framework Releases Poisoned With Credential Stealer
- Safeguard: Securing Python Packages on PyPI (2026 Guide)
- GitHub Discussion: microsoft/agent-framework issue 10411