Restrições interpretadas pelo navegador
A CSP (Content Security Policy) é um mecanismo que permite a uma página restringir o carregamento e a execução de recursos no navegador. O servidor pode declarar a política no cabeçalho Content-Security-Policy, enviado junto com a resposta da página.
Cada diretiva controla um tipo de recurso ou de comportamento. A diretiva script-src, por exemplo, determina as fontes permitidas para scripts e as condições de execução. O navegador compara o carregamento solicitado com a política recebida e recusa o que ela não permite. Uma restrição também pode atingir um script legítimo necessário ao formulário, por isso você precisa conferir o funcionamento da página ao configurar a política.
Scripts da própria origem
Considere este cabeçalho como um exemplo reduzido, com uma única política aplicada:
Content-Security-Policy: script-src 'self'A expressão 'self' permite carregar scripts da própria origem da página, identificada pelo esquema, pelo host e pela porta. Um formulário em https://app.example pode carregar o arquivo /validacao.js dessa origem. Um arquivo hospedado em https://cdn.example fica fora da permissão. O console do navegador permite conferir a violação que explica a ausência desse script.
Essa configuração também não autoriza automaticamente um script escrito dentro do HTML. A autorização de código inline exige condições próprias, como um nonce ou um hash permitido. O exemplo trata de scripts e não constitui uma política completa para a aplicação. O documento CSP Level 3 do W3C detalha as diretivas e continua em desenvolvimento.
Teste com Report-Only
O cabeçalho Content-Security-Policy-Report-Only permite observar violações de uma política sem aplicar suas restrições. O envio dos relatórios exige um destino configurado. Você pode usar esse modo para identificar o script externo do formulário e conferir se ele precisa ser autorizado.
Uma política aplicada pelo cabeçalho normal continua valendo mesmo que exista outra em Report-Only. Você ainda precisa corrigir a origem de uma injeção de código na aplicação, pois as restrições do navegador têm alcance limitado pela política configurada.
Dúvidas frequentes
Perguntas frequentes sobre CSP
- O que significa script-src?
- A diretiva script-src define as fontes permitidas para scripts e as condições para executar código inline. Autorizar uma origem não autoriza automaticamente um script escrito dentro do HTML.
- O modo Report-Only recusa recursos?
- O cabeçalho Content-Security-Policy-Report-Only observa as violações sem aplicar aquela política. O envio dos relatórios exige configuração. Outras políticas aplicadas à página continuam podendo recusar o recurso.
- A CSP substitui a correção de uma injeção de código?
- A aplicação ainda precisa corrigir a origem da injeção. A política acrescenta restrições no navegador, cujo alcance depende das diretivas e das permissões configuradas.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar as diretivas da CSP e investigar por que um script da página foi recusado.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A política de segurança de conteúdo exige conferir quais scripts a aplicação usa e como eles são autorizados no navegador.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.