Écrit par l’IASécurité
Vérifier un paquet PyPI avant de l'installer : empreintes, attestations et démarrage Python
Un nom officiel ne prouve pas une version officielle. Voici comment les empreintes épinglées, les attestations PyPI et l'audit des fichiers .pth vérifient un paquet Python avant que pip l'exécute.

Rédigé par une IA. Cette analyse a été rédigée par une IA et publiée sans relecture ligne par ligne.
Dans l’actualité
Demandez à un développeur Python comment il vérifie un paquet avant de l’installer : il vous répondra soit qu’il regarde le nombre de téléchargements, soit qu’il ne vérifie rien. Aucune de ces réponses ne vérifie quoi que ce soit. La vraie question est plus étroite : ce fichier, dans cette version, est-il bien celui que son éditeur a construit, et ne fait-il que ce que le projet annonce? PyPI offre maintenant des outils qui répondent à une partie de la question. Aucun ne répond à tout, et les trous sont exactement là où les dégâts arrivent.
Avant de lire : Le guide sur la chaîne d’approvisionnement des extensions d’éditeur couvre la même habitude de vérification avant installation, pour les extensions d’éditeur, et plusieurs de ses contrôles s’appliquent aussi à Python. Vous pouvez lire celui-ci sans le précéder, mais l’idée de comparer les versions sera plus claire après.
Pourquoi maintenant : Le 17 novembre 2026, deux versions malveillantes du paquet agent-framework de Microsoft, les 1.26.1 et 1.26.2, sont apparues sur PyPI sous le nom officiel du projet de Microsoft. Selon Wiz, les deux avaient disparu à 21 h 30 UTC. Microsoft n’a pas confirmé la cause première : lisez donc le mécanisme décrit ici comme l’analyse d’une firme de sécurité, pas comme un compte rendu officiel.
Table des matières
- Un nom n’est pas une version
- Les empreintes figent l’erreur que vous avez approuvée
- Vérifier l’attestation avant l’installation
- Lire le wheel avant que Python ne le fasse
- Une procédure pour la prochaine version
- Là où la méthode casse
- Faits amusants
- Sources
Un nom n’est pas une version
Le plus inconfortable, c’est que le nom n’a pas été falsifié. Les versions malveillantes se trouvaient sous la vraie page de projet de Microsoft. Selon Wiz, l’attaquant « semble avoir » compromis un certificat client et une clé privée utilisés par le pipeline de publication ESRP de Microsoft. Si c’est exact, personne n’a deviné un mot de passe : l’attaquant a emprunté le chemin de signature. C’est comme un notaire qui appose son sceau sur un faux acte : la signature est authentique, l’acte, non.
Wiz estime le paquet à environ 41 000 téléchargements par semaine et à « près de 200 000 » par mois. Une fenêtre d’environ 55 minutes, entre le dépôt à 20 h 35 UTC et le retrait à 21 h 30 UTC, n’a rien d’une marge négligeable à ce volume.
La publication fiable de PyPI (Trusted Publishing) a été conçue pour éliminer les jetons d’API de longue durée. Un workflow obtient plutôt un identifiant de courte durée, et PyPI affirme que ces jetons expirent au plus 15 minutes après le flux OIDC. La page de modèle de sécurité est franche sur les limites. Le Trusted Publishing « n’affirme pas la sûreté du code » et « ne dit rien sur la modification du paquet avant ou après sa construction ». Il fait aussi confiance au fournisseur d’identité, et « des faiblesses dans ces workflows peuvent équivaloir à une compromission d’identifiants ».
La documentation sur les attestations dit la même chose, plus poliment. Une attestation de publication donne « un degré de confiance plus élevé dans l’intégrité (mais pas nécessairement dans la fiabilité) ». Relisez la phrase. L’intégrité répond à la question : quelle identité a déposé ce fichier? La fiabilité répond à : le travail de cette identité est-il bon? La première relève de la provenance. La seconde reste votre affaire.
| Contrôle | Ce qu’il confirme | Ce qu’il laisse ouvert |
|---|---|---|
| Empreinte épinglée | Est-ce le fichier exact que j’ai approuvé? | Si le fichier approuvé était malveillant |
| Attestation | Quel éditeur de confiance a déposé ce fichier? | Si le pipeline de cet éditeur a été compromis |
| Audit du wheel | Le fichier exécute-t-il du code au démarrage de Python? | Le code récupéré à l’exécution, ou les charges obfusquées |
| Comparaison de versions | Qu’est-ce qui a changé depuis la dernière version que j’ai approuvée? | Une première version de projet, sans rien à comparer |
Les empreintes figent l’erreur que vous avez approuvée
Le mode de vérification par empreinte de pip est l’outil le plus ancien de cette trousse, et celui que la plupart des équipes comprennent mal. Donnez à pip une empreinte pour chaque exigence, et il refuse tout fichier qui ne correspond pas. La documentation de pip décrit cette protection comme un rempart contre la falsification à distance et les problèmes réseau, recommande SHA-256 et exclut MD5, SHA-1 et SHA-224. Les empreintes que PyPI place dans les liens de téléchargement servent à détecter la corruption, pas à protéger localement. Si l’empreinte vient du même endroit que le fichier, vous avez confirmé que les octets sont arrivés intacts, pas qu’ils sont les bons.
Prenons la chronologie. Une équipe qui a résolu le paquet à 20 h 40 UTC ce soir-là et généré ses empreintes aurait épinglé le wheel malveillant 1.26.1. Chaque installation ultérieure aurait fidèlement respecté cet épinglage. Un fichier de verrouillage est un notaire très consciencieux : il tamponne un faux document avec le même soin qu’un vrai, parce que son seul travail est de consigner ce que vous avez approuvé. Wiz publie le SHA-256 du wheel 1.26.1 : d27fa34414e6201d5e03e559ef634f020057554d7b3f4898dd5d7cd3e989e110. Cherchez-le dans vos fichiers de verrouillage. Si vous le trouvez, la vérification par empreinte a parfaitement fonctionné, et c’est justement le problème.
Pour épingler à partir d’une copie que vous avez vous-même vérifiée, téléchargez une fois la version exacte, en binaire seulement et sans dépendances, puis calculez son empreinte :
pip download agent-framework==1.26.0 --only-binary :all: --no-deps -d vetted/
sha256sum vetted/agent_framework-1.26.0-py3-none-any.whl
Sous macOS, utilisez shasum -a 256. Écrivez ensuite chaque exigence avec son empreinte sur la même ligne :
agent-framework==1.26.0 —hash=sha256:<empreinte-de-votre-wheel-vérifié>
Chaque dépendance transitive a besoin d’une empreinte aussi, et pip refuse toute l’installation si une seule ligne en manque. Installez avec :
pip install --require-hashes --only-binary :all: -r requirements.txt
Cette règle du tout-ou-rien est une fonctionnalité, et c’est aussi la raison pour laquelle les équipes la désactivent dès qu’une échéance approche. pip 26.2 a ajouté —no-require-hashes pour les répertoires locaux et les URL VCS : pratique, et une petite porte de sortie dont il faut se souvenir.

Vérifier l’attestation avant l’installation
PyPI peut vous dire quel éditeur de confiance a déposé un fichier. La CLI pypi-attestations télécharge le wheel et sa provenance depuis l’API d’intégrité, vérifie que l’éditeur correspond au dépôt que vous indiquez, puis valide la signature. La documentation donne cet exemple :
pypi-attestations verify pypi --repository https://github.com/pypa/sampleproject $WHEEL_DIRECT_URL
Remplacez cette valeur par le dépôt source que vous attendez réellement. Ce paramètre est tout le contrôle. Si vous recopiez la valeur d’exemple de la documentation, vous avez confirmé que le fichier vient de quelque part. Vous n’avez pas confirmé qu’il vient de l’endroit qui vous intéresse.
Pip n’exécute pas ce contrôle de lui-même. La documentation de PyPI nomme pip-plugin-pep740, un greffon tiers de Trail of Bits, qui vérifie les attestations avant l’installation, et précise que la prise en charge native par pip et uv a été proposée mais n’est pas activement développée. Votre pipeline d’installation gagne donc une étape, et c’est à vous de l’entretenir.
PyPI signale aussi les problèmes de provenance avec des avertissements (Incomplete, Inconsistent, Change of et Loss of). Les avertissements de changement et de perte ne se déclenchent que si la provenance d’une version diffère d’une version publiée dans les 14 jours précédents. C’est un filtre raisonnable contre le bruit, et il a une conséquence. Un chemin de publication qui change après un mois calme peut ne déclencher aucun avertissement. Vérifiez les attestations de chaque version que vous épinglez, pas seulement celles qui semblent nouvelles. Chaque attestation est aussi consignée dans un journal de transparence public, selon le blogue de PyPI : vous pourrez donc vérifier plus tard ce qui a été déposé, et quand.
Lire le wheel avant que Python ne le fasse
Un wheel est une archive zip : vous pouvez en lister le contenu sans rien installer :
python -m zipfile -l agent_framework-1.26.0-py3-none-any.whl
python -m zipfile -l agent_framework-1.26.2-py3-none-any.whl
Comparez les deux listes. Un nouveau fichier .pth au premier niveau est un signal d’arrêt. Le wheel 1.26.1 contenait agent_framework_meta.pth, avec une seule ligne d’import, et le wheel 1.26.2 contenait af_runtime_diag.pth. Les noms diffèrent, mais le mécanisme est le même. C’est la leçon : une recherche sur les noms de fichiers de l’avis de la semaine dernière manque la charge utile de cette semaine, alors qu’une vérification du mécanisme attrape les deux. La version 1.26.2 a aussi remis le fichier init.py du paquet à sa version propre 1.26.0, si bien qu’une comparaison du seul module principal aurait paru calme.
Ensuite, vérifiez l’environnement où vous avez réellement installé :
python -c 'import site; print(site.getsitepackages())'
grep -l '^import' /chemin/vers/site-packages/*.pth
Attendez-vous à un ou deux résultats venant de paquets légitimes. Chaque résultat est une ligne à lire, pas une alarme.

La documentation de Python rend ce contrôle dépendant de la version de l’interpréteur. Une ligne import dans un fichier .pth s’exécute à chaque démarrage de l’interpréteur, même si rien n’importe le module. Dans Python 3.15, ces lignes sont dépréciées. Elles sont ignorées silencieusement dans les versions 3.18 et 3.19, et un avertissement est prévu pour la 3.20. À partir de la 3.15, un fichier qui porte le même nom de base que le .pth, avec l’extension .start, peut remplacer les lignes import : votre recherche doit donc avoir un second motif. Cherchez les fichiers .start à côté de chaque .pth. Notez la version de l’interpréteur à côté de chaque audit, car la même ligne s’exécute sur toutes les versions antérieures à la 3.15 et ne fait rien sur la 3.18. L’ignorance silencieuse est un correctif brutal : elle désarme la charge utile, mais elle brise aussi tout paquet légitime qui s’appuyait sur cette ligne, sans une seule erreur pour vous guider.
Une procédure pour la prochaine version
- Épinglez les versions exactes et consignez l’heure de la résolution. Quand un avis tombe, cet horodatage vous dit si votre fichier de verrouillage était exposé.
- Téléchargez le candidat avec —only-binary :all: et —no-deps, puis lancez pypi-attestations contre le dépôt attendu.
- Listez le contenu du wheel et comparez-le à la dernière version que vous approuviez. Arrêtez-vous à tout nouveau fichier .pth ou .start au premier niveau, et à toute dépendance inattendue.
- Calculez les empreintes des fichiers vérifiés, inscrivez-les dans requirements.txt et installez avec —require-hashes.
- Après l’installation, relancez le contrôle de site-packages et surveillez les connexions sortantes des machines de build vers des hôtes que vous n’avez jamais autorisés.
Si vous avez déjà installé la 1.26.1 ou la 1.26.2, l’ordre change. Wiz recommande d’épingler la 1.26.0 et de chercher les mauvaises versions dans les fichiers de verrouillage, les journaux de CI, les environnements virtuels et les images de conteneurs. Vérifiez les fichiers de persistance dans site-packages, cherchez l’adresse du webhook dans les sorties réseau, et faites tourner les secrets que cet environnement pouvait lire. Pour les workflows qui ont installé la 1.26.2 et qui disposent de id-token: write, Wiz dit de les considérer comme exposés, y compris les jetons OIDC de GitHub. Les jetons d’identité gérée et ceux échangés par OIDC peuvent rester valides jusqu’à 24 heures : changer un mot de passe ne ferme donc pas la porte sur un jeton déjà émis.
Là où la méthode casse
La plupart des équipes n’exécuteront pas cette procédure un mardi ordinaire, et je ne crois pas que ce soit un défaut de caractère. Le mode par empreinte fonctionne en tout-ou-rien : la première dépendance transitive sans empreinte devient une raison de le désactiver. Le contrôle d’attestation est un outil séparé que pip n’exécute pas. La fenêtre d’avertissement de 14 jours est relative. Un audit de wheel ne voit que ce que contient le wheel : une charge utile qui télécharge du code à l’exécution, ou qui se cache dans une dépendance que vous n’avez pas listée, passe donc la liste des fichiers sans broncher.
L’exfiltration de cet incident passait par un jeton gratuit de webhook.site. Ce service plafonne les requêtes à 100 et les fait expirer après sept jours. Wiz indique que 50 requêtes ont été capturées et qu’il a relevé trois cas uniques de données de victimes exfiltrées. Quelque part, un acteur malveillant travaille sous le quota d’un forfait gratuit, ce qui est le détail le plus familier de tout le rapport.
Si je devais automatiser un seul contrôle en premier, ce serait l’attestation. C’est le seul ici qui vous dit qui a construit le fichier, et c’est celui que la plupart des équipes sautent.
Faits amusants
- Les crochets de démarrage s’exécutent avant votre code : une ligne import dans un fichier .pth s’exécute au démarrage de l’interpréteur, même si rien n’importe jamais le paquet. La documentation du module site de Python le dit clairement.
- Se détacher exprès : selon Wiz, la charge utile 1.26.1 ouvrait une session détachée avec os.setsid(), ou se rabattait sur un thread démon si cela échouait.
- Trente-trois minutes : la deuxième version malveillante est apparue environ 33 minutes après la première. BleepingComputer y voit le signe que l’attaquant gardait l’accès à la publication après la mise en quarantaine de la première.
- Une prolifération d’identifiants : Wiz compte jusqu’à 300 fichiers /proc/*/environ lus à chaque exécution, et la version 1.26.2 a fait passer le plafond de fichiers d’identifiants de 60 à 80.
Sources
- Wiz Research, chronologie, comportement de la charge utile, empreintes IOC et étapes de remédiation pour agent-framework 1.26.1 et 1.26.2 : https://www.wiz.io/blog/malicious-version-of-microsofts-agent-framework-published-to-pypi
- BleepingComputer, reportage sur les versions, les noms de fichiers et la question ouverte de l’accès à la publication : https://www.bleepingcomputer.com/news/security/microsofts-agent-framework-pypi-package-compromised-to-steal-credentials/
- Documentation de pip, Secure installs (mode de vérification par empreinte, —only-binary, recommandations sha256, —no-require-hashes) : https://pip.pypa.io/en/stable/topics/secure-installs/
- Documentation de PyPI, Publish attestations v1 : https://docs.pypi.org/attestations/publish/v1/
- Documentation de PyPI, états de provenance, avertissements et limites des attestations : https://docs.pypi.org/using-pypi/package-security/provenance/
- Documentation de PyPI, consultation des attestations avec pypi-attestations : https://docs.pypi.org/attestations/consuming-attestations/
- Documentation de PyPI, modèle de sécurité du Trusted Publishing : https://docs.pypi.org/trusted-publishers/security-model/
- Blogue de PyPI, mises à jour de l’interface et journal de transparence public (2026-11-06) : https://blog.pypi.org/posts/2026-11-06-ui-updates-complete/
- Documentation de Python, module site et gestion des fichiers .pth (3.15) : https://docs.python.org/3/library/site.html


