CKTIS / HTML
Atributo integrity — integridade dos recursos
O atributo integrity fornece ao navegador o resumo esperado de um recurso externo. Subresource Integrity (SRI) permite rejeitar um script ou uma folha de estilos quando o conteúdo não corresponde aos metadados declarados.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
integrity="sha256-<base64-digest>"integrity é um atributo textual de Subresource Integrity (SRI), não um atributo global nem booleano. A forma sha256-<base64-digest> combina o nome de um algoritmo com um resumo codificado em Base64. O resumo descreve o conteúdo do recurso, não o respetivo URL; se o conteúdo mudar, é necessário atualizar o resumo.
Em script, o atributo define os metadados de integridade para a obtenção inicial de um script externo. Não verifica o código escrito diretamente no elemento e não abrange automaticamente os módulos importados. Em link, só é permitido quando rel contém stylesheet, preload ou modulepreload.
Se um recurso obtido não passar a verificação de integridade, o navegador não o utiliza como script ou folha de estilos carregados com sucesso. SRI não substitui HTTPS nem a confiança no documento que contém o resumo: um atacante que consiga alterar tanto o recurso como a respetiva declaração integrity pode substituir ambos. Os recursos de outra origem necessitam de suporte de CORS; normalmente usa-se crossorigin="anonymous" e o servidor tem de permitir esse pedido.
O exemplo tenta carregar duas vezes o mesmo objeto Blob como script. O objeto contém exatamente três bytes: abc, sem uma quebra de linha. A primeira tentativa usa um resumo SHA-256 que corresponde ao do conteúdo e a segunda usa um que não corresponde. O exemplo apresenta Matching digest: load e Mismatched digest: error em linhas separadas. Noutras situações, um evento error também pode indicar um erro de rede, e não apenas uma divergência do resumo. Define integrity antes de começar a obtenção; alterar o atributo posteriormente não volta a verificar um script já carregado.
Exemplos
<!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>Resultado
Matching digest: load Mismatched digest: error
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.