CKTIS / HTML
integrity-attribuut — integriteit van bronnen
Het integrity-attribuut geeft de browser de verwachte hash van een externe bron. Met Subresource Integrity (SRI) kan een script of stylesheet worden geweigerd als de inhoud niet overeenkomt met de opgegeven metadata.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
integrity="sha256-<base64-digest>"integrity is een tekstueel attribuut voor Subresource Integrity (SRI), geen globaal of boolean attribuut. De vorm sha256-<base64-digest> combineert een algoritmenaam met een in Base64 gecodeerde hash. De hash beschrijft de inhoud van de bron, niet de URL; verandert de inhoud, dan moet ook de hash worden bijgewerkt.
Bij script stelt het attribuut integriteitsmetadata in voor het eerste ophalen van een extern script. Het controleert geen code die rechtstreeks in het element staat en omvat geïmporteerde modules niet automatisch. Bij link is het alleen toegestaan als rel stylesheet, preload of modulepreload bevat.
Als een opgehaalde bron de integriteitscontrole niet doorstaat, gebruikt de browser deze niet als een succesvol geladen script of stylesheet. SRI vervangt HTTPS of het vertrouwen in het document met de hash niet: een aanvaller die zowel de bron als de integrity-declaratie kan wijzigen, kan beide vervangen. Bronnen van een andere origin vereisen CORS-ondersteuning; doorgaans gebruik je crossorigin="anonymous" en moet de server dat verzoek toestaan.
Het voorbeeld probeert twee keer hetzelfde Blob-object als script te laden. Het object bevat precies drie bytes: abc, zonder regeleinde. De eerste poging gebruikt een overeenkomende SHA-256-hash en de tweede een afwijkende hash. Het voorbeeld toont Matching digest: load en Mismatched digest: error op aparte regels. In andere situaties kan een error-gebeurtenis ook op een netwerkfout wijzen in plaats van op een afwijkende hash. Stel integrity in voordat het ophalen begint; een latere wijziging van het attribuut controleert een al geladen script niet opnieuw.
Voorbeelden
<!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>Resultaat
Matching digest: load Mismatched digest: error
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.