L’intégrité des sous-ressources ne sert pas qu’aux tiers

L’intégrité des sous-ressources est rangée sous « protection contre un CDN compromis », et c’est là que la plupart des gens s’arrêtent. Le cas intéressant aujourd’hui est un module que votre propre serveur envoie, et dont aucun attribut ne peut se porter garant.

Le mécanisme est connu : une empreinte condensée dans un attribut, et un navigateur qui refuse la ressource quand les octets ne correspondent pas.

<script src="https://cdn.example.com/app.v4.js"
        integrity="sha384-oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K"
        crossorigin="anonymous"></script>

Rien dans ce mécanisme n’est réservé à une autre origine. integrity fonctionne aussi sur un fichier de même origine, et le multi-origine ajoute seulement l’attribut crossorigin et une réponse CORS. Ce qui change entre les deux n’est pas la faisabilité, c’est ce que le contrôle prouve.

Une empreinte ne prouve quelque chose que si elle vient d’ailleurs

La valeur attendue doit emprunter un chemin différent de celui de la ressource. Sur un CDN, c’est tout l’intérêt : vous maîtrisez la page, quelqu’un d’autre sert les octets.

Sur un monolithe où le même processus rend le HTML et sert le fichier, depuis le même répertoire avec les mêmes droits d’écriture, un attaquant qui échange le fichier réécrit l’empreinte dans le même mouvement. Et c’est pourquoi l’implémentation tentante est celle qui ne vaut rien : calculer l’empreinte au rendu à partir du fichier que vous vous apprêtez à servir ne prouve absolument rien. C’est un contrôle qui se vérifie lui-même.

Les cas où une empreinte de même origine justifie sa place sont ceux où les deux chemins sont réellement distincts : des ressources poussées vers un CDN ou un magasin d’objets pendant que l’application rend la page, un répertoire accessible en écriture à un processus qui ne peut pas toucher à la compilation, un cache mutualisé devant. Ce sont des formes courantes, et ce n’est pas contre elles que la documentation vous met en garde.

Les ressources qu’aucun attribut n’atteint

Voici la partie qui change le tableau. Avec les modules ES et une carte d’import, vous écrivez une seule balise, le point d’entrée. Tout le reste est récupéré par le chargeur de modules depuis un spécificateur nu :

import { Controller } from '@hotwired/stimulus';

Il n’y a pas de balise là. Pas d’attribut, pas d’endroit où en mettre un. Jusqu’à récemment, ces sous-ressources étaient tout simplement invérifiables, quel que soit celui qui les servait.

La spécification des cartes d’import y répond par une carte integrity, dont les clés sont des URL résolues et non des spécificateurs, un détail qui coûte un après-midi quand on se trompe :

{
  "imports": { "square": "/assets/shapes/square-a1b2c3.js" },
  "integrity": { "/assets/shapes/square-a1b2c3.js": "sha384-oqVuAfXRKap7fdg..." }
}

Elle s’applique aux imports statiques, aux imports dynamiques et aux modules préchargés. Elle ne s’applique pas au src d’un élément script, qui garde son propre attribut, et une entrée qui porte déjà des métadonnées d’intégrité l’emporte sur la carte.

La prise en charge n’est plus l’obstacle qu’elle était : Chrome 127, Firefox 138, Safari 18.

Dans Symfony

AssetMapper produit cette carte pour vous, à la demande et par algorithme :

framework:
    asset_mapper:
        importmap_integrity_algorithms: ['sha384']

Les empreintes atterrissent dans l’objet integrity de la carte d’import, sur les liens modulepreload, sur la balise de polyfill et sur les styles que le chargeur récupère. C’est désactivé par défaut, condenser chaque ressource ayant un coût que personne ne devrait payer sans qu’on le lui demande, et la valeur est calculée à la compilation et cuite dans l’artefact déployé, non recalculée depuis le fichier en train d’être servi. C’est là la différence entre un vrai contrôle et celui qui se vérifie lui-même, plus haut.

L’entrée manquante, et ce qui y remédie

Une URL absente de la carte n’est pas vérifiée, et rien ne le dit. Un module ajouté sans son entrée passe en silence, ce qui est la faiblesse structurelle de toute liste d’autorisation.

Integrity-Policy transforme « absent » en « bloqué » :

Integrity-Policy: blocked-destinations=(script)

Il a un jumeau en mode rapport, et il est récent, Chrome 138, Firefox 145, Safari 26, alors traitez-le comme un durcissement progressif plutôt que comme une garantie. Associé à la carte, il dit quelque chose qu’une politique de sécurité du contenu ne dit pas : un jeton autorise un script à s’exécuter, l’intégrité dit quels octets exactement ont le droit de s’exécuter.