Uma aplicação que carrega JavaScript de outro servidor pode receber um arquivo diferente daquele aprovado pela equipe, mesmo que o endereço do recurso continue igual. Quem mantém páginas com bibliotecas ou serviços externos deve identificar os arquivos que podem ter seu conteúdo fixado, associar a eles um hash de integridade e planejar a troca desse hash junto com cada atualização. O controle, chamado SRI, ajuda a impedir que o navegador execute um recurso alterado; uma implantação sem coordenação também pode interromper funções legítimas.
O cenário deste guia é ilustrativo, não um teste executado: uma página de agendamento carrega uma biblioteca externa estável para exibir o calendário. O responsável pela aplicação controla o HTML, mas não o servidor que entrega a biblioteca. A decisão prática é se vale fixar o conteúdo desse arquivo, quem autoriza suas atualizações e como perceber uma falha antes que ela afete visitantes. Nenhuma medição de disponibilidade ou eficácia é atribuída a essa página hipotética.
O que o SRI verifica
A especificação do W3C descreve um mecanismo para conferir a integridade do recurso recebido. Em termos operacionais, o navegador verifica se o recurso entregue corresponde ao hash esperado antes de usá-lo. O hash fica associado à referência do arquivo na página; não é uma verificação periódica de tudo que existe no servidor externo. Se o conteúdo recebido não corresponder ao valor autorizado, o recurso não deve ser usado como se fosse a versão aprovada.
Essa distinção muda a escolha do alvo. Para a biblioteca do calendário, cujo arquivo aprovado deve permanecer igual entre implantações, fixar o hash oferece uma condição clara: aceitar aqueles bytes ou deixar de carregar o recurso. Já um arquivo que o fornecedor modifica continuamente no mesmo endereço cria um conflito operacional. A equipe teria de aprovar cada mudança e atualizar a página em sincronia, ou escolher outra arquitetura de entrega. Acrescentar um hash antigo e esperar que futuras versões continuem funcionando não é um plano de manutenção.
SRI não examina se a biblioteca aprovada é segura. Um código inadequado pode ter exatamente o hash cadastrado. Também não decide quais scripts a página tem permissão para carregar: essa é outra pergunta de arquitetura. O guia sobre CSP com nonce aborda a autorização de execução; aqui, o objetivo mais estreito é conferir o conteúdo de um recurso referenciado.
Escolha um arquivo estável
Comece pela página e pelo fluxo, não por uma regra aplicada indiscriminadamente a todos os endereços externos. No exemplo ilustrativo, a equipe identifica o arquivo necessário para abrir o calendário, registra quem fornece o recurso e descobre se o endereço representa uma versão fixa ou se pode mudar sem aviso. Confere também se outro script carrega arquivos adicionais durante a execução. Um hash associado à biblioteca inicialmente referenciada não se transforma, por si, em aprovação de toda essa cadeia.
O W3C documenta o atributo de integridade para recursos carregados por elementos de script e de folha de estilos. Para calcular o valor esperado, a equipe precisa trabalhar com o conteúdo exato do arquivo aprovado, não com seu nome, endereço ou uma descrição da versão. O procedimento deve fazer parte da revisão de mudança: obter o arquivo pela origem pretendida, decidir se seu conteúdo é aceitável, calcular o hash e registrar a correspondência com a referência usada na página. Copiar um valor encontrado em outra aplicação, sem conferir o arquivo que será servido, retira dessa revisão seu propósito.
No cenário do calendário, o critério de aceite deve ser observável: a página abre, o calendário aparece e uma marcação de teste segue o fluxo esperado no ambiente de homologação. Defina também o comportamento desejado se a biblioteca não carregar: uma mensagem compreensível ou um caminho alternativo é melhor do que uma tela aparentemente pronta que não aceita marcações. Trata-se de um critério proposto para a aplicação hipotética, não de um resultado já observado.
Confira a entrega entre origens
Fixar o hash não resolve sozinho o carregamento de um arquivo vindo de outro domínio. A documentação da MDN estabelece que requisições entre origens com SRI precisam usar CORS. A configuração envolve tanto o atributo crossorigin na referência do recurso quanto uma resposta do servidor externo que permita o compartilhamento necessário. Se o fornecedor não entrega o cabeçalho apropriado, acrescentar apenas o hash pode fazer o arquivo deixar de carregar.
Antes de alterar a página, verifique a resposta efetivamente recebida do endereço escolhido e confirme com o fornecedor se essa configuração será mantida. Depois, observe a requisição e o console do navegador no fluxo de homologação. Uma falha de CORS, uma divergência de hash e a indisponibilidade do servidor externo exigem correções diferentes; classificar todas como “problema do SRI” atrasa o diagnóstico. Repita a verificação nos caminhos que montam a página de modo diferente, se houver mais de uma versão do HTML em circulação.
A inspeção do código-fonte da aplicação pode ajudar a localizar referências externas mantidas pela própria equipe. Ela não substitui a observação da página entregue nem revela necessariamente tudo o que um gerenciador de tags acrescenta em tempo de execução. Para organizar regras de busca específicas do projeto durante o levantamento, há um guia separado sobre regras SAST escritas para o próprio código. O inventário final, porém, deve refletir os recursos vistos no fluxo real que será protegido.
Planeje atualização e falha
A OWASP alerta que uma atualização do recurso sem a troca correspondente do hash pode quebrar a página. O bloqueio é coerente com a finalidade do controle: conteúdo diferente não recebe aprovação automática só porque veio do mesmo endereço. Para a equipe responsável pelo calendário, isso significa tratar a atualização da biblioteca e a mudança da referência HTML como uma única alteração revisada, com responsável e possibilidade de reversão.
A tabela a seguir é um roteiro de decisão para o cenário ilustrativo. Ela não relata testes realizados.
| Condição encontrada | Verificação necessária | Decisão proposta |
|---|---|---|
| Arquivo externo com conteúdo fixo | Conferir arquivo aprovado, hash e resposta entre origens | Preparar implantação com SRI e ensaio do fluxo |
| Mesmo endereço recebe alterações frequentes | Confirmar quem muda o arquivo e quando | Buscar versão fixa ou outra forma de entrega antes de exigir o hash |
| Recurso deixa de carregar | Distinguir divergência de hash, CORS e falha da origem | Conter o impacto e corrigir a causa; não remover o controle por reflexo |
| Outro script carrega dependências | Mapear quem escolhe os endereços adicionais | Revisar a cadeia separadamente |
Na implantação, mantenha um registro curto: endereço do arquivo, conteúdo aprovado, valor do hash, pessoa que revisou a mudança, fluxo afetado e procedimento de reversão. Compare a página efetivamente entregue antes e depois da alteração. Se o calendário parar, esse registro permite saber se houve atualização esperada do fornecedor, erro na montagem do HTML ou resposta incompatível entre origens. Sem ele, a equipe pode acabar substituindo o hash apenas para fazer o erro desaparecer, sem examinar o novo código.
Decisão para a equipe
Como prioridade P1, selecione uma dependência externa estável que participe de um fluxo essencial, confirme que seu fornecedor permite a requisição entre origens exigida pelo navegador e defina como aprovar o conteúdo. Antes de ativar o controle, ensaie tanto o carregamento esperado quanto a resposta da aplicação quando o recurso falha. A ausência de erro em uma visita isolada não comprova cobertura de outros caminhos ou navegadores atendidos pelo produto.
Como prioridade P2, incorpore a revisão do hash ao processo de atualização da dependência e amplie o inventário para outras páginas. Recursos alterados continuamente merecem uma decisão explícita de arquitetura, não uma exceção silenciosa. O resultado útil não é declarar que todos os scripts estão protegidos: é saber quais arquivos têm conteúdo fixado, quem pode mudar essa decisão e como a aplicação reage quando um deles não passa na verificação.
O limite permanece claro. SRI compara o recurso entregue com o conteúdo que a própria equipe decidiu aceitar; não audita esse conteúdo, não protege uma página principal comprometida e não substitui a revisão das dependências. Quando o arquivo aprovado muda, a decisão precisa ser refeita. Essa disciplina operacional é o que permite usar o bloqueio de conteúdo inesperado sem transformar uma atualização legítima em interrupção evitável.