Zum Inhalt springen
senn-techsenn-tech
Zurück zum Blog
Security
Security und Datenschutz2026-11-22· Von Franz Senn

Microsofts agent-framework auf PyPI: Ein .pth-Hook stahl Zugangsdaten

Am 17. November 2026 haben Unbekannte zwei Versionen des Pakets agent-framework auf PyPI veröffentlicht, des Python-Pakets von Microsofts Agent Framework. Beide enthielten einen Dieb für Zugangsdaten, der bei jedem Start von Python läuft, auch wenn niemand das Paket importiert. Nach etwa 41 Minuten war die letzte Version von PyPI isoliert. Dieser Beitrag nennt Zeiten, Dateien und Quellen, zeigt den Mechanismus an einer harmlosen Probe und listet, was ein Admin prüfen und rotieren sollte.

Eine .pth-Datei ist eine Textdatei im site-packages-Ordner einer Python-Installation. Beim Start des Interpreters liest das Modul site jede .pth-Datei; Zeilen, die mit import beginnen, führt Python per exec() aus, unabhängig davon, ob ein Programm das zugehörige Paket später verwendet. Wer ein Paket installiert, das eine solche Datei mitbringt, startet damit bei jedem folgenden Python-Aufruf fremden Code. Nur der Startschalter -S verhindert das.

Wortmarke von Microsoft
Das Paket trägt Microsofts Namen und gehört zum Projekt microsoft/agent-framework. Die manipulierten Versionen stammen nach den Berichten nicht aus dessen Quellcode. (Quelle: Datei via Wikimedia Commons, gemeinfrei, Marke: Microsoft)

Was die Quellen übereinstimmend sagen

Die Eckdaten stehen im GitHub-Advisory GHSA-764m-3ppc-5m73, veröffentlicht am 18. November 2026 als Malware-Eintrag, Schwäche CWE-506 (eingebetteter Schadcode), ohne gepatchte Version. Die Beschreibung nennt 1.26.1 (20:35 UTC, nur als Wheel) und 1.26.2 (21:08 UTC) und hält fest, dass die Datei agent_framework_meta.pth beziehungsweise af_runtime_diag.pth den Code beim Interpreterstart auslöst. Wiz, Aikido, StepSecurity und Socket decken sich in Dateinamen und Datenziel. Ein CVE nennt keine geöffnete Quelle.

MerkmalVersion 1.26.1Version 1.26.2
Hochgeladen (UTC, 17.11.2026)20:35:2021:08:39
Startdateiagent_framework_meta.pthaf_runtime_diag.pth (eine Zeile: import af_runtime_diag)
Schadcodeagent_framework_meta/_telemetry.pyaf_runtime_diag.py
__init__.pyacht Zeilen angehängtauf den Stand von 1.26.0 zurückgesetzt
User-Agent beim Sendenaf-runtime-diagnostics/1runtime-diagnostics/1
Zusätzlichnur Azure-IdentitätenGitHub-Actions-OIDC-Token, 80 statt 60 Dateien
Isoliert (UTC)21:06:1621:16:44

Messeinheit: Uhrzeit auf die Sekunde, Dateinamen, Anzahl Dateien. Messdatum der Quellen: 17. bis 18. November 2026, von uns am 22. November 2026 gelesen. Messträger: Anbieteranalysen von StepSecurity (Uhrzeiten) sowie Wiz, Aikido und Socket (Dateien). Die Wheels haben wir nicht selbst zerlegt, ihre Prüfsummen stehen bei StepSecurity und im Advisory.

Beide Versionen blieben vom echten agent-framework-core[all]==1.26.0 abhängig, das Framework lief also normal. Der Dieb löst sich laut Advisory in einen Hintergrundprozess, setzt _AF_TEL=1 gegen Neustarts in Kindprozessen und unterdrückt alle Fehler.

Vom pip install zum fremden POSTpip installagent-framework1.26.1 oder 1.26.2, auchüber Bereiche wie >=1.26.pth landet insite-packagesagent_framework_meta.pthoder af_runtime_diag.pthPython startetjeder Aufruf, auch pipselbst, ohne import desPaketsDieb sammeltUmgebung, Dateien, Azure-und CI-Tokenein POST nachwebhook.sitezlib, Base64, ohneAusweichkanal
(Quelle: GitHub-Advisory GHSA-764m-3ppc-5m73)

Was gestohlen wurde

Nach Wiz, Aikido und Socket sammelt der Dieb in einem Durchlauf:

  • Umgebungsvariablen, deren Name zum Beispiel TOKEN, SECRET, PASSWORD, KEY, AZURE, AWS, GITHUB oder OPENAI enthält, dazu die Umgebung anderer Prozesse aus /proc/<pid>/environ (bis zu 300 Prozesse).
  • Dateien: Azure-CLI-Zustand unter ~/.azure, pip.conf, .npmrc, .netrc, .git-credentials, Docker-config.json, Hugging-Face-Token, Azure-DevOps-Agent-.credentials und .env-Dateien in /app und /workspace.
  • Frische Identitäten: Zugriffstoken der Azure Managed Identity für zwölf Ressourcen über den lokalen Metadatendienst, Azure-DevOps-OIDC-Token und, nur in 1.26.2, GitHub-Actions-OIDC-Token.

Das Ziel ist webhook.site, ein öffentlicher Dienst zum Betrachten von Anfragen. StepSecurity merkt an, dass eine Verbindung zur Domain allein keinen Abfluss belegt und die Analyse Versuche zeigt, keine erfolgreich ausgestellten Token. Wiz wertete die 50 gespeicherten Anfragen auf dem kostenlosen Konto des Angreifers aus: 17 davon ergeben nur drei erfolgreiche Opferfälle (Anbieterangabe, nicht nachgeprüft).

Wo die Quellen auseinandergehen

Zwei Punkte sind uneinheitlich, ein dritter fehlt.

Das Ende des Fensters. Aikido nennt beide Versionen gegen 21:20 UTC entfernt, Wiz gegen 21:30 nicht mehr verfügbar, StepSecurity zeigt die Isolation von 1.26.1 um 21:06:16 und von 1.26.2 um 21:16:44. Mit den Zeiten von StepSecurity war 1.26.1 30 Minuten 56 Sekunden erreichbar, 1.26.2 8 Minuten 5 Sekunden, die Gesamtspanne 41 Minuten 24 Sekunden (eigene Rechnung). BleepingComputer schreibt, die zweite Version sei etwa 2,5 Minuten nach der ersten erschienen. Nach StepSecurity liegen zwischen den Uploads 33 Minuten und 2 Minuten 23 Sekunden zwischen der Isolation der ersten Version und dem Upload der zweiten. Die 2,5 Minuten gehören vermutlich zur zweiten Zahl.

Reichweite. Aikido nennt rund 190.000 Downloads im Monat, Wiz rund 41.000 in der Woche: zwei Einheiten, beide Anbieterangaben. Wie viele Installationen in das Fenster fielen, belegt keine geöffnete Quelle.

Ursache. Wiz schreibt am 18. November, der Angreifer habe offenbar ein Clientzertifikat samt privatem Schlüssel für Microsofts Veröffentlichungsdienst ESRP kompromittiert; ein erster Versuch aus einem AWS-Netz sei an der IP-Filterung gescheitert, ein zweiter aus Microsoft-eigenem Adressraum gelungen. Wie das Zertifikat abgeflossen ist, ist offen. StepSecurity hält dagegen fest, der Erstzugang, das benutzte Konto und die Identität des Hochladenden seien aus den Belegen nicht bestimmbar. Dort steht ein am selben Tag angelegtes Betreuerkonto und keine Herkunftsbestätigung der Wheels. BleepingComputer meldet, der Einbruchspunkt sei unklar. Eine Stellungnahme von Microsoft steht in keiner der geöffneten Quellen: BleepingComputer hatte bis zur Veröffentlichung keine Antwort. Das GitHub-Issue #10411 im Microsoft-Repo, das Presseberichte erwähnen, konnten wir nicht öffnen (Anmeldewand). Die ESRP-Herleitung bleibt eine Anbieterangabe von Wiz.

Auf der PyPI-Seite des Pakets (am 22. November 2026 gelesen) ist 1.26.0 vom 12. November 2026 die aktuelle Version. 1.26.1 und 1.26.2 stehen nicht in der Liste, und ein Hinweis auf eine Entfernung gibt es dort nicht.

Markenzeichen von PyPI
PyPI hat nach StepSecurity beide Versionen isoliert, um 21:06 und 21:16 UTC. (Quelle: Simple Icons, Datei pypi.svg (CC0), Marke: Python Software Foundation)

Wie eine .pth-Datei startet: unsere Messprobe

Die Python-Dokumentation zum Modul site sagt es so: Zeilen in .pth-Dateien, die mit import beginnen, werden aus Gründen der Rückwärtskompatibilität per exec() ausgeführt. Eine Anmerkung dort hält fest, dass solche Zeilen beim Start immer laufen, außer wenn -S die Datei site.py ganz abschaltet. Seit Python 3.15 sind sie als veraltet markiert, laufen aber weiter, und eine Warnung erscheint nur mit -v.

Eigene Probe vom 22. November 2026 in zwei frischen virtuellen Umgebungen (Python 3.14.4 und 3.15.2): In jeder liegt eine demo.pth mit der Zeile import demo_hook, und demo_hook.py druckt nur eine Meldung. Der Hook hat keine Schadfunktion und keine Netzverbindung.

AufrufPython 3.14.4Python 3.15.2
python -c passHook läuftHook läuft
python -I -c pass (isoliert)Hook läuftHook läuft
python -S -c passHook läuft nichtHook läuft nicht
python -m pip --versionnicht gemessenHook läuft

Messeinheit: Hook läuft ja oder nein. Messdatum: 22. November 2026. Messträger: Linux-Rechner (aarch64) mit Distributions-Python 3.14.4 und einer zweiten Installation 3.15.2. Eigene Messung.

Zwei Folgen für die Praxis. Erstens: -I schützt nicht, denn der Hook lief in beiden Umgebungen auch mit -I (gemessen). Zweitens: Wer auf einem verdächtigen Rechner pip show oder python -m pip list ausführt, startet den Hook erneut. Erst mit find und grep die Dateien suchen, dann Python benutzen.

So prüfen Sie Ihre Umgebung

Alle Befehle sind lesend. Der erste kommt ohne Python aus:

find / -xdev \( -name 'agent_framework_meta.pth' -o -name 'af_runtime_diag.pth' \
  -o -name 'af_runtime_diag.py' -o -name '_telemetry.py' -path '*agent_framework_meta*' \) 2>/dev/null
find / -xdev -name '*.pth' -exec grep -lE '^import[[:space:]]' {} + 2>/dev/null

Der zweite Befehl listet alle .pth-Dateien mit ausführbarer Zeile. Legitime Treffer gibt es: Bei uns zeigte er die distutils-precedence.pth von setuptools im Systempfad einer Linux-Distribution, auch Editable-Installationen schreiben solche Dateien. Entscheidend ist der Vergleich mit einer bekannten guten Umgebung.

Danach pip list | grep -i agent-framework oder uv pip list in jeder virtuellen Umgebung, jedem seit dem 17. November 2026 gebauten Image und den CI-Caches. Nach unserer Messung listet pip cache list nur lokal gebaute Wheels (bei uns leer, pip 26.3), heruntergeladene Wheels stehen dort nicht. Deshalb: den Pip-Cache leeren (pip cache purge, bei uv uv cache clean agent-framework) und Lockfiles und CI-Protokolle nach 1.26.1 und 1.26.2 durchsuchen. Im Netz hilft die Suche nach webhook.site in Proxy- und DNS-Protokollen.

Unser eigener Befund vom 22. November 2026, nur lesend: Wir setzen das Paket nicht ein. In unseren Repositories gab es null Treffer auf agent-framework, und in den Paketlisten (pip list) und der Dateisuche von zehn Containern auf zwei Linux-Hosts auch keine. Das gilt für diese geprüfte Menge. Nur ein Teil der Systeme war dabei, andere virtuelle Umgebungen und Einzelrechner sind nicht durchsucht.

Was dagegen hilft, dass es wieder passiert

Fest pinnen und Hashes prüfen. Ein Bereich wie agent-framework>=1.26 hätte am 17. November 2026 die Schadversion gezogen, ein Pin auf ==1.26.0 nicht. Der pip-Hash-Modus (pip install --require-hashes -r requirements.txt) verlangt für jede Anforderung einen Pin mit == und einen Hash, auch für Abhängigkeiten, die man nicht selbst genannt hat; fehlt einer, bricht pip ab. Das Projekt selbst installiert man mit --no-deps. Ein Hash schützt vor einer anderen Datei unter derselben Version. Wer den Pin selbst auf eine neue, schon manipulierte Version hebt, hat damit nichts gewonnen: Der Hash gilt dann für die schlechte Datei.

Wartefrist. uv kennt exclude-newer mit relativer Dauer, etwa 1 week: Pakete, die jünger sind, werden nicht aufgelöst. Gegen ein Fenster von 41 Minuten reicht eine Woche (eigene Rechnung, Folgerung). Das Composer-Gegenstück beschreibt Composer 2.11 mit Wartefrist für neue Pakete. Mit uv sync --locked bricht der Build ab, wenn die Lockdatei nicht zum Projekt passt; ob die Lockdatei Hashes enthält, steht in den gelesenen uv-Seiten nicht, wir sagen dazu nichts.

Rechte begrenzen. Der Dieb nimmt, was da ist: Managed Identity, OIDC-Token, .env. Ein Runner ohne id-token: write und ohne Metadatendienst gibt weniger her. Das Ziel ist ein öffentlicher Dienst, den eine Egress-Freigabeliste sperren würde (Folgerung, nicht gemessen).

Was bei einem Treffer zu rotieren ist

Wer 1.26.1 oder 1.26.2 installiert hatte, behandelt die Umgebung als offen. Aikido, Wiz und BleepingComputer empfehlen übereinstimmend: auf 1.26.0 pinnen, Umgebungen aus einem sauberen Stand neu bauen und alle Geheimnisse rotieren, die der Rechner erreichen konnte. Für Azure heißt das: Anmeldedaten und Token der Pipeline-Dienstkonten erneuern. Aikido rät zusätzlich, die Entra-Anmeldeprotokolle der Pipeline-Dienstprinzipale und der föderierten Anmeldedaten zu prüfen. Für GitHub Actions: Geheimnisse des Repos und der Organisation und alle föderierten Vertrauensstellungen für Workflows, die 1.26.2 geladen haben können. Einen früheren Fall mit Schlüsseltausch beschreibt LiteLLM 1.107.0 und der Schadcode, weitere sammelt der Themenhub Security und Datenschutz. Pins, Wartefristen und Rotation für eigene Python-Umgebungen gehören zu IT-Betrieb: Virtualisierung, Netz, Security und Backup.

Unsere Empfehlung: Heute einmal die Suchbefehle über alle Build- und Laufzeitumgebungen laufen lassen, auf ==-Pins mit Hashes umstellen und für uv-Projekte eine Wartefrist von einer Woche setzen. Bei einem Treffer zuerst rotieren, dann aufräumen.

Weiterführende Quellen

Fragen?
Welche Versionen von agent-framework sind betroffen, und welche ist sauber?+

Betroffen sind 1.26.1 und 1.26.2, beide am 17. November 2026 auf PyPI hochgeladen und kurz danach entfernt. Die letzte saubere Version ist 1.26.0 vom 12. November 2026. Wer dieses Paket nie installiert hat oder nur 1.26.0 oder älter führt, ist nach den Berichten nicht betroffen. Auf PyPI steht heute 1.26.0 als aktuelle Version, 1.26.1 und 1.26.2 fehlen in der Liste.

Läuft eine .pth-Datei auch, wenn ich das Paket nie importiere?+

Ja. Python liest beim Start jede .pth-Datei im site-packages-Ordner und führt Zeilen, die mit import beginnen, per exec() aus, unabhängig davon, ob ein Programm das Paket nutzt. Wir haben es mit Python 3.14.4 und 3.15.2 gemessen: Ein harmloser Hook lief bei python -c pass, bei python -I und bei pip --version. Nur der Schalter -S, der die Datei site gar nicht lädt, hat ihn unterdrückt.

Was muss ich rotieren, wenn eine der beiden Versionen installiert war?+

Alles, was der Rechner oder das CI-Runner-Konto erreichen konnte: Umgebungsvariablen mit Token, Schlüsseln und Passwörtern, die Azure-CLI-Anmeldung, .npmrc, pip.conf, .netrc, .git-credentials, Docker- und Hugging-Face-Zugänge sowie Azure- und GitHub-Actions-Identitäten. Entfernen des Pakets macht bereits gesendete Daten nicht rückgängig.