Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

Atribut integrity — cjelovitost resursa

Atribut integrity pregledniku daje očekivani sažetak vanjskog resursa. Subresource Integrity (SRI) omogućuje odbacivanje skripte ili stilske datoteke čiji sadržaj ne odgovara deklariranim metapodacima.

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

Sintaksa

integrity="sha256-<base64-digest>"

integrity je tekstualni atribut za Subresource Integrity (SRI), a ne globalni ili logički atribut. Oblik sha256-<base64-digest> spaja naziv algoritma sa sažetkom kodiranim u Base64. Sažetak opisuje sadržaj resursa, a ne njegov URL; promjena sadržaja zahtijeva ažuriranje sažetka.

Na elementu script atribut postavlja metapodatke cjelovitosti za početno dohvaćanje vanjske skripte. Ne provjerava kod napisan izravno unutar elementa i ne obuhvaća automatski uvezene module. Na elementu link dopušten je samo ako rel sadrži stylesheet, preload ili modulepreload.

Ako dohvaćeni resurs ne prođe provjeru cjelovitosti, preglednik ga ne upotrebljava kao uspješno učitanu skriptu ili stilsku datoteku. SRI ne zamjenjuje HTTPS ni povjerenje u dokument koji sadrži sažetak: napadač koji može promijeniti i resurs i njegovu deklaraciju integrity može zamijeniti oboje. Resursi s drugog podrijetla trebaju podršku za CORS; obično se upotrebljava crossorigin="anonymous", a poslužitelj mora dopustiti taj zahtjev.

Primjer dvaput pokušava učitati isti objekt Blob kao skriptu. Objekt sadrži točno tri bajta: abc, bez znaka za novi redak. U prvom se pokušaju upotrebljava SHA-256 sažetak koji odgovara sadržaju, a u drugom sažetak koji mu ne odgovara. Primjer prikazuje Matching digest: load i Mismatched digest: error u zasebnim redcima. U drugim situacijama događaj error može upućivati i na mrežnu pogrešku, a ne samo na nepodudaranje sažetka. Postavite integrity prije početka dohvaćanja; naknadna promjena atributa neće ponovno provjeriti već učitanu skriptu.

Primjeri

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

Rezultat

Matching digest: load
Mismatched digest: error

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori