Equipes que mantêm aplicações web com scripts incorporados precisam decidir como restringir sua execução sem interromper páginas legítimas. Para implantar uma CSP com nonce, a ação prioritária é mapear os scripts de uma página representativa, gerar o valor no servidor para cada resposta e observar as violações antes de impor o bloqueio. Uma política copiada de outro sistema pode tanto deixar caminhos perigosos abertos quanto impedir funções essenciais.
O cenário demonstrativo deste guia é ilustrativo, não um teste executado: uma aplicação de atendimento tem um script próprio inserido no HTML e outro carregado pelo primeiro. O objetivo é decidir quais scripts devem receber confiança, como verificar dependências e em que momento a política pode passar de observação para aplicação. Não há medição de eficácia nem resultado de implantação atribuído a essa aplicação fictícia.
O que o nonce autoriza
Uma política de segurança de conteúdo, ou CSP, é enviada no cabeçalho HTTP da resposta e informa ao navegador quais recursos e comportamentos serão permitidos. No caso dos scripts, um nonce é um valor incluído tanto na política quanto no elemento de script que a aplicação autoriza. O nonce deve ser gerado para cada resposta HTTP. Essa exigência consta da orientação da OWASP sobre CSP. O valor não é uma senha permanente nem uma permissão para todos os scripts daquela página.
No cenário ilustrativo, o servidor que monta a página cria o valor, insere esse mesmo valor no cabeçalho e o associa apenas ao script próprio selecionado no modelo HTML. A equipe deve identificar o componente responsável pela geração e conferir o caminho completo da resposta: aplicação, camada de cache e navegador. Se uma página HTML for reutilizada com o mesmo valor quando deveria receber uma resposta própria, a equipe precisa revisar a arquitetura de entrega antes de considerar a implantação concluída. A recomendação é uma decisão de projeto, não a alegação de que um cache específico foi inspecionado.
Há uma armadilha na implementação por substituição automática: acrescentar o atributo de nonce a toda ocorrência de um elemento de script no HTML pode autorizar também conteúdo que a aplicação não pretendia confiar. A OWASP recomenda que o valor seja inserido por um mecanismo de composição da página, não por uma transformação indiscriminada depois que o HTML está pronto. Isso desloca a revisão para o ponto em que a aplicação sabe quais scripts são seus.
Escolha o escopo da página
Comece por um fluxo com comportamento conhecido, como a abertura da tela de atendimento e o envio de uma solicitação. Registre os scripts próprios, os carregados por terceiros, os manipuladores de eventos escritos diretamente no HTML e as chamadas que transformam texto em código. Não transforme cada erro de console em autorização permanente: antes de liberar uma dependência, confirme quem a carrega e se ela é necessária à função da página.
A análise estática pode ajudar a localizar padrões de código que a equipe já decidiu substituir, mas não comprova sozinha o comportamento observado no navegador. O artigo sobre regras SAST escritas para o próprio código oferece uma abordagem complementar para esse levantamento. Já a CSP trata da execução no cliente: as duas práticas respondem a perguntas diferentes e não devem ser apresentadas como substitutas.
Para o fluxo ilustrativo, estabeleça um critério de aceite antes de mudar o cabeçalho: a tela deve abrir, o envio deve concluir e os scripts esperados devem ser identificáveis. Inclua também um caminho de falha, como um serviço externo indisponível, para distinguir quebra causada pela política de um problema independente. Se a aplicação usa páginas montadas por serviços diferentes, avalie as respostas de cada serviço; uma política coerente em uma rota não prova cobertura nas demais.
Observe antes de bloquear
O cabeçalho de observação registra violações sem impor a política. A documentação da MDN sobre implantação de CSP recomenda testar a política nesse modo antes de aplicar o cabeçalho de bloqueio. A equipe consegue, assim, investigar recursos que deixariam de carregar sem presumir que todo alerta representa um ataque ou uma falha que deva ser liberada.
O modo de observação exige uma forma deliberada de coletar e analisar os eventos; ver uma violação no console durante uma visita manual não equivale a ter acompanhamento dos fluxos de usuários. Defina um destino de relatórios compatível com os navegadores atendidos, limite o acesso aos dados recebidos e estabeleça uma rotina para separar scripts esperados, extensões de navegador e comportamento inesperado. Relatórios podem incluir informações sobre páginas e recursos: trate sua retenção e seu acesso como parte da implantação, não como detalhe posterior.
| Sinal observado | Pergunta para a equipe | Decisão antes do bloqueio |
|---|---|---|
| Script próprio sem autorização | O modelo HTML deveria associar o nonce a esse script? | Corrigir a composição da página e repetir a verificação. |
| Manipulador de evento no HTML | A função pode ser ligada pelo código JavaScript autorizado? | Refatorar o trecho em vez de liberar toda execução incorporada. |
| Script carregado por outro script | Quem controla o carregador e o endereço de destino? | Revisar a cadeia de carregamento antes de estender a confiança. |
| Violação sem efeito funcional conhecido | Ela aparece em um fluxo próprio ou depende do ambiente do visitante? | Investigar a origem; não ampliar a política por reflexo. |
Cuidado com a confiança herdada
Na aplicação ilustrativa, o script próprio autorizado carrega outro arquivo durante a execução. É nesse ponto que a equipe precisa escolher entre ajustar o carregamento ou usar a diretiva strict-dynamic. Com strict-dynamic, um script autorizado pode transmitir confiança aos scripts que carrega. A OWASP descreve esse comportamento para scripts autorizados por nonce ou hash. A diretiva pode resolver uma dependência legítima, mas também torna a revisão do carregador decisiva: o código inicialmente autorizado não deve montar endereços de scripts a partir de entradas que um terceiro controla.
Não aprove uma cadeia apenas porque todos os arquivos pertencem a um fornecedor conhecido. Inspecione onde o endereço é definido, quem pode alterá-lo e o que acontece quando parâmetros da página chegam à função de carregamento. Se a equipe não consegue explicar essa cadeia, mantenha o caso em investigação e procure uma forma mais restrita de carregar a dependência. Uma lista ampla de endereços permitidos não corrige automaticamente uma decisão de confiança mal compreendida.
Também é preciso separar o valor de uma CSP do transporte da página. O cabeçalho não substitui HTTPS nem a operação correta dos certificados usados para entregar a aplicação. Para quem administra esse transporte, o guia de gestão de certificados TLS trata de um controle complementar, com responsáveis e verificações próprios.
Decida a entrada em produção
Classifique como P1 a correção de scripts legítimos que seriam bloqueados em funções essenciais e a investigação de qualquer caminho que dê a um terceiro controle sobre um script autorizado. Antes de impor a política, peça à pessoa responsável pela aplicação que execute os fluxos definidos no critério de aceite, compare os eventos de violação com o inventário e registre as exceções aceitas com justificativa. Se o modo de observação não cobre um fluxo essencial, a ausência de alertas nesse fluxo não serve como aprovação.
Como P2, amplie a revisão para páginas menos usadas, dependências de terceiros e mudanças futuras no processo de entrega. Estabeleça quem reavalia a política quando um novo script é adicionado e como reverter uma alteração que interrompa a aplicação. Depois da ativação, confirme no navegador o cabeçalho efetivamente recebido e o funcionamento dos fluxos escolhidos; uma configuração salva no servidor não demonstra, por si, o comportamento da resposta entregue.
O limite da decisão é claro: a CSP acrescenta uma camada de defesa, mas não elimina vulnerabilidades de injeção nem dispensa o tratamento seguro dos dados exibidos pela aplicação. O resultado esperado desta análise não é um selo de segurança. É uma autorização rastreável para ativar uma política cuja origem dos scripts, cadeia de carregamento, impacto funcional e forma de acompanhamento foram compreendidos pela equipe.