Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

Atribut integrity — celovitost virov

Atribut integrity brskalniku posreduje pričakovani povzetek zunanjega vira. Subresource Integrity (SRI) omogoča zavrnitev skripta ali slogovne datoteke, če se njena vsebina ne ujema z navedenimi metapodatki.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

integrity="sha256-<base64-digest>"

integrity je besedilni atribut za Subresource Integrity (SRI), ne pa globalni ali logični atribut. Zapis sha256-<base64-digest> združuje ime algoritma s povzetkom, kodiranim v Base64. Povzetek opisuje vsebino vira, ne njegovega URL-ja; ob spremembi vsebine je treba povzetek posodobiti.

Pri elementu script atribut določa metapodatke celovitosti za začetni prenos zunanjega skripta. Ne preverja kode, zapisane neposredno v elementu, in samodejno ne zajema uvoženih modulov. Pri elementu link je dovoljen samo, če rel vsebuje stylesheet, preload ali modulepreload.

Če preneseni vir ne prestane preverjanja celovitosti, ga brskalnik ne uporabi kot uspešno naložen skript ali slogovno datoteko. SRI ne nadomešča HTTPS ali zaupanja v dokument, ki vsebuje povzetek: napadalec, ki lahko spremeni tako vir kot njegovo deklaracijo integrity, lahko zamenja oboje. Viri z drugega izvora potrebujejo podporo CORS; običajno se uporabi crossorigin="anonymous", strežnik pa mora zahtevo dovoliti.

Primer dvakrat poskusi naložiti isti objekt Blob kot skript. Objekt vsebuje natanko tri bajte: abc, brez znaka za novo vrstico. Pri prvem poskusu uporabi ujemajoči se povzetek SHA-256, pri drugem pa povzetek, ki se ne ujema. Primer prikaže Matching digest: load in Mismatched digest: error v ločenih vrsticah. V drugih primerih lahko dogodek error pomeni tudi omrežno napako in ne le neujemanje povzetka. Nastavite integrity, preden se začne prenos; poznejša sprememba atributa ne preveri znova že naloženega skripta.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri