Como configurar CSP sem quebrar seu site com segurança
Índice
A Content Security Policy, conhecida pela sigla CSP, é uma regra de segurança que define quais recursos o navegador pode carregar em uma página. Ela limita a execução de scripts, a incorporação de imagens, as conexões feitas pelo site e outras ações que podem ser exploradas para golpes, roubo de dados ou alterações indevidas.
A proteção é útil, mas uma configuração agressiva pode interromper o funcionamento normal do site. Um formulário que deixa de enviar, um checkout de pagamento que não abre ou um plugin de mapa que desaparece são sintomas comuns de uma política restritiva demais.
A boa notícia é que a maioria desses problemas pode ser evitada com uma implantação gradual. Você começa observando os recursos realmente utilizados, cria regras compatíveis com a aplicação e ativa a proteção aos poucos, sempre com atenção aos registros do navegador.
Este conteúdo tem caráter informativo. Decisões técnicas devem ser tomadas com profissional especializado.
O que é CSP

CSP significa Content Security Policy, ou Política de Segurança de Conteúdo. Ela funciona como uma lista de permissões enviada pelo servidor ao navegador. Quando o navegador recebe essa lista, ele verifica cada recurso antes de carregá-lo.
Uma política pode determinar quais elementos podem ser executados, de quais endereços vêm e para onde os dados podem ser enviados. A sintaxe usa diretivas, como script-src, img-src, connect-src e frame-src. Cada diretiva define uma categoria específica de recursos.
Por exemplo, script-src 'self' permite que a página carregue arquivos JavaScript do próprio domínio. Se uma integração precise de um serviço externo, será necessário autorizar o endereço correspondente de forma explícita.
A CSP não substitui outras medidas de segurança. Ela trabalha melhor ao lado de HTTPS, cookies bem configurados, atualizações, proteção contra injeção de código e controle de acesso. Pense na CSP como uma camada dentro de uma estratégia maior, e não como um botão que resolve todos os riscos.
Quando o navegador bloqueia um item, ele normalmente mostra uma mensagem no console do desenvolvedor. O nome da mensagem pode variar entre navegadores, mas costuma mencionar "Content Security Policy", o tipo de recurso e a diretiva responsável pelo bloqueio.
Configurar CSP sem quebrar o site

Entenda de onde a CSP é enviada
A política precisa ser entregue por meio de um cabeçalho HTTP chamado Content-Security-Policy. A forma mais comum de enviá-lo é pelo servidor web, por exemplo, Nginx, Apache ou a camada de hospedagem. Em WordPress, também existem Plugins que ajudam a inserir ou ajustar cabeçalhos, mas é importante entender que a configuração pode passar por diferentes camadas.
Se duas políticas forem enviadas, o navegador normalmente aplica a combinação mais restritiva. Em outras palavras, adicionar uma regra permissiva depois de uma regra muito rígida pode não Produzir o resultado esperado. Isso ocorre quando uma Plugin insere um cabeçalho e outro componente tenta modificar o mesmo cabeçalho por um método diferente.
Antes de começar, verifique como o cabeçalho está sendo enviado. Você pode usar as ferramentas de desenvolvedor do navegador, a aba Network, para inspecionar uma página e localizar o cabeçalho de resposta. Também é útil consultar um verificador de cabeçalhos disponível para o endereço público do site.
Faça um inventário dos recursos usados
Antes de escrever a primeira regra, observe o que a página realmente carrega. Inventariar os recursos reduz a chance de bloquear algo necessário.
Procure por estes tipos de conteúdo:
- Scripts JavaScript próprios, minificados ou gerados por Plugins
- Folhas de estilo CSS, fontes e imagens
- Recursos de análise e rastreamento
- Sistemas de comentários, chat e formulários
- Players de vídeo e conteúdos incorporados
- Gateways de pagamento
- Mapas, redes sociais e serviços de mapa
- Endpoints de APIs usados por aplicações JavaScript
Observe separadamente as páginas que têm funções diferentes. O site institucional, a área administrativa e o checkout não carregam necessariamente os mesmos recursos. Uma política geral pode ser conveniente, mas páginas com script inline podem exigir uma exceção controlada ou uma solução melhor.
Na prática, o inventário deve responder a três perguntas: qual recurso é carregado, qual é sua origem e por que ele existe. A terceira pergunta ajuda a remover integrações desnecessárias, situação tão prejudicial quanto bloquear uma dependência legítima.
Comece com uma política permissiva de observação
Para projetos em produção, uma etapa útil é observar o comportamento da página com uma política que permita a maioria dos recursos, mas registre violações. O cabeçalho Content-Security-Policy-Report-Only serve exatamente para isso. Ele informa violações sem bloquear o conteúdo.
Uma configuração inicial simples pode seguir este formato:
Content-Security-Policy-Report-Only: default-src 'self'; report-uri /csp-report
O endpoint /csp-report deve receber e registrar os avisos. O local pode variar de acordo com a infraestrutura. Aplicações maiores costumam usar o cabeçalho Reporting-Endpoints com um endpoint do tipo group, e a diretiva report-to para indicar o destino.
Nem todos os navegadores adotam exatamente os mesmos recursos de relatórios. Por isso, a documentação oficial deve ser consultada antes de escolher a combinação de cabeçalhos. O modo de observação não deve ser mantido indefinidamente, pois ele deixa de bloquear recursos indevidos.
Depois da observação, revise os relatórios. Ignore somente ruídos que já foram compreendidos. Para cada violação relevante, identifique a origem, o recurso e a função no site.
Compare diretivas em vez de usar uma regra genérica
Uma política inicial restritiva pode ser criada com default-src, mas é importante entender o efeito de cada diretiva. O padrão não substitui automaticamente todas as regras que ainda não foram definidas. Entender a herança ajuda a evitar surpresas durante os testes.
| Diretiva | Recursos controlados | Exemplo de uso |
|---|---|---|
default-src |
Recursos sem uma diretiva mais específica | Restringir a regra geral do site |
script-src |
Scripts JavaScript eWeb Workers | Permitir scripts próprios e integrações aprovadas |
style-src |
Folhas de estilo e elementos de estilo | Libera scripts de estilo usados por alguns componentes |
img-src |
Imagens, favicons e pixels de rastreamento | Autorizar imagens locais e provedores necessários |
font-src |
Fontes carregadas pelo site | Permitir fontes locais ou de um provedor externo |
connect-src |
Requisições feitas por scripts, como APIs | Autorizar o endpoint do próprio sistema |
frame-src |
Conteúdo incorporado em iframes | Permitir players, mapas ou sistemas de pagamento |
media-src |
Áudio e vídeo | Autorizar streaming e arquivos de mídia |
object-src |
Plugins como Flash ou applets | Recomenda-se bloquear com 'none' |
base-uri |
URL base usada pelo documento | Impedir a alteração por scripts injetados |
form-action |
Endereços destinatários dos formulários | Limitar para o domínio ou serviço esperado |
As permissões precisam refletir a arquitetura real. Se o checkout se communication com um gateway externo por uma API JavaScript, essa origem pode precisar aparecer em connect-src. Se o pagamento é apresentado dentro de um iframe, o domínio do gateway precisa aparecer em frame-src.
A ordem das diretivas também importa. Quando duas diretivas se aplicam ao mesmo recurso, a mais específica prevalece. Por exemplo, script-src tem prioridade sobre default-src para scripts.
Evite scripts inline sempre que possível
Uma política sem a expressão 'unsafe-inline' é mais robusta porque não permite que qualquer script inserido diretamente no HTML seja executado. Scripts inline são trechos de JavaScript colocados entre as tags <script> e </script>.
No WordPress, plugins e temas podem gerar esse tipo de código. Editores de página,-pixel de rastreamento e ferramentas de personalização também podem acrescentá-lo. A remoção completa pode exigir mudanças no código ou na configuração dos componentes.
Quando for necessário manter scripts inline, o uso de hash ou nonce pode ser adequado. Um hash é um resumo criptográfico do conteúdo do script. O navegador o calcula e o compara com o valor autorizado na CSP. Um nonce é um valor aleatório, criado para cada resposta e incorporado tanto na política quanto no script autorizado.
O nonce precisa ser unpredictable e exclusivo da resposta. Reutilizar o mesmo valor em várias páginas enfraquece a proteção. Também é preciso garantir que plugins, CDN e cache não alterem o HTML de maneira incompatível com o valor gerado.
A expressão 'unsafe-inline' deve ser evitada quando possível. Quando for indispensável, seu impacto precisa ser compreendido. Em algumas políticas, ela também pode permitir a execução de scripts inline injetados pelo atacante. O ideal é eliminar a necessidade, migrar para arquivos externos e liberar somente scripts específicos por hash ou nonce.
'unsafe-eval' tem uma função diferente. Ela autoriza o uso de eval, uma forma de executar código escrito como texto. e editores podem depender desse recurso, mas seu uso reduz a proteção. Remova a necessidade sempre que a aplicação permitir.
Faça a transição por Report-Only
O caminho mais seguro costuma ter quatro etapas:
- Identifique as origens permitidas e os recursos que serão bloqueados.
- Publique uma política de observação com relatórios.
- Corrija integrações, migre scripts inline e remova domínios desnecessários.
- Ative a política de bloqueio e acompanhe os registros por um período definido.
O nome da diretiva Content-Security-Policy-Report-Only só é aceito no cabeçalho HTTP. Ele informa ao navegador que deve enviar relatórios quando uma regra seria violada, mas não impede o carregamento.
Ao ativar o bloqueio, comece com uma política que não afete todo o site de uma vez. Em alguns casos, o caminho mais previsível é usar Content-Security-Policy-Report-Only para a política principal e Content-Security-Policy em subdomínios ou páginas específicas. Outra opção é adotar uma política mais permissiva no nível principal e políticas mais restritas em rotas que já estejam estáveis.
A implantação gradual reduz o impacto de erros e cria evidência técnica para tomar decisões. Se você já perdeu horas tentando resolver uma configuração sozinha, sabe como é frustrante encontrar um bloqueio desconhecido no console. O processo observável evita essa sensação de trabalhar às cegas.
Monitore os bloqueios após a ativação
A CSP deve ser acompanhada depois de entrar em produção. Atualizações de plugins, mudanças em APIs e alterações no tema podem introduzir novas origens ou scripts inline.
Monitore o console em tarefas importantes:
- Envio de formulários
- Autenticação e recuperação de senha
- Checkout e confirmação de pagamento
- Busca e filtros
- Integração de CRM ou automação de marketing
- Painel administrativo
Um relatório de violação costuma mostrar a diretiva responsável pela regra. Quando a origem aparece em uma mensagem, confirme primeiro se ela pertence a um fornecedor confiável. Depois, autorize o endereço no nível correto da política.
Evite corrigir a falha apenas abrindo permissões amplas. Uma diretiva como script-src * permite scripts de qualquer origem e reduz significativamente a proteção. Autorize o domínio exato, o subdomínio necessário ou o endpoint usado pela integração.
CSP no WordPress

Onde configurar a política
No WordPress, a CSP pode ser implementada de diferentes maneiras:
| Método | Vantagem | Atenção |
|---|---|---|
| Plugin de cabeçalhos de segurança | Permite criar e ajustar regras pela interface | A versão gratuita pode ter limitações de diretivas |
Arquivo .htaccess do Apache |
Controle direto no servidor | A sintaxe precisa estar correta e pode ser sobrescrita |
| Configuração do Nginx | Boa integração com a hospedagem | Exige acesso aos arquivos e conhecimento da configuração |
| Painel da hospedagem ou CDN | Pode aplicar uma política centralizada | É preciso conferir se o cabeçalho não é duplicado |
| Função ou plugin próprio | Adaptação às necessidades do projeto | Exige manutenção e revisão de código |
A escolha depende do servidor e do controle disponível. O mais importante é garantir que exista apenas uma fonte clara de configuração ou que as fontes converge para a mesma política.
Quando um Plugin inseriu o cabeçalho com wp_headers, o .htaccess pode gerar um segundo cabeçalho. O navegador considera as duas políticas. Por isso, a ferramenta de verificação deve ser usada depois de qualquer alteração.
Cuide de temas e Plugins que geram scripts
Temas e Plugins podem adicionar JavaScript no cabeçalho, no rodapé ou dentro do conteúdo. Elementos do construtor visual, botões de compartilhamento, formulários e integrações de analytics são fontes frequentes.
Abra o código-fonte da página e procure por scripts inline. A busca por <script ajuda a localizar os trechos, mas a presença da tag, por si só, não prova que exista uma violação. O console do navegador é a ferramenta mais confiável para identificar o que realmente foi bloqueado.
Também verifique se há scripts carregados de CDN, domínios de publicidade e plataformas de atendimento. Alguns endereços podem carregar recursos adicionais de outros domínios. O relatório de violações mostra essa cadeia de dependências, evitando aprobação de uma lista enorme sem contexto.
Cache, CDN e cookies
O cache pode preservar um cabeçalho antigo depois da alteração. Ao testar, limpe o cache do WordPress, do plugin de cache e da CDN. Depois, faça uma nova requisição com ferramenta de inspeção para verificar o cabeçalho atual.
Páginas em cache que contêm nonces exigem atenção especial. Um nonce vinculado a uma resposta antiga pode deixar de corresponder à página armazened. Em sistemas que dependem disso, o conteúdo precisa ser regenerado ou a estratégia de cache precisa ser revista por quem entende a aplicação.
Cookies também podem ter relação com a política quando scripts de terceiros dependem de SameSite, Secure e do atributo HttpOnly. A CSP não controla diretamente esses atributos, mas uma configuração inadequada pode impedir fluxos de autenticação ou pagamento.
Teste os principais caminhos do usuário
Um teste completo deve simular a jornada real. Em um e-commerce, por exemplo, o teste precisa abrir um produto, adicionar ao carrinho, informar o endereço, escolher a forma de pagamento e concluir ou cancelar a compra em ambiente de homologação.
Use o modo anônimo e, se possível, uma janela privada para verificar o comportamento de visitantes sem sessões anteriores. Observe também a página em dispositivos móveis, pois provedores de rastreamento, widgets e menus podem carregar recursos diferentes conforme o viewport e a categoria do dispositivo.
A validação deve considerar console, requisições de rede e resultado funcional. Uma requisição sem erro no console ainda pode representar uma falha de negócio, como um evento de conversão que não foi enviado.
CSP em sites WordPress, Next.js e Headless

WordPress
Em WordPress, a combinação mais comum envolve o servidor de hospedagem e um Plugin de segurança. Uma política simples para sites sem integrações complexas pode começar assim:
Content-Security-Policy: default-src 'self'; script-src 'self' 'https://exemplo.com'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self'; frame-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'
Esse exemplo é apenas ilustrativo. unsafe-inline em style-src ainda merece revisão, e URLs amplas para imagens podem ser restritas conforme os provedores realmente usados. A política de produção deve nascer dos relatórios, não de um modelo genérico.
Next.js
Em aplicações Next.js, a CSP pode ser configurada em middleware, por cabeçalhos no servidor ou em um proxy de borda, conforme a arquitetura. O ponto de atenção é a renderização. Páginas renderizadas no servidor podem receber scripts e estilos diferentes de rotas renderizadas no cliente.
O Next.js oferece recursos para gerar nonce e hashes de scripts em versões compatíveis com aneeds. A documentação da versão adotada deve orientar a implementação, porque o comportamento dos cabeçalhos e das opções de segurança evoluiu entre as releases.
Se o projeto usa next/font, as fontes podem ser servidas pelo próprio domínio, o que simplifica a política. Se depende de uma fonte externa, o domínio correspondente deve estar em font-src. Imagens remotas, chamadas de API e vídeos incorporados também exigem diretivas específicas.
Cabeça headless
Em um site headless, a interface fica em uma aplicação como Next.js e o conteúdo pode vir de WordPress ou de outro sistema. A política deve proteger a aplicação e também os domínios que fornecem conteúdo, APIs ou mídia.
É comum usar uma CDN para servir a interface e o backend em outra origem. Nesse cenário, a CSP da página precisa autorizar apenas as conexões realmente realizadas pelo navegador. Autorizar o backend inteiro em connect-src é mais simples, mas uma lista de endpoints bem definidos pode reduzir a superfície de ataque.
A separação de responsabilidades precisa ficar clara. O time de frontend controla a política entregue ao navegador, enquanto o time de backend controla as respostas da API. Mudanças em uma origem podem exigir atualização do CSP da outra.
Erros comuns e como evitá-los
Bloquear scripts inline e elementos com estilo
Quando scripts ou estilos inline começam a falhar, a causa mais provável é a ausência de hashes, nonces ou permissões específicas. Não retire a proteção de toda a política para resolver um único componente.
Identifique o script bloqueado. Se ele pertence à própria aplicação, mova o código para um arquivo ou adapte a autorização com hash ou nonce. Se pertence a um terceiro, avalie a implementação antes de liberar sua origem.
Permitir um domínio e esquecer os subdomínios
Uma política com example.com não autoriza automaticamente cdn.example.com. Os subdomínios precisam ser listados quando a origem exata não for suficiente. O ponto oposto também merece atenção: liberar *.example.com inclui qualquer subdomínio, o que pode ser mais amplo do que o necessário.
Esquecer que CSP controla conexções, não apenas páginas
A diretiva connect-src afeta chamadas feitas por JavaScript, como fetch, envio de formulários e algumas integrações. Uma API pode funcionar normalmente fora do navegador, mas sua chamada ser bloqueada dentro da página.
Ao testar, confira a URL da requisição e o tipo de recurso. Se a conexão foi recusada pela CSP, a origem precisa ser adicionada a connect-src, e não a script-src.
Confundir form-action com connect-src
O destino de um formulário HTML é controlado por form-action. A diretiva connect-src trata conexões feitas por scripts. Um formulário pode enviar dados normalmente e ainda assim ter uma chamada via fetch bloqueada, ou o contrário.
Essa distinção aparece com frequência em formulários de contato, autenticação e checkout. Verifique o mecanismo usado pelo plugin ou pela aplicação antes de alterar a política.
Aplicar a política somente no HTML
Alguns elementos relacionados à segurança podem depender de cabeçalhos complementares. A CSP controla permissões de carregamento, mas não substitui o cabeçalho Referrer-Policy, o X-Content-Type-Options, a proteção de transporte ou uma estratégia de cookies.
Como referência, o cabeçalho Strict-Transport-Security ajuda a impedir que o navegador use conexões HTTP emdomínios que já publiquem a política de transporte. A diretiva frame-ancestors, dentro da CSP, controla quais sites podem incorporate sua página em um iframe.
Testar somente a página inicial
A página inicial raramente reúne todas as condições do site. Formulários, checkout, administration e integrações podem aparecer em rotas diferentes. Uma política pode funcionar no início e falhar em outro contexto.
Monte uma lista de páginas críticas e repita o teste após cada atualização relevante. Em e-commerce, inclua páginas de produto, carrinho, pagamento e confirmation da order. Em sites com área restrita, inclua login, recuperação de senha e edição de perfil.
Checklist de segurança e manutenção
Antes de colocar a CSP em produção, confirme os itens principais:
- A política é enviada uma única vez ou todas as fontes converge para a mesma configuração
- O modo de observação foi usado para identificar as origens reais
- Cada permissão corresponde a um recurso necessário
- Scripts inline foram removidos, migrados ou autorizados com hash ou nonce
- A diretiva
object-srcestá restrita base-urieform-actionfazem parte da política- O cache não mantém cabeçalhos ou páginas desatualizados
- Formulários, login, checkout e integrações foram testados
- Os relatórios de violação chegam ao destino correto
- Existe um procedimento para revisar novas violações
- Atualizações de plugins, temas e provedores externos entraram no plano de manutenção
A CSP deve ser revisada após mudanças relevantes. Um novo plugin pode adicionar um script de um domínio que ainda não foi autorizado. Uma atualização do tema pode introduzir estilos inline. Uma plataforma de pagamento pode migrar sua página de destino.
Manter um inventário atualizado reduz o trabalho. Registre a finalidade de cada origem externa, o responsável pela integração e a data da última revisão. Quando o fornecedor descontinua um serviço, a lista de permissões pode ser enxuta com segurança.
Perguntas Frequentes (FAQ)
A CSP pode quebrar um site WordPress?
Sim. Se a política bloquear scripts de plugins, estilos inline, conexões com APIs ou domínios de pagamentos, algumas funções podem parar de funcionar. A melhor forma de evitar isso é observar as violações, corrigir as dependências e ativar o bloqueio gradualmente.
Qual é a diferença entre CSP e Report-Only?
A diretiva Content-Security-Policy bloqueia recursos que violam as regras. Já Content-Security-Policy-Report-Only apenas registra as violações e continua permitindo o carregamento. O segundo modo é útil para descobrir as permissões necessárias antes de aplicar a proteção restritiva.
É seguro usar unsafe-inline na CSP?
É possível usar, mas a permissão enfraquece a proteção contra scripts inline injetados. Se o site não precisar dela, remova. Quando necessário, prefira hashes para scripts estáticos ou nonces para scripts gerados por resposta.
Por que o mapa, o chat ou o pixel de rastreamento parou de funcionar?
Esses recursos normalmente carregam scripts, imagens, iframes ou conexões de domínios externos. A CSP pode estar bloqueando a origem ou a diretiva inadequada, como connect-src para uma requisição de rastreamento. Consulte o relatório da violação e autorize somente o serviço necessário.
Como saber se minha CSP está ativa?
Use as ferramentas de desenvolvedor do navegador, abra a aba Network, selecione uma requisição da página e procure o cabeçalho Content-Security-Policy na resposta. Também é possível usar um verificador de cabeçalhos online. Confirme no console se os recursos bloqueados geram mensagens compatíveis com a política.
Conclusão
Configurar CSP sem quebrar o site começa com observação, não com uma lista fechada de domínios. Cada regra deve corresponder a um recurso usado pela aplicação, e cada exceção deve ter uma justificativa. O modo Report-Only, os testes dos caminhos críticos e o monitoramento contínuo formam o caminho mais previsível para uma implantação segura.
No WordPress, a atenção especial vai para Plugins, temas, scripts inline, cache e gateways de pagamento. Em aplicações Next.js e arquiteturas headless, a prioridade é mapear a origem dos scripts, APIs, fontes e conteúdos incorporados. Em todos os casos, uma CSP bem mantida deve evoluir junto com o site.
Se você precisa de ajuda para colocar isso em prática, a Baita Site tem uma equipe especializada em sites, e-commerce, sistemas e inteligência artificial, com domínio total de WordPress. Fale com a gente e veja como podemos acelerar o seu projeto.
Referências consultadas
- MDN Web Docs, Content Security Policy, referência sobre diretivas,guide de migração e emplos de política.
- MDN Web Docs, Strict-Transport-Security, explicação do cabeçalho HSTS e das condições de uso.
- Google Web Fundamentals, Content Security Policy, orientação prática para criação e implantação de políticas CSP.
- OWASP Cheat Sheet, Content Security Policy, recomendações de segurança,hashes, nonces e relatório de violações.
- WordPress.org, Security, materiais oficiais sobre segurança, atualização e proteção de instalações WordPress.
Quer ajuda para colocar isso em pratica?
A Baita Site trabalha com sites, e-commerce, sistemas e IA. Quem prefere resolver com acompanhamento, sem ter que virar especialista em tudo, costuma procurar esse tipo de suporte.