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.