CKTIS / HTML
Atribút integrity — integrita zdrojov
Atribút integrity poskytuje prehliadaču očakávaný odtlačok externého zdroja. Subresource Integrity (SRI) umožňuje odmietnuť skript alebo štýlový hárok, ak jeho obsah nezodpovedá deklarovaným metadátam.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
integrity="sha256-<base64-digest>"integrity je textový atribút pre Subresource Integrity (SRI), nie globálny ani booleovský atribút. Zápis sha256-<base64-digest> spája názov algoritmu s odtlačkom zakódovaným v Base64. Odtlačok opisuje obsah zdroja, nie jeho URL; pri zmene obsahu treba odtlačok aktualizovať.
Na prvku script atribút nastavuje metadáta integrity pre počiatočné načítanie externého skriptu. Nekontroluje kód zapísaný priamo v prvku a automaticky sa nevzťahuje na importované moduly. Na prvku link je povolený iba vtedy, keď rel obsahuje stylesheet, preload alebo modulepreload.
Ak načítaný zdroj neprejde kontrolou integrity, prehliadač ho nepoužije ako úspešne načítaný skript alebo štýlový hárok. SRI nenahrádza HTTPS ani dôveru v dokument obsahujúci odtlačok: útočník, ktorý môže zmeniť zdroj aj jeho deklaráciu integrity, môže nahradiť oboje. Zdroje z iného originu vyžadujú podporu CORS; zvyčajne sa používa crossorigin="anonymous" a server musí túto požiadavku povoliť.
Príklad sa dvakrát pokúsi načítať ten istý objekt Blob ako skript. Objekt obsahuje presne tri bajty: abc bez znaku konca riadka. Pri prvom pokuse sa použije zhodný odtlačok SHA-256, pri druhom nezhodný. Príklad zobrazí Matching digest: load a Mismatched digest: error na samostatných riadkoch. V iných situáciách môže udalosť error znamenať aj chybu siete, nielen nezhodu odtlačku. Nastavte integrity pred začiatkom načítania; neskoršia zmena atribútu znova neskontroluje už načítaný skript.
Prí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ýsledok
Matching digest: load Mismatched digest: error
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.