Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes