Programme Leçon 73 sur 156 · Les tiers sur ton propre site
Les tiers sur ton propre site

Subresource Integrity

Pourquoi c'est important Quand tu intègres https://cdn.example/lib.js, tu fais confiance à celui qui contrôle ce serveur aujourd'hui et tous les jours qui suivent. S'il est piraté, ou si le fichier est discrètement modifié, tes visiteurs exécutent le nouveau code sur ton site. Subresource Integrity permet au navigateur de refuser toute version que tu n'as pas approuvée.

Pense au scellé d'inviolabilité sur un flacon de médicament. Tu vérifies le scellé avant d'avaler quoi que ce soit. S'il est cassé, tu ne le prends pas, peu importe qui l'a mis en rayon.

Subresource Integrity (SRI) : un attribut integrity sur une balise <script> ou <link rel="stylesheet"> qui contient un hash du fichier exact que tu attends. Le navigateur calcule le hash de ce qu'il télécharge et refuse d'utiliser le fichier si les hash diffèrent.

Hash : une fonction qui transforme n'importe quelles données en une courte empreinte de taille fixe. Les mêmes octets donnent toujours la même empreinte ; change un seul octet et l'empreinte change complètement. SHA-384 est le hash le plus utilisé pour SRI.

À quoi ressemble la balise

<script src="https://cdn.example/lib.js"
        integrity="sha384-iht3RcshTShmtRmXjSLQ8CjUTiVO41jHRJzgK44j1lSJHvfC4YAeuY4ZOoMtzhi5"
        crossorigin="anonymous"></script>

La valeur est le nom de l'algorithme, un tiret, puis le hash écrit en Base64 (une façon d'écrire des octets avec des lettres, des chiffres, + et /). La partie crossorigin="anonymous" est nécessaire pour les fichiers d'un autre site : le navigateur les récupère sans cookies et le serveur doit l'autoriser avec un en-tête Access-Control-Allow-Origin, sinon la vérification ne peut pas tourner et le fichier est bloqué. SRI marche dans tous les grands navigateurs (vérifié en octobre 2026).

En calculer un en Python

import base64, hashlib
data = b"console.log('hi')"
digest = hashlib.sha384(data).digest()          # 48 raw bytes
print("sha384-" + base64.b64encode(digest).decode("ascii"))

hashlib.new(name, data) fait la même chose pour n'importe quel algorithme donné par son nom, comme "sha256" ou "sha512". Note la différence entre .digest() (les octets bruts, ce que veut SRI) et .hexdigest() (du texte hexadécimal, qui serait faux ici).

Comment le navigateur le vérifie

  1. Découpe l'attribut sur les espaces. Tu peux lister plusieurs hash, par exemple pendant un changement de version d'un fichier.
  2. Ne garde que les éléments dont il connaît l'algorithme : sha256, sha384, sha512. Ignore le reste. (Un élément peut finir par ?options ; retire cette partie.)
  3. S'il ne reste rien d'utilisable, il ne fait aucune vérification et utilise le fichier. Une faute de frappe comme sha385-... désactive donc la protection en silence. Teste toujours qu'un mauvais hash bloque vraiment le fichier.
  4. Sinon, prends l'algorithme le plus fort présent (sha512 bat sha384 qui bat sha256) et ne regarde que les éléments de cet algorithme. Si l'un d'eux correspond au hash du fichier, le fichier est utilisé ; si aucun ne correspond, il est bloqué.

Une idée reçue : « SRI garde le fichier privé ». Il ne cache rien, et le tiers voit toujours la requête. SRI garantit seulement que le code est celui que tu as approuvé. Il ne peut pas non plus marcher pour des fichiers qui changent tout le temps, comme un script publicitaire ; pour ceux-là, la réponse honnête est souvent de ne pas les intégrer.

Dans d'autres langages
# Shell (OpenSSL)
openssl dgst -sha384 -binary lib.js | openssl base64 -A
// JavaScript (Node)
const crypto = require("crypto");
const sri = "sha384-" + crypto.createHash("sha384").update(fs.readFileSync("lib.js")).digest("base64");
// Go
sum := sha512.Sum384(data)
sri := "sha384-" + base64.StdEncoding.EncodeToString(sum[:])
// PHP
$sri = 'sha384-' . base64_encode(hash('sha384', $data, true));
// C#
var sri = "sha384-" + Convert.ToBase64String(SHA384.HashData(data));

Les bundlers peuvent ajouter SRI pour toi (par exemple le plugin webpack-subresource-integrity).

Récap

  • SRI épingle un script ou une feuille de style intégrés aux octets exacts que tu as approuvés.
  • La valeur est algorithm-Base64(hash), et les fichiers d'un autre site ont aussi besoin de crossorigin="anonymous".
  • Le navigateur n'utilise que l'algorithme le plus fort listé, et un attribut sans rien d'utilisable veut dire aucune vérification.
À ton tour

Écris trois fonctions :

  1. sri_hash(data, algorithm="sha384") : data est en octets. Renvoie la valeur SRI : le nom de l'algorithme, un tiret, et le Base64 du condensé brut (utilise hashlib.new(algorithm, data).digest() et base64.b64encode).
  2. verify_sri(data, integrity) : vérifie data comme le fait un navigateur. Découpe integrity sur les espaces ; garde les éléments dont la partie avant le premier - vaut sha256, sha384 ou sha512 et dont la valeur n'est pas vide, en retirant tout ce qui suit un ?. Si aucun n'est gardé, renvoie True (pas de vérification). Sinon n'utilise que l'algorithme le plus fort présent et renvoie True si l'une de ses valeurs correspond au hash des données dans cet algorithme, sinon False.
  3. script_tag(url, data) : renvoie exactement <script src="URL" integrity="VALUE" crossorigin="anonymous"></script> avec la valeur sha384 de data.
Affiche la balise pour la bibliothèque d'entraînement à la fin. Les tests utilisent des données aléatoires.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.