Aller au contenu
English
Compte : non connecté, synchronisation possible Mon apprentissage
Selectionner le thème
English

Vérifier une dépendance proposée par une IA avant de l'installer

Par mis à jour le

Améliorer cette page

Avant d'installer un paquet qu'un agent de code vient de proposer, faites trois vérifications, dans cet ordre : le nom existe dans votre registre, le projet est légitime, et la ligne est épinglée sur une version exacte et sur l'empreinte du fichier. Un paquet qui échoue à l'une d'elles ne s'installe pas. Cette leçon enseigne ce geste sur les dépendances Python, avec pip. Elle s'adresse aux développeurs et aux personnes d'un métier qui produisent du code avec l'IA, et le raisonnement vaut pour npm, Go ou tout autre gestionnaire.

  • Vérifier qu'un nom de paquet existe, sans l'installer.
  • Juger si un paquet qui existe est légitime.
  • Épingler une dépendance sur une version exacte et sur l'empreinte de son fichier.
  • Installer en refusant tout fichier dont l'empreinte diffère.
  • Refuser un paquet inventé et consigner la raison.

Vous savez lancer une commande dans un terminal Linux, ce qu'enseigne la leçon Le prompt et le terminal, et lire un petit programme Python, comme le montre la leçon Premiers pas en Python : programme, variables et types. Il vous faut Python 3.11 ou plus. Vous savez enregistrer des modifications dans un dépôt Git avec git add et git commit, ce qu'enseigne la leçon Enregistrer des modifications : add, diff, commit, et relire un historique avec git log, ce qu'enseigne la leçon Consulter l'historique : log, show, HEAD. Le module « Bases techniques » de la formation réunit ces leçons ; il est facultatif pour qui sait déjà faire tout cela. Vous savez lire un fichier requirements.txt, c'est-à-dire la liste des paquets qu'un projet Python installe avec pip, et créer un environnement virtuel : la page Les environnements virtuels Python : venv, pip et requirements.txt explique venv, pip et requirements.txt.

La notion de slopsquatting, le paquet inventé par un modèle puis publié par un attaquant, est présentée avec ses chiffres dans la page Vibe coding et dans la page Risques des applications générées par l'IA : cette leçon enseigne le geste qui s'y oppose, sans redire le constat.

Installer un paquet, c'est exécuter le code d'un inconnu avec vos droits. Un assistant de code propose parfois un nom qui n'existe pas : il sonne juste, alors on ne vérifie pas. Si quelqu'un a publié un paquet sous ce nom, la commande pip install le télécharge, et un paquet construit depuis ses sources exécute même du code pendant l'installation. Le guide sécuriser les dépendances npm, PyPI et Go décrit ces attaques et leurs parades en détail.

Prenons le portail-achats, le fil rouge de la formation, du côté de l'acheteuse qui le fait générer. Elle demande un bon de commande en PDF, et l'agent ajoute trois lignes à requirements.txt :

reportlab
pypdf-bondecommande
requests>=2

Rien n'est encore installé. Le geste de cette leçon consiste à décider, ligne par ligne, ce qui peut y rester.

Arbre de décision pour un paquet proposé par un agent. Premier test : le nom existe-t-il dans le registre ? Sinon, on refuse un nom inventé ou absent. Deuxième test : le projet est-il légitime ? Sinon, on refuse un projet sans historique ni mainteneur. Troisième test : la version exacte et l'empreinte sont-elles relevées ? Sinon, on épingle avec == et --hash=sha256. Dans tous les cas acceptés, on installe avec --require-hashes.nonouinonouinonouiL'agent proposeun paquetLe nom existe-t-ildans le registre ?Le projet est-illégitime ?Version exacte etempreinte relevées ?Refuser : nom inventéou absent du registreRefuser : projetsans historique ni mainteneurÉpingler ==et --hash=sha256Installer avec--require-hashes
Source · SVG
Échap pour fermer, + et − pour zoomer, défilement pour se déplacer. 100 %

Lisez le schéma de haut en bas : il y a deux sorties de refus et une seule sortie d'installation. Les deux premiers losanges décident si le paquet est digne de confiance. Le troisième ne le juge pas : il fixe ce que l'on a vérifié, de sorte que l'installation d'aujourd'hui soit celle de demain.

Un nom existe quand le registre que vous utilisez le sert. Le registre est l'index où pip va chercher les paquets : PyPI, le registre public de Python, ou le registre interne d'une entreprise. Vérifiez le nom sans l'installer, parce que l'installation est justement ce qui expose.

PyPI publie une API JSON qui répond par un code HTTP : 200 quand le projet existe, 404 quand il n'existe pas. Les deux commandes ci-dessous interrogent un paquet connu, puis un nom fantaisiste.

Fenêtre de terminal
curl -s -o /dev/null -w "%{http_code}\n" https://pypi.org/pypi/requests/json
curl -s -o /dev/null -w "%{http_code}\n" https://pypi.org/pypi/zzq-portail-csv-export-9x/json

Dans ces commandes, -s coupe l'affichage de progression, -o /dev/null jette le corps de la réponse et -w "%{http_code}\n" n'affiche que le code HTTP. Sur une Debian fraîche, installez d'abord curl avec sudo apt install curl.

La première commande doit afficher 200, la seconde 404. Un 404 sur un nom proposé par l'agent veut dire que PyPI ne connaît pas ce nom : le paquet est inventé, ou il n'est pas public. Dans les deux cas, refusez la ligne et demandez à l'agent ce qu'il voulait obtenir.

Dans une entreprise qui impose un registre interne, la question est plus stricte : le nom existe-t-il dans ce registre ? Un paquet présent sur PyPI mais absent du registre interne n'a pas été validé par l'entreprise. La configuration à un seul index est expliquée dans la section « Un seul index pour les paquets internes » du guide de sécurisation des dépendances.

Un 200 sur PyPI ne dit rien de plus. Le slopsquatting consiste précisément à publier le nom que les modèles inventent : ce nom existe alors, et le test d'existence passe. C'est pourquoi un deuxième contrôle est indispensable.

Comment savoir si un paquet qui existe est légitime ?

Section intitulée « Comment savoir si un paquet qui existe est légitime ? »

Un paquet est légitime quand son historique, son auteur et son code source se recoupent, et qu'un nom comparable ne vous a pas trompé. Aucun indice seul ne tranche : on les lit ensemble, en quelques minutes, avant d'ajouter la dépendance.

La même API de PyPI donne la date de la première publication, le nombre de versions et le dépôt déclaré. Ce petit script les affiche pour un nom donné. Enregistrez-le sous legitimite.py.

import json
import sys
import urllib.request
nom = sys.argv[1]
with urllib.request.urlopen(f"https://pypi.org/pypi/{nom}/json") as r:
d = json.load(r)
fichiers = [f for v in d["releases"].values() for f in v]
print("nom :", d["info"]["name"])
print("version :", d["info"]["version"])
print("versions :", len(d["releases"]))
print("1re publi.:", min(f["upload_time_iso_8601"] for f in fichiers))
print("liens :", d["info"]["project_urls"])

Lancez-le avec python3 legitimite.py requests : sys.argv[1] est le premier argument tapé après le nom du script, ici requests. La ligne qui construit fichiers est une compréhension de liste : elle parcourt chaque version, puis chacun de ses fichiers, et les range dans une seule liste.

Sur requests, il affiche la version courante, le nombre de versions publiées, une première publication en 2011 et un lien Source vers https://github.com/psf/requests. Le nombre de versions et la version courante changent à chaque publication : ces valeurs illustrent la lecture et ne sont pas des seuils. La documentation de l'API JSON de PyPI marque la clé releases comme obsolète et prévient qu'elle peut disparaître : si le script échoue sur cette clé, c'est la première chose à regarder.

Trois indices méritent un refus ou une enquête :

  • un paquet dont la première publication date de quelques jours, avec une ou deux versions, alors qu'il prétend faire un travail courant ;
  • un paquet sans lien vers un dépôt, ou dont le dépôt n'existe pas, ne peut pas être relu ;
  • un nom presque identique à celui d'un paquet très connu est un cas de typosquatting, comme reqeusts, où deux lettres sont inversées, pour requests.

Rapprochez ensuite le paquet de ce que vous voulez faire : un paquet qui promet de lire des fichiers PDF n'a aucune raison de demander l'accès au réseau. Pour les vulnérabilités connues, OSV-Scanner et pip-audit interrogent les bases publiques, et le score OpenSSF Scorecard évalue les pratiques du dépôt. Aucun de ces outils ne prouve qu'un paquet est sain : ils écartent les cas déjà connus. Le guide attaques via les gestionnaires de paquets montre ce qu'un paquet piégé peut faire dès l'installation.

Pour les trois lignes du portail-achats, le verdict se range dans un tableau. La colonne « Décision » dit ce que l'acheteuse en fait avant tout pip install.

Ligne proposéeExiste ?Légitime ?Décision
reportlabouibibliothèque ancienne, dépôt déclarégarder, à épingler
pypdf-bondecommandenon, ou publié récemment sans dépôtnonrefuser
requests>=2ouiouirefuser telle quelle, la réintégrer épinglée, consigner le refus

Épingler consiste à écrire dans le fichier ce que vous avez vérifié : la version exacte et l'empreinte du fichier. Une version, requests==2.31.0, désigne un numéro ; l'empreinte (le hash SHA-256) désigne le contenu. Si quelqu'un remplace le fichier sous le même numéro, l'empreinte change et pip refuse de l'installer. La ligne requests>=2, au contraire, laisse pip choisir la version du jour, et son résultat de demain n'est pas celui que vous avez relu.

Une ligne épinglée se présente ainsi. L'empreinte ci-dessous est celle que PyPI publie pour le fichier requests-2.31.0-py3-none-any.whl.

requirements.txt
requests==2.31.0 \
--hash=sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f

Cette version a des failles connues : requests 2.31.0 est touchée par CVE-2024-35195, corrigée en 2.32.0, et CVE-2024-47081, corrigée en 2.32.4. Elle reste ici parce que l'empreinte ci-dessus a été vérifiée : l'exemple illustre la forme d'une ligne, pas un choix de version. Dans votre projet, épinglez la version courante après l'avoir vérifiée, et passez pip-audit, présenté dans la section « Auditer les vulnérabilités avec pip-audit » du guide de sécurisation des dépendances, pour écarter une version aux failles connues.

Un fichier réduit à cette seule ligne échoue pourtant à l'installation avec l'option --require-hashes, décrite dans la section suivante : requests en installe d'autres, ses dépendances transitives (les paquets qu'elle installe à son tour), et chacune doit figurer dans le fichier avec sa propre empreinte. Avec pip 25.1.1, l'erreur est In --require-hashes mode, all requirements must have their versions pinned with ==, suivie du nom de la première dépendance transitive rencontrée (charset-normalizer). C'est ce que règle la génération du fichier complet, décrite plus bas.

Pour obtenir l'empreinte d'un fichier, téléchargez-le depuis le registre sans l'installer, puis utilisez pip hash, qui affiche la ligne à copier. Lancez ces commandes à la racine du projet, dans un environnement virtuel : sur Debian 13, la commande pip n'existe pas tant que le paquet python3-pip n'est pas installé, alors que venv en fournit un. La première commande crée l'environnement .venv, les suivantes appellent son pip (version 25.1.1 sur Debian 13).

Fenêtre de terminal
python3 -m venv .venv
.venv/bin/pip download --no-deps --only-binary :all: requests==2.31.0
.venv/bin/pip hash requests-2.31.0-py3-none-any.whl
requests-2.31.0-py3-none-any.whl:
--hash=sha256:58cd2187c01e70e6e26505bca751777aa9f2ee0b7f4300988b709f44e013003f

Ne recopiez jamais une empreinte proposée par l'agent : il peut en inventer une qui a l'air juste. Une empreinte se calcule sur le fichier que vous avez obtenu du registre, ou se lit dans le registre lui-même. Dès qu'il y a plusieurs dépendances, des transitives comprises, générez le fichier complet avec un outil : pip-compile --generate-hashes de pip-tools, ou uv pip compile --generate-hashes, que le guide uv présente. La section « Épingler avec hash » du guide de sécurisation des dépendances détaille ce geste, et le guide dépendances reproductibles explique pourquoi une installation doit donner le même résultat d'un poste à l'autre.

Une empreinte ne prouve pas la légitimité. Elle prouve que le fichier est celui que vous avez regardé. L'ordre compte donc : on vérifie d'abord, on épingle ensuite, et jamais l'inverse.

Comment installer en refusant tout fichier inattendu ?

Section intitulée « Comment installer en refusant tout fichier inattendu ? »

L'option --require-hashes de pip impose que chaque ligne du fichier porte une version exacte == et une empreinte, et qu'aucun fichier dont l'empreinte diffère ne soit installé. Les dépendances transitives doivent figurer elles aussi dans le fichier, avec leur empreinte. Si une ligne n'est pas épinglée, pip refuse toute l'installation, au lieu d'installer ce qui peut l'être.

Fenêtre de terminal
.venv/bin/pip install --require-hashes -r requirements.txt

La commande utilise l'environnement .venv créé plus haut ; si vous ne l'avez pas encore, créez-le avec python3 -m venv .venv.

Si une ligne n'est pas épinglée ou si une empreinte est fausse, pip s'arrête avec une erreur et n'installe rien. C'est le comportement voulu : un fichier qui s'installe sans erreur est un fichier dont chaque ligne porte une empreinte vérifiable.

Quand l'entreprise fournit un registre local, par exemple un répertoire de fichiers, ajoutez --no-index --find-links <répertoire> pour interdire tout index public : avec un index public, c'est justement le nom inventé qui peut s'installer. Une installation qui réussit ainsi, sans réseau, prouve que le fichier ne dépend que de ce que vous avez validé. Pour interdire en plus qu'un paquet construise du code à l'installation, ajoutez --only-binary :all:, expliqué dans la section « Éviter l'exécution de code à l'installation » du même guide.

Dans un tel répertoire, le fichier porte son nom normalisé : pip compare les noms sans tenir compte de la casse ni de la différence entre -, _ et ., mais le nom du fichier est en minuscules et remplace chaque suite de -, _ ou . par un seul souligné. La distribution portail-money donne ainsi un fichier portail_money-1.2.0-py3-none-any.whl.

Refuser un paquet inventé se fait en trois gestes : ne pas l'installer, le retirer du fichier, et consigner pourquoi. Ne l'installez pas « pour voir » : l'installation est le geste qui expose, et un 404 suffit à décider.

Demandez ensuite à l'agent ce dont il avait besoin. Un besoin réel, par exemple générer un PDF, se couvre presque toujours avec un paquet que vous avez déjà validé ou avec la bibliothèque standard. Redemandez-le en nommant la contrainte : « n'ajoute aucune dépendance qui ne soit pas déjà dans le registre interne ». Le journal du refus nomme le paquet tel que proposé et la raison :

- paquet: pypdf-bondecommande
decision: refuse
raison: >
Le nom n'existe pas dans le registre interne et renvoie 404 sur PyPI :
nom inventé par l'agent. Besoin couvert par reportlab, déjà validé.

Cette trace sert à la prochaine relecture et à l'équipe : on y retrouve quel nom l'agent a proposé et pourquoi il n'est pas entré.

Le tableau part du message d'erreur de pip et mène à la correction.

SymptômeCause probableCorrection
pip répond que les empreintes sont requises mais manquent pour certaines lignesUne ligne n'a pas de --hashCalculer l'empreinte avec pip hash, ou générer le fichier avec pip-compile --generate-hashes
pip répond que tous les paquets doivent être épinglés avec ==Une ligne utilise >= ou aucune versionRemplacer par la version exacte vérifiée
pip annonce que des paquets ne correspondent pas aux empreintesLe fichier téléchargé n'est pas celui dont vous avez calculé l'empreinteNe pas contourner : revérifier la source, recalculer, ou refuser le paquet
No matching distribution found avec --no-indexLe registre local ne sert pas ce nom ou cette versionLe paquet n'est pas validé : refuser, ou le faire valider avant
Une dépendance transitive manque d'empreinteSeules les lignes directes ont été épingléesGénérer le fichier complet avec un outil, transitives comprises

Le lab reprend le portail-achats et fait pratiquer le geste de cette leçon sur une liste de dépendances proposée par un agent simulé. Il est recommandé : c'est la preuve du geste. Il demande un terminal, Python 3.11 ou plus, le module venv (le paquet python3-venv sur Debian et Ubuntu) et pip. Rien ne sort sur le réseau : le registre est un répertoire local, et les paquets qu'il contient sont fictifs.

L'agent propose trois dépendances. Vous vérifiez chacune dans le registre interne avant toute installation, refusez ce qui ne peut pas être accepté tel quel, un nom que le registre ne sert pas ou une dépendance proposée sans épinglage, puis réintégrez-la épinglée si le registre la sert. Vous consignez chaque refus avec sa raison, et vous livrez une liste épinglée sur une version exacte et sur l'empreinte de chaque artefact. La validation contrôle que seules restent les dépendances que sert le registre, que chaque ligne est épinglée, que la revue consigne chaque refus avec sa raison, y compris pour une ligne proposée sans épinglage, et que la liste s'installe hors ligne, dépendances légitimes comprises.

  • Installer un paquet, c'est exécuter le code d'un inconnu : on vérifie avant, jamais après.
  • Un nom se vérifie sans installer, par exemple avec l'API de PyPI (200 ou 404), ou dans le registre interne que l'entreprise impose.
  • Un nom qui existe n'est pas pour autant légitime : le paquet inventé puis publié par un attaquant existe aussi.
  • La légitimité se lit sur plusieurs indices ensemble : date de première publication, nombre de versions, dépôt déclaré, nom voisin d'un paquet connu.
  • Une ligne épinglée porte une version exacte == et une empreinte --hash=sha256:…, calculée sur le fichier obtenu du registre.
  • pip install --require-hashes refuse tout ce qui n'est pas épinglé, et --no-index interdit l'index public.
  • Un paquet inventé se refuse sans l'installer, et le refus se consigne avec le nom proposé et la raison.

Ces huit questions portent sur la vérification de l'existence d'un paquet, son examen de légitimité, l'épinglage par empreinte et le refus d'un paquet inventé.

Contrôle de connaissances

Validez vos connaissances avec ce quiz interactif

8 questions
8 min.
70% requis

Informations

  • Le chronomètre démarre au clic sur Démarrer
  • Questions à choix multiples, vrai/faux et réponses courtes
  • Vous pouvez naviguer entre les questions
  • Les résultats détaillés sont affichés à la fin

Lance le quiz et démarre le chronomètre