Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

Attribut integrity — intégrité des ressources

L’attribut integrity fournit au navigateur l’empreinte attendue d’une ressource externe. Subresource Integrity (SRI) permet de rejeter un script ou une feuille de style dont le contenu ne correspond pas aux métadonnées déclarées.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

integrity="sha256-<base64-digest>"

integrity est un attribut textuel de Subresource Integrity (SRI), et non un attribut global ou booléen. La forme sha256-<base64-digest> associe le nom d’un algorithme à une empreinte encodée en Base64. L’empreinte décrit le contenu de la ressource, pas son URL ; si ce contenu change, l’empreinte doit être mise à jour.

Sur script, l’attribut définit les métadonnées d’intégrité pour le chargement initial d’un script externe. Il ne vérifie pas le code écrit directement dans l’élément et ne couvre pas automatiquement les modules importés. Sur link, il n’est autorisé que lorsque rel contient stylesheet, preload ou modulepreload.

Si une ressource chargée échoue au contrôle d’intégrité, le navigateur ne l’utilise pas comme script ou feuille de style chargé avec succès. SRI ne remplace ni HTTPS ni la confiance envers le document contenant l’empreinte : un attaquant capable de modifier à la fois la ressource et sa déclaration integrity peut remplacer les deux. Les ressources d’une autre origine nécessitent la prise en charge de CORS ; on utilise généralement crossorigin="anonymous", et le serveur doit autoriser cette requête.

L’exemple tente deux fois de charger le même objet Blob comme script. Cet objet contient exactement trois octets : abc, sans saut de ligne. Le premier essai utilise une empreinte SHA-256 qui correspond au contenu, le second une empreinte qui n’y correspond pas. L’exemple affiche Matching digest: load et Mismatched digest: error sur deux lignes distinctes. Dans d’autres situations, l’événement error peut aussi signaler une erreur réseau plutôt qu’une empreinte qui ne correspond pas. Définissez integrity avant le début du chargement ; modifier l’attribut ensuite ne vérifie pas à nouveau un script déjà chargé.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Script integrity check</title>
</head>
<body>
  <pre id="result" aria-live="polite"></pre>
  <script>
    // The fixture is exactly three bytes: abc, with no newline.
    // Define abc so the fixture can also execute as a classic script.
    window.abc = 1;
    const fixture = new Blob(['abc'], { type: 'text/javascript' });

    function loadWithIntegrity(integrity) {
      return new Promise(resolve => {
        const url = URL.createObjectURL(fixture);
        const script = document.createElement('script');
        function finish(event) {
          script.remove();
          URL.revokeObjectURL(url);
          resolve(event.type);
        }
        script.addEventListener('load', finish, { once: true });
        script.addEventListener('error', finish, { once: true });
        script.integrity = integrity;
        script.src = url;
        document.head.append(script);
      });
    }

    Promise.all([
      loadWithIntegrity('sha256-ungWv48Bz+pBQUDeXa4iI7ADYaOWF3qctBD/YfIAFa0='),
      loadWithIntegrity('sha256-47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=')
    ]).then(([match, mismatch]) => {
      document.getElementById('result').textContent =
        `Matching digest: ${match}\nMismatched digest: ${mismatch}`;
    });
  </script>
</body>
</html>

Résultat

Matching digest: load
Mismatched digest: error

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources