Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

Attributo integrity — integrità delle risorse

L’attributo integrity fornisce al browser l’hash atteso di una risorsa esterna. Subresource Integrity (SRI) consente di rifiutare uno script o un foglio di stile quando il contenuto non corrisponde ai metadati dichiarati.

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

Sintassi

integrity="sha256-<base64-digest>"

integrity è un attributo testuale di Subresource Integrity (SRI), non un attributo globale o booleano. La forma sha256-<base64-digest> combina il nome di un algoritmo con un hash codificato in Base64. L’hash descrive il contenuto della risorsa, non il suo URL; se il contenuto cambia, è necessario aggiornare l’hash.

Su script, l’attributo imposta i metadati di integrità per il recupero iniziale di uno script esterno. Non controlla il codice scritto direttamente nell’elemento e non copre automaticamente i moduli importati. Su link, è consentito solo quando rel contiene stylesheet, preload o modulepreload.

Se una risorsa recuperata non supera il controllo di integrità, il browser non la usa come script o foglio di stile caricato correttamente. SRI non sostituisce HTTPS né la fiducia nel documento che contiene l’hash: un aggressore in grado di modificare sia la risorsa sia la relativa dichiarazione integrity può sostituirle entrambe. Le risorse di un’altra origine richiedono il supporto CORS; di solito si usa crossorigin="anonymous" e il server deve consentire la richiesta.

L’esempio tenta due volte di caricare lo stesso oggetto Blob come script. L’oggetto contiene esattamente tre byte: abc, senza caratteri di fine riga. Il primo tentativo usa un hash SHA-256 che corrisponde a quello del contenuto, il secondo uno che non corrisponde. L’esempio mostra Matching digest: load e Mismatched digest: error su righe separate. In altre situazioni, un evento error può anche indicare un errore di rete anziché una mancata corrispondenza dell’hash. Imposta integrity prima che inizi il recupero; modificarlo in seguito non ricontrolla uno script già caricato.

Esempi

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

Risultato

Matching digest: load
Mismatched digest: error

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti