Política de Segurança de Conteúdo (CSP): Como Verificar, Corrigir e Configurar em Seu Site
Aprenda como verificar, adicionar e corrigir cabeçalhos de Política de Segurança de Conteúdo no Apache, Nginx, WordPress e Joomla, com ferramentas de diagnóstico práticas e orientações de hospedagem.
Política de Segurança de Conteúdo (CSP): Como Verificar, Corrigir e Configurá-la em Seu Site
HTTPS e atualizações de software são essenciais, mas não impedem que todo script malicioso seja executado no navegador de um visitante. A Política de Segurança de Conteúdo (CSP) adiciona restrições impostas pelo navegador aos recursos que uma página pode carregar e executar. Ela ajuda a mitigar certos ataques de script entre sites (XSS), mas não substitui o escape contextual de saída, a validação de entrada ou as atualizações de dependências.
Este tutorial prático mostra como inspecionar sua política atual, encontrar sua fonte, introduzir alterações com segurança e corrigir problemas no Apache, Nginx, WordPress e Joomla.
1. Verifique sua CSP existente
Chrome ou Firefox: Abra a página, pressione F12, escolha Rede, recarregue, clique no documento HTML e inspecione Cabeçalhos de Resposta. Procure por Content-Security-Policy (aplicado) ou Content-Security-Policy-Report-Only (apenas diagnóstico). Verifique o Console por violações.
Linha de comando: Execute curl -I https://example.com/. No macOS/Linux, filtre a resposta com curl -sSI https://example.com/ | grep -i content-security-policy. Respostas HEAD podem diferir de respostas GET, portanto, use as Ferramentas do Desenvolvedor do navegador para confirmar.
Ferramentas online: SecurityHeaders.com verifica cabeçalhos de segurança; Google CSP Evaluator aponta fraquezas em uma política. Nenhuma das duas prova que todo o site está seguro.
A ausência de um cabeçalho CSP em uma resposta não estabelece que todas as páginas não tenham CSP. Inspecione também qualquer tag <meta http-equiv="Content-Security-Policy">: políticas meta têm limitações, incluindo sem suporte para frame-ancestors ou Report-Only.
2. Encontre onde a política é definida
| Ambiente | Local provável |
|---|---|
| Apache / LiteSpeed compatível | .htaccess, host virtual ou configuração do servidor |
| Nginx | Configuração server / location |
| PHP | Código da aplicação usando header() |
| WordPress | Plugin, código personalizado, proxy reverso ou host |
| Joomla | Plugin System – HTTP Headers, servidor ou proxy |
| Cloudflare | Regras de Transformação de Cabeçalho de Resposta |
| Hospedagem gerenciada | Painel de hospedagem ou configuração gerenciada pelo provedor |
Inspecione os cabeçalhos de resposta existentes antes de adicionar outro. Os navegadores aplicam várias políticas CSP de forma cumulativa; um novo cabeçalho permissivo não cancela um existente restritivo. Verifique também regras de CDN e hospedagem.
3. Adicione CSP no Apache usando .htaccess
Usando o gerenciador de arquivos do seu host ou SFTP (FileZilla/WinSCP), localize o diretório público contendo index.php, frequentemente public_html ou httpdocs. Ative arquivos ocultos para ver .htaccess. Faça o download de um backup e evite colocar regras personalizadas dentro de um bloco de reescrita gerenciado por CMS.
Se o mod_headers do Apache estiver habilitado e o host permitir essas diretivas, adicione:
<IfModule mod_headers.c>
Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>
Recarregue e verifique o cabeçalho em Rede → Cabeçalhos. Verifique o Console por violações. O Report-Only relata possíveis restrições, mas não bloqueia os recursos. Este exemplo é diagnóstico, não uma política de implantação completa.
Se um script de CDN confiável for reportado, primeiro confirme seu propósito e propriedade. Você pode adaptar a diretiva para script-src 'self' https://cdn.example.com; não adicione todos os hosts bloqueados cegamente. Listas de permissões de host são menos robustas contra XSS do que políticas bem projetadas com nonce/hash.
Após testar login, formulários, checkout, editores e outros fluxos de trabalho, você pode substituir Content-Security-Policy-Report-Only por Content-Security-Policy para aplicar sua política testada. Se o site quebrar, restaure o arquivo de backup, limpe caches de servidor/CDN e re teste. Um HTTP 500 após a edição sugere um problema de sintaxe ou permissão do servidor.

4. Configure CSP no Nginx
O Nginx ignora .htaccess. Se você administra o servidor, inspecione sua configuração ativa (frequentemente /etc/nginx/sites-available/ ou /etc/nginx/conf.d/). No bloco server relevante, use:
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Teste com sudo nginx -t, depois recarregue com sudo systemctl reload nginx. Fique atento à herança add_header e a regras em locais mais específicos. Em hospedagem gerenciada sem acesso à configuração do Nginx, use o painel do provedor ou o suporte.
5. WordPress: plugin ou pequena integração personalizada
Rota sem código: Primeiro verifique se seu host ou um plugin existente de cabeçalhos de segurança já envia CSP. Escolha um plugin mantido que suporte explicitamente CSP e, preferencialmente, Report-Only; não assuma que um plugin de segurança geral suporte qualquer um deles. Em suas configurações, ative Report-Only, comece com uma política diagnóstica conservadora, salve e teste páginas públicas e wp-admin antes da aplicação.
Rota para desenvolvedores: Crie wp-content/plugins/ceikay-csp/ceikay-csp.php:
<?php
/**
* Plugin Name: CeiKay CSP Example
* Description: CSP diagnostics on the WordPress frontend.
*/
add_action('send_headers', function () {
if (is_admin()) {
return;
}
header(
"Content-Security-Policy-Report-Only: "
. "default-src 'self'; "
. "script-src 'self'; "
. "object-src 'none'; "
. "base-uri 'self'"
);
});
Ative-o em Plugins → Plugins Instalados, então confirme o cabeçalho de resposta. Isso não substitui um CSP existente do servidor web, CDN ou outro plugin. Ele exclui deliberadamente o wp-admin e não fornece uma política aplicada completa.
Solução de problemas: Se um CAPTCHA falhar, inspecione solicitações bloqueadas script-src, frame-src e connect-src e consulte o guia de integração do provedor de CAPTCHA. Se um construtor de páginas reportar scripts inline bloqueados, verifique se há suporte para nonces ou hashes de CSP. Não adicione automaticamente 'unsafe-inline'. Para nonces por resposta, garanta que o cache de página completa não reutilize o mesmo nonce e HTML entre visitantes.
6. Joomla: use o plugin nativo HTTP Headers
Na administração do Joomla, abra System → Plugins, procure por HTTP Headers e abra System – HTTP Headers. A palavra exata do menu varia conforme a versão e o idioma do Joomla.
Ative suas opções de CSP e comece com Report-Only no site público. Comece diagnosticando uma diretiva como script-src 'self'; salve e inspecione o Console. Teste templates, construtores de páginas, editores, formulários de contato, CAPTCHAs, integrações de pagamento e recursos de mídia.
Se você vir Refused to execute inline script, identifique qual template ou extensão o gera. Prefira uma abordagem compatível com nonce ou hash quando suportado; valide se o script é legítimo antes de autorizá-lo. Teste o administrador separadamente do frontend. Se o servidor já definir CSP, reconcilie as configurações em vez de empilhar políticas conflitantes.
Consulte a documentação do Joomla HTTP Headers para as opções suportadas pela sua versão instalada.
7. Corrija a violação real, não a política inteira
| Violação | O que investigar | Correção típica |
|---|---|---|
script-src |
JavaScript externo ou inline | Verifique a fonte; use nonce/hash adequado ou fonte com escopo restrito |
style-src |
Folha de estilo ou CSS inline | Inspecione estilos gerados; use fonte aprovada ou hash/nonce compatível |
img-src |
Imagem externa ou data URL | Permita um host de imagem verificado somente se necessário |
connect-src |
fetch/XHR/WebSocket | Verifique a origem da API e adicione permissão com escopo restrito |
frame-src |
Frame de vídeo/CAPTCHA/pagamento incorporado | Siga os domínios documentados pelo provedor |
form-action |
Destino do envio de formulário | Permita a origem de envio legítima |
frame-ancestors |
Outro site incorporando sua página | Permita explicitamente as origens pai pretendidas, ou use 'none' |
Por exemplo, se uma imagem legítima em https://images.example.com/photo.webp for bloqueada por img-src 'self', altere a diretiva relevante para img-src 'self' https://images.example.com após confirmar que esse host é confiável. Não enfraqueça default-src apenas para corrigir uma imagem.

Algumas diretivas, incluindo frame-ancestors e form-action, não fazem fallback para default-src. Inclua-as explicitamente quando necessário.
8. A hospedagem afeta a configuração de CSP?
Sim—o padrão de navegador CSP continua o mesmo, mas seu controle sobre os cabeçalhos de resposta muda. Hospedagem compartilhada Apache pode expor .htaccess; Nginx gerenciado pode exigir um painel do provedor; administradores de VPS podem modificar a configuração do servidor; e CDNs podem adicionar cabeçalhos depois que o aplicativo gera a resposta.
Antes de escolher um serviço de hospedagem, pergunte: Posso definir e remover cabeçalhos CSP sem acesso root? Posso usar Report-Only? Posso inspecionar a resposta final? Cabeçalhos personalizados estão disponíveis no meu plano? O suporte pode explicar conflitos com regras de CDN ou aplicativo?
Cloudways: controles de cabeçalho HTTP em nível de hospedagem
A Cloudways documenta Web Rules → Header Rules para gerenciar cabeçalhos de resposta HTTP, incluindo CSP. Isso oferece uma alternativa em nível de hospedagem à edição de arquivos do aplicativo, sujeita aos recursos disponíveis para seu aplicativo e plano. Ela não cria automaticamente um CSP seguro; você ainda precisa testar e manter suas diretivas.
9. Proteção mais forte com CSP baseado em nonce
Um CSP rigoroso usa nonces ou hashes imprevisíveis, em vez de depender apenas de listas de permissões de domínio. Um exemplo simplificado em PHP:
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
No template HTML:
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Gere um nonce imprevisível novo para cada resposta. Mantenha o cabeçalho e o nonce do HTML consistentes, e planeje em torno de proxies reversos e caches de página completa. Com 'strict-dynamic', um script confiável pode carregar mais scripts, então faça auditoria cuidadosa em carregadores confiáveis. Esta é uma ilustração, não uma política completa pronta para uso para todos os aplicativos.
10. Lista de verificação final de implantação
- Identifique todos os cabeçalhos CSP existentes e políticas meta.
- Faça backup da configuração do servidor e do CMS.
- Faça o inventário de scripts, estilos, frames, APIs, imagens e serviços externos.
- Implante uma política Report-Only primeiro.
- Investigue cada violação e autorize apenas comportamento confiável e necessário.
- Teste frontend, administração, login, checkout, formulários e integrações.
- Verifique cache, nonces, comportamento de CDN e cabeçalhos duplicados.
- Ative a aplicação gradualmente e monitore após atualizações de software.
Conclusão
Um CSP útil não é simplesmente um cabeçalho copiado de uma lista de verificação. Inspecione sua configuração atual, encontre onde ela é definida, teste no modo Report-Only, corrija os problemas específicos de compatibilidade e somente então aplique uma política apropriada ao seu site. Administradores do WordPress e Joomla podem começar com as ferramentas do CMS; desenvolvedores podem usar Apache, Nginx ou PHP; e plataformas de hospedagem podem oferecer controles diretos de cabeçalho.
CSP reduz oportunidades de ataque, mas permanece como uma camada ao lado de codificação segura, atualizações, autenticação e monitoramento.