Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

Atribut integrity — integrita zdrojů

Atribut integrity předává prohlížeči očekávaný otisk externího zdroje. Subresource Integrity (SRI) umožňuje odmítnout skript nebo šablonu stylů, pokud jejich obsah neodpovídá deklarovaným metadatům.

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

Syntaxe

integrity="sha256-<base64-digest>"

integrity je textový atribut pro Subresource Integrity (SRI), nikoli globální ani booleovský atribut. Zápis sha256-<base64-digest> spojuje název algoritmu s otiskem zakódovaným v Base64. Otisk popisuje obsah zdroje, nikoli jeho URL; při změně obsahu je nutné otisk aktualizovat.

U script atribut nastavuje metadata integrity pro počáteční načtení externího skriptu. Nekontroluje kód zapsaný přímo v prvku a automaticky se nevztahuje na importované moduly. U link je povolen pouze tehdy, když rel obsahuje stylesheet, preload nebo modulepreload.

Pokud načtený zdroj neprojde kontrolou integrity, prohlížeč jej nepoužije jako úspěšně načtený skript nebo šablonu stylů. SRI nenahrazuje HTTPS ani důvěru v dokument obsahující otisk: útočník, který může změnit zdroj i jeho deklaraci integrity, může nahradit obojí. Zdroje z jiného originu vyžadují podporu CORS; obvykle se používá crossorigin="anonymous" a server musí tento požadavek povolit.

Příklad se dvakrát pokusí načíst stejný objekt Blob jako skript. Objekt obsahuje přesně tři bajty: abc bez znaku konce řádku. Při prvním pokusu se použije odpovídající otisk SHA-256, při druhém neodpovídající. Příklad zobrazí Matching digest: load a Mismatched digest: error na samostatných řádcích. V jiných situacích může událost error znamenat také síťovou chybu, nejen neshodu otisku. Nastavte integrity před zahájením načítání; pozdější změna atributu znovu neověří již načtený skript.

Příklady

<!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>

Výsledek

Matching digest: load
Mismatched digest: error

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje