CKTIS / HTML
integrity-Attribut — Ressourcenintegrität
Das integrity-Attribut gibt dem Browser einen erwarteten Hashwert für eine externe Ressource vor. Mit Subresource Integrity (SRI) kann ein Skript oder Stylesheet abgewiesen werden, wenn sein Inhalt nicht den angegebenen Metadaten entspricht.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
integrity="sha256-<base64-digest>"integrity ist ein Textattribut für Subresource Integrity (SRI), kein globales oder boolesches Attribut. Die Form sha256-<base64-digest> verbindet einen Algorithmusnamen mit einem Base64-kodierten Hashwert. Der Hashwert beschreibt den Inhalt der Ressource, nicht ihre URL; bei einer Inhaltsänderung muss auch der Hashwert aktualisiert werden.
Bei script legt das Attribut Integritätsmetadaten für den anfänglichen Abruf eines externen Skripts fest. Es prüft weder Code, der direkt im Element steht, noch erfasst es automatisch importierte Module. Bei link ist es nur zulässig, wenn rel stylesheet, preload oder modulepreload enthält.
Besteht eine abgerufene Ressource die Integritätsprüfung nicht, verwendet der Browser sie nicht als erfolgreich geladenes Skript oder Stylesheet. SRI ersetzt weder HTTPS noch das Vertrauen in das Dokument, das den Hashwert enthält: Ein Angreifer, der sowohl die Ressource als auch ihre integrity-Deklaration ändern kann, kann beide austauschen. Ressourcen von anderen Origins benötigen CORS-Unterstützung; üblicherweise wird crossorigin="anonymous" verwendet, und der Server muss diese Anfrage erlauben.
Das Beispiel versucht zweimal, dasselbe Blob-Objekt als Skript zu laden. Das Objekt enthält genau drei Bytes: abc ohne Zeilenumbruch. Beim ersten Versuch wird ein passender SHA-256-Hashwert verwendet, beim zweiten ein nicht passender. Das Beispiel zeigt Matching digest: load und Mismatched digest: error in getrennten Zeilen an. In anderen Fällen kann das Ereignis error auch auf einen Netzwerkfehler statt auf einen abweichenden Hashwert hinweisen. Setze integrity, bevor der Abruf beginnt; eine spätere Änderung des Attributs prüft ein bereits geladenes Skript nicht erneut.
Beispiele
<!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>Ergebnis
Matching digest: load Mismatched digest: error
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.