Web e Desenvolvimento

Política de Segurança de Conteúdo (CSP): Como Verificar, Corrigir e Configurar em Seu Site

Content Security Policy (CSP): How to Check, Fix and Configure It on Your Website

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.

Illustration of the article's main concept

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.

Technical workflow illustration

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.

Ver ofertas da Cloudways

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

  1. Identifique todos os cabeçalhos CSP existentes e políticas meta.
  2. Faça backup da configuração do servidor e do CMS.
  3. Faça o inventário de scripts, estilos, frames, APIs, imagens e serviços externos.
  4. Implante uma política Report-Only primeiro.
  5. Investigue cada violação e autorize apenas comportamento confiável e necessário.
  6. Teste frontend, administração, login, checkout, formulários e integrações.
  7. Verifique cache, nonces, comportamento de CDN e cabeçalhos duplicados.
  8. 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.