Conteúdo do curso Lição 73 de 156 · Terceiros no seu próprio site
Terceiros no seu próprio site

Subresource Integrity

Por que isso importa Quando você incorpora https://cdn.example/lib.js, confia em quem controla esse servidor hoje e todos os dias depois. Se ele for invadido, ou se o arquivo for trocado em silêncio, seus visitantes rodam o código novo no seu site. O Subresource Integrity permite que o navegador recuse qualquer versão que você não aprovou.

Pense em um lacre de segurança em um frasco de remédio. Você confere o lacre antes de tomar qualquer coisa. Se ele estiver rompido, você não toma, seja quem for que o colocou na prateleira.

Subresource Integrity (SRI): um atributo integrity em uma tag <script> ou <link rel="stylesheet"> que guarda um hash do arquivo exato que você espera. O navegador faz o hash do que baixa e se recusa a usar o arquivo se os hashes forem diferentes.

Hash: uma função que transforma qualquer dado em uma impressão digital curta de tamanho fixo. Os mesmos bytes sempre dão a mesma impressão digital; mude um byte e a impressão digital muda por completo. O SHA-384 é o hash mais usado para SRI.

Como fica a tag

<script src="https://cdn.example/lib.js"
        integrity="sha384-iht3RcshTShmtRmXjSLQ8CjUTiVO41jHRJzgK44j1lSJHvfC4YAeuY4ZOoMtzhi5"
        crossorigin="anonymous"></script>

O valor é o nome do algoritmo, um hífen e depois o hash escrito em Base64 (um jeito de escrever bytes usando letras, dígitos, + e /). A parte crossorigin="anonymous" é necessária para arquivos de outro site: o navegador os busca sem cookies, e o servidor precisa permitir isso com um cabeçalho Access-Control-Allow-Origin, senão a verificação não consegue rodar e o arquivo é bloqueado. O SRI funciona em todos os principais navegadores (verificado em outubro de 2026).

Calculando um em Python

import base64, hashlib
data = b"console.log('hi')"
digest = hashlib.sha384(data).digest()          # 48 raw bytes
print("sha384-" + base64.b64encode(digest).decode("ascii"))

hashlib.new(name, data) faz o mesmo para qualquer algoritmo dado pelo nome, como "sha256" ou "sha512". Repare em .digest() (bytes brutos, o que o SRI quer) versus .hexdigest() (texto hexadecimal, que estaria errado aqui).

Como o navegador confere

  1. Divide o atributo nos espaços. Você pode listar vários hashes, por exemplo durante a troca de versões de um arquivo.
  2. Fica só com os tokens de um algoritmo que conhece: sha256, sha384, sha512. Ignora o resto. (Um token pode terminar com ?options; essa parte é descartada.)
  3. Se não sobrar nada utilizável, ele não faz verificação nenhuma e usa o arquivo. Um erro de digitação como sha385-... portanto desliga a proteção em silêncio. Sempre teste se um hash errado realmente bloqueia o arquivo.
  4. Caso contrário, pega o algoritmo mais forte presente (sha512 ganha de sha384, que ganha de sha256) e olha só os tokens desse algoritmo. Se algum deles bater com o hash do arquivo, o arquivo é usado; se nenhum bater, ele é bloqueado.

Um equívoco comum: "o SRI mantém o arquivo privado". Ele não esconde nada, e o terceiro ainda vê a requisição. O SRI só garante que o código é o código que você aprovou. Ele também não funciona para arquivos que mudam o tempo todo, como um script de anúncios; para esses, a resposta honesta muitas vezes é não incorporá-los.

Em outras linguagens
# Shell (OpenSSL)
openssl dgst -sha384 -binary lib.js | openssl base64 -A
// JavaScript (Node)
const crypto = require("crypto");
const sri = "sha384-" + crypto.createHash("sha384").update(fs.readFileSync("lib.js")).digest("base64");
// Go
sum := sha512.Sum384(data)
sri := "sha384-" + base64.StdEncoding.EncodeToString(sum[:])
// PHP
$sri = 'sha384-' . base64_encode(hash('sha384', $data, true));
// C#
var sri = "sha384-" + Convert.ToBase64String(SHA384.HashData(data));

Bundlers conseguem acrescentar SRI para você (por exemplo o plugin webpack-subresource-integrity).

Resumo

  • O SRI fixa um script ou uma folha de estilos incorporados nos bytes exatos que você aprovou.
  • O valor é algorithm-Base64(hash), e arquivos de outros sites também precisam de crossorigin="anonymous".
  • O navegador usa só o algoritmo mais forte listado, e um atributo sem nada utilizável significa nenhuma verificação.
Sua vez

Escreva três funções:

  1. sri_hash(data, algorithm="sha384"): data são bytes. Retorne o valor de SRI: o nome do algoritmo, um hífen e o Base64 do digest bruto (use hashlib.new(algorithm, data).digest() e base64.b64encode).
  2. verify_sri(data, integrity): confira data do jeito que um navegador faz. Divida integrity nos espaços em branco; fique com os tokens cuja parte antes do primeiro - é sha256, sha384 ou sha512 e cujo valor não está vazio, descartando qualquer coisa a partir de um ?. Se nenhum sobrar, retorne True (sem verificação). Caso contrário, use só o algoritmo mais forte presente e retorne True se algum dos valores dele bater com o hash dos dados nesse algoritmo, senão False.
  3. script_tag(url, data): retorne exatamente <script src="URL" integrity="VALUE" crossorigin="anonymous"></script> com o valor sha384 de data.
Imprima a tag da biblioteca de prática no fim. Os testes usam dados aleatórios.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.