CKTIS / HTML
Atrybut integrity — integralność zasobów
Atrybut integrity przekazuje przeglądarce oczekiwany skrót zasobu zewnętrznego. Mechanizm Subresource Integrity (SRI) pozwala odrzucić skrypt lub arkusz stylów, którego zawartość nie odpowiada zadeklarowanym metadanym.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
integrity="sha256-<base64-digest>"integrity jest tekstowym atrybutem mechanizmu Subresource Integrity (SRI), a nie atrybutem globalnym ani logicznym. Zapis sha256-<base64-digest> łączy nazwę algorytmu ze skrótem zakodowanym w Base64. Skrót opisuje zawartość zasobu, nie jego adres URL; zmiana zawartości wymaga aktualizacji skrótu.
Na elemencie script atrybut określa metadane integralności początkowego pobrania skryptu zewnętrznego. Nie sprawdza kodu wpisanego bezpośrednio w element i nie obejmuje automatycznie importowanych modułów. Na elemencie link jest dozwolony tylko wtedy, gdy rel zawiera stylesheet, preload lub modulepreload.
Gdy pobrany zasób nie przejdzie kontroli, przeglądarka nie używa go jako poprawnie załadowanego skryptu lub arkusza stylów. SRI nie zastępuje HTTPS ani zaufania do dokumentu zawierającego skrót: napastnik mogący zmienić zarówno zasób, jak i deklarację integrity może podmienić oba. Dla zasobów z innego originu potrzebna jest obsługa CORS; zwykle stosuje się crossorigin="anonymous", a serwer musi zezwolić na takie żądanie.
Przykład próbuje dwukrotnie załadować ten sam obiekt Blob jako skrypt. Obiekt zawiera dokładnie trzy bajty: abc, bez znaku nowego wiersza. Pierwsza próba używa pasującego skrótu SHA-256, a druga — niepasującego. Przykład wyświetla w osobnych wierszach Matching digest: load i Mismatched digest: error. W innych sytuacjach zdarzenie error może też oznaczać błąd sieci, nie tylko niezgodność skrótu. Ustaw integrity przed rozpoczęciem pobierania; późniejsza zmiana atrybutu nie uruchamia ponownej kontroli już załadowanego skryptu.
Przykłady
<!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>Wynik
Matching digest: load Mismatched digest: error
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.