Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

Atributo integrity — integridad de recursos

El atributo integrity proporciona al navegador el resumen esperado de un recurso externo. Subresource Integrity (SRI) permite rechazar un script o una hoja de estilo cuando su contenido no coincide con los metadatos declarados.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

integrity="sha256-<base64-digest>"

integrity es un atributo textual de Subresource Integrity (SRI), no un atributo global ni booleano. La forma sha256-<base64-digest> combina el nombre de un algoritmo con un resumen codificado en Base64. El resumen describe el contenido del recurso, no su URL; si cambia el contenido, hay que actualizar el resumen.

En script, el atributo establece los metadatos de integridad para la descarga inicial de un script externo. No comprueba el código escrito directamente dentro del elemento ni cubre automáticamente los módulos importados. En link, solo se permite cuando rel contiene stylesheet, preload o modulepreload.

Si un recurso descargado no supera la comprobación de integridad, el navegador no lo utiliza como script u hoja de estilo cargados correctamente. SRI no sustituye HTTPS ni la confianza en el documento que contiene el resumen: un atacante que pueda cambiar tanto el recurso como su declaración integrity puede sustituir ambos. Los recursos de otro origen necesitan compatibilidad con CORS; normalmente se usa crossorigin="anonymous" y el servidor debe permitir esa solicitud.

El ejemplo intenta cargar dos veces el mismo objeto Blob como script. El objeto contiene exactamente tres bytes: abc, sin salto de línea. El primer intento usa un resumen SHA-256 que coincide con el del contenido y el segundo usa uno que no coincide. El ejemplo muestra Matching digest: load y Mismatched digest: error en líneas separadas. En otras situaciones, un evento error también puede indicar un error de red, no solo una discrepancia del resumen. Establece integrity antes de que empiece la descarga; cambiar el atributo después no vuelve a comprobar un script ya cargado.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes