HSTS e cabeçalhos de segurança sem quebrar o checkout
Um processo de agência em quatro janelas, com o bloco pronto para .htaccess, a conferência com curl que você já usa para gzip e o plano de reversão quando o checkout para.

Resposta curta: quatro cabeçalhos de resposta resolvem o essencial, e a ordem importa mais que os valores: X-Content-Type-Options, X-Frame-Options e Referrer-Policy primeiro, HSTS com max-age=300 antes de 31536000. A CSP entra depois, sempre em Report-Only. Tudo em .htaccess e reversível linha por linha.
Neste artigo
- Os quatro cabeçalhos e o que cada um realmente quebra
- A ordem de implantação, do dia 0 ao dia 30
- O bloco pronto para o .htaccess
- Como conferir os cabeçalhos com curl -sI
- CSP em Report-Only, que é onde mora o risco
- O plano de reversão, linha por linha
- Padronizar em vários sites sem virar um projeto
- O que este processo não resolve
Ativar cabeçalho de segurança é fácil. O difícil é ativar em trinta sites de cliente e não descobrir três semanas depois que o vídeo institucional sumiu da home de um deles, ou que o script do gateway parou de carregar no checkout de outro.
O que separa um caso do outro não é o valor das diretivas. É a ordem em que você publica, o tempo que deixa cada uma em observação e o quanto o bloco é fácil de desfazer linha por linha. O texto abaixo é o processo, o bloco de .htaccess e a conferência com curl -sI, que é a mesma que você já usa para checar gzip e cache.
Os quatro cabeçalhos e o que cada um realmente quebra
Antes de colar qualquer coisa, vale separar o que é risco real de o que é medo. Três dos quatro cabeçalhos quase nunca quebram site de conteúdo. O quarto quebra quase sempre na primeira tentativa, e por isso entra em modo de relatório.
| Cabeçalho | Valor de partida | O que ele faz | O que pode quebrar |
|---|---|---|---|
X-Content-Type-Options |
nosniff |
Impede o navegador de adivinhar o tipo de um arquivo pelo conteúdo | CSS ou JS servidos com Content-Type errado deixam de ser aplicados |
X-Frame-Options |
SAMEORIGIN |
Impede que outros domínios coloquem seu site dentro de um iframe | Preview em portal de parceiro, widget do próprio site embutido em outro domínio, algumas prévias de CMS |
Referrer-Policy |
strict-origin-when-cross-origin |
Limita o que vai no Referer ao sair do site |
Atribuição de afiliado e relatórios de origem que dependem da URL completa |
Strict-Transport-Security |
max-age=300 |
Obriga o navegador a só falar HTTPS com aquele host | Subdomínio sem certificado válido, se você usar includeSubDomains cedo demais |
Um ponto que gera confusão em quase toda equipe: X-Frame-Options não tem nada a ver com o iframe do YouTube que está na home do cliente. Ele controla quem pode enquadrar você, não o que você enquadra. Quem derruba vídeo incorporado é a CSP, com a diretiva frame-src. Por isso a CSP entra por último e em Report-Only.
O quinto candidato costuma ser X-XSS-Protection. Navegadores modernos removeram o filtro que ele controlava, e o valor 1; mode=block já causou problema próprio no passado. Se você mantém por inércia em algum site antigo, 0 é a escolha mais defensável. Não é o foco deste processo.
A ordem de implantação, do dia 0 ao dia 30
A regra é simples: só publique uma coisa por vez que possa quebrar algo diferente. Se você subir os quatro no mesmo deploy e o checkout falhar, vai gastar mais tempo descobrindo qual foi do que teria gastado fazendo em etapas.
| Janela | O que sobe | O que observar |
|---|---|---|
| Dia 0 | X-Content-Type-Options, X-Frame-Options, Referrer-Policy |
Home, página de produto, uma landing com widget externo |
| Dia 0 (paralelo) | Content-Security-Policy-Report-Only |
Console do navegador nas páginas críticas |
| Dia 1 | Strict-Transport-Security: max-age=300 |
Todo o site continua acessível, sem aviso de certificado |
| Dia 7 | max-age=86400 |
Só o host principal está sob HSTS, os subdomínios não são afetados nesta etapa. Aproveite a janela para levantar quais subdomínios existem (webmail, homologação, painel) e se todos têm certificado válido: é essa conferência que vai sustentar a decisão de includeSubDomains no Dia 30 |
| Dia 30 | max-age=31536000, e só então avaliar includeSubDomains |
Nada mais a observar, é o estado final |
| Depois do relatório limpo | CSP sai de Report-Only e vira Content-Security-Policy |
Checkout, formulário, chat, vídeo |
O HSTS é o único da lista que o navegador memoriza. Os outros três você remove do .htaccess e o efeito acaba na próxima requisição. O HSTS fica gravado no cliente pelo tempo que você declarou em max-age. Publicar max-age=31536000 no primeiro dia significa que, se o certificado do host quebrar, o navegador daquele visitante vai recusar HTTP por um ano e não vai conseguir nem receber o cabeçalho que cancelaria a política. Começar com 300 segundos é o que torna a decisão reversível em cinco minutos.
O bloco pronto para o .htaccess
A documentação da LiteSpeed descreve a publicação de cabeçalhos de segurança com a diretiva Header, tanto na configuração do servidor quanto em .htaccess (docs.litespeedtech.com/lsws/security-headers). A mesma sintaxe vale em Apache com mod_headers, o que deixa o bloco portátil entre a maioria das hospedagens compartilhadas.
Em WordPress, coloque o bloco acima da marcação # BEGIN WordPress. O que está entre # BEGIN WordPress e # END WordPress é reescrito pelo core em algumas operações, e você perde o trabalho sem aviso.
# BEGIN seguranca-cabecalhos
<IfModule mod_headers.c>
Header always set X-Content-Type-Options "nosniff"
Header always set X-Frame-Options "SAMEORIGIN"
Header always set Referrer-Policy "strict-origin-when-cross-origin"
# HSTS: comece curto. Suba para 31536000 só depois da janela de observação.
Header always set Strict-Transport-Security "max-age=300" env=HTTPS
</IfModule>
# END seguranca-cabecalhos
Três decisões dentro desse bloco que valem explicação:
alwaysfaz o cabeçalho sair também em respostas de erro. Sem ele, a página 404 ou 500 do cliente sai sem proteção, e é justamente ali que costuma aparecer conteúdo refletido.env=HTTPSevita mandar HSTS em resposta HTTP, que é o comportamento correto: o cabeçalho só deve ser considerado quando chega por conexão segura. Se depois de publicar o cabeçalho não aparecer nocurl, a variávelHTTPSpode não estar definida no seu ambiente (comum atrás de proxy ou CDN que termina o TLS). Nesse caso, garanta que todo acesso HTTP já é redirecionado para HTTPS e remova oenv=HTTPS.Referrer-Policycomstrict-origin-when-cross-originmanda a URL completa dentro do próprio site e só a origem para fora. Se o cliente vive de programa de afiliados, converse antes: pode ser que a rede dele exija o caminho completo.
Quando o cabeçalho aparece duas vezes na mesma resposta
Plugin de SSL, plugin de segurança e CDN também publicam esses cabeçalhos. Com dois Strict-Transport-Security na mesma resposta vale a regra do RFC 6797: o navegador processa apenas o primeiro e ignora os demais. Na prática, isso significa que o max-age que você acha que está valendo pode ser o do plugin ou o da CDN, e não o do seu .htaccess, tanto para mais quanto para menos. Já duas CSP diferentes se aplicam em conjunto, ou seja, vale a interseção das duas, que é sempre mais restritiva do que qualquer uma isolada. É a causa mais comum de "tirei tudo do .htaccess e continua bloqueando". Antes de investigar qualquer outra coisa, confira se o cabeçalho aparece uma vez só.
Como conferir os cabeçalhos com curl -sI
Mesma ferramenta de sempre, filtro diferente. Um comando por host:
curl -sI https://exemplo.com.br | grep -i -E 'x-frame|x-content-type|referrer-policy|strict-transport|content-security'
Para a rodada em vários sites de uma vez, guarde a lista em um arquivo e itere. O echo do host antes de cada bloco é o que torna a saída legível quando são vinte domínios:
for host in $(cat sites.txt); do
echo "== $host"
curl -sI "https://$host" | grep -i -E 'x-frame|x-content-type|referrer-policy|strict-transport|content-security'
done
Duas verificações que a maioria esquece:
# 1. O cabeçalho sai também na página de erro?
curl -sI https://exemplo.com.br/pagina-que-nao-existe | grep -i x-content-type
# 2. O HTTP redireciona para HTTPS antes de qualquer coisa?
curl -sI http://exemplo.com.br | grep -i -E '^HTTP|^location'
A segunda importa porque HSTS só faz sentido em cima de um redirecionamento que já funciona. Se http:// ainda serve conteúdo com status 200, resolva isso primeiro e deixe o HSTS para a semana seguinte.
E, se o site passa por CDN ou proxy, rode o curl também direto contra a origem, com --resolve, para saber quem está publicando o quê. Cabeçalho que aparece na borda e não na origem, ou o contrário, é a pista de que existem duas fontes de verdade.
CSP em Report-Only, que é onde mora o risco
A CSP é a única da lista capaz de derrubar o vídeo do YouTube, o chat, o pixel de remarketing e o script do gateway no mesmo deploy. Por isso ela entra com o nome Content-Security-Policy-Report-Only: o navegador avalia a política, registra as violações e não bloqueia nada.
Exemplo de partida, e isto é um exemplo, não uma política pronta para produção (os domínios de terceiro do seu cliente não são os mesmos deste texto):
Header always set Content-Security-Policy-Report-Only "default-src 'self'; img-src 'self' data: https:; style-src 'self' 'unsafe-inline'; script-src 'self' 'unsafe-inline'; frame-src https://www.youtube.com https://www.youtube-nocookie.com; object-src 'none'"
O ciclo de trabalho:
Publique e navegue pelas páginas que dão dinheiro
Home, categoria, produto, carrinho, checkout, página de contato, e qualquer landing de campanha ativa. Abra o console do navegador e leia as mensagens de violação. Cada uma diz qual diretiva foi violada e qual URL foi bloqueada. Sem um coletor de relatórios configurado, o console é o seu relatório.
Anote cada domínio de terceiro que aparecer no console
Gateway de pagamento, ferramenta de analytics, chat, mapa, fonte, player de vídeo. Vídeo incorporado quase sempre exige frame-src. Script de gateway exige script-src, e muitos gateways carregam um segundo script a partir do primeiro, que só aparece quando você chega de fato na tela de pagamento. É por isso que testar só a home não vale.
Ajuste, publique de novo e navegue de novo
Repita até o console ficar limpo em todas as páginas da lista. Em site de cliente com muitos plugins, isso leva mais de uma rodada, e é normal.
Só troque o nome do cabeçalho com o console limpo
Tire o sufixo -Report-Only. A política passa a bloquear. Mantenha a linha em Report-Only comentada logo acima, para voltar em um segundo.
Se o site do cliente tem plugin de page builder ou de A/B test, prepare-se para conviver com 'unsafe-inline' em style-src. É menos protetor do que o ideal, e ainda assim uma CSP com object-src 'none' e frame-src fechado entrega valor. Política imperfeita publicada vence política perfeita que nunca sai do rascunho.
O plano de reversão, linha por linha
Reversão boa é a que qualquer pessoa da equipe executa sem entender o problema inteiro. Por isso o bloco tem marcadores # BEGIN e # END, e por isso cada diretiva ocupa uma linha só.
Antes de editar, uma cópia:
cp .htaccess .htaccess.antes-cabecalhos
Com isso, a reversão total é uma linha. A reversão cirúrgica é comentar uma linha com # e recarregar a página. Em .htaccess não existe reload de serviço: salvou, já vale na próxima requisição.
| Sintoma relatado pelo cliente | Causa mais provável | O que fazer primeiro |
|---|---|---|
| Vídeo do YouTube sumiu, espaço em branco no lugar | CSP bloqueando frame-src |
Comentar a linha da CSP, depois acrescentar o domínio do player |
| Script do gateway não carrega, botão de pagar morto | CSP bloqueando script-src |
Comentar a CSP e refazer o teste em Report-Only até o checkout |
| Site aparece quebrado sem CSS | nosniff com Content-Type errado na folha de estilo |
Conferir o Content-Type do CSS com curl -sI, corrigir no servidor |
| Portal do parceiro não consegue mais exibir o site | X-Frame-Options: SAMEORIGIN |
Trocar por CSP com frame-ancestors listando o domínio do parceiro |
| Subdomínio dá erro de certificado e não abre de jeito nenhum | HSTS com includeSubDomains |
Remover includeSubDomains; emitir certificado válido para o subdomínio, que é o que destrava o acesso |
A última linha é o motivo do max-age curto. Remover o cabeçalho do servidor não apaga o que o navegador já gravou. Com max-age=300, o problema se resolve sozinho em cinco minutos.
Com max-age=31536000, existe sim um caminho pelo servidor, e ele é a forma padrão de revogar HSTS: publique Strict-Transport-Security: max-age=0 e mantenha o host respondendo normalmente por HTTPS. Todo navegador que voltar ao site recebe o novo valor e apaga a política gravada. A limpeza é gradual, acontece na próxima visita de cada pessoa, e não vale para quem não voltar.
O caso sem remédio pelo servidor é outro: quando o certificado do host (ou de um subdomínio alcançado por includeSubDomains) está quebrado, o navegador aborta a conexão TLS antes de ler qualquer cabeçalho, e o max-age=0 nunca chega. Aí a ordem é corrigir o certificado. Se isso não for possível no prazo, a única saída para quem já está travado é limpar a política manualmente no navegador, o que você não vai conseguir pedir para a base inteira do cliente.
A lista de precarga (preload) segue a mesma lógica, elevada. Entrar é rápido, sair é lento e depende de atualização de navegador. Só inscreva domínio de cliente em preload quando o HSTS já estiver estável há meses, todo subdomínio tiver certificado válido e o cliente souber o que está assinando.
Padronizar em vários sites sem virar um projeto
O que torna isso viável em escala de agência não é automação sofisticada. São três arquivos versionados no seu repositório interno:
cabecalhos-base.htaccess, com os três cabeçalhos seguros e o HSTS curto. Igual em todos os sites, sem variação.csp-modelo.htaccess, em Report-Only, com comentários indicando onde entram os domínios de terceiro de cada cliente.checar.sh, o laço decurl -sIda seção anterior, apontando para o seusites.txt.
O fluxo por site vira: copiar o base, rodar o checar.sh, agendar a subida do max-age no calendário, e só então abrir o trabalho de CSP, que é o único que exige conhecer o site. Os três cabeçalhos seguros podem ir para a carteira inteira na mesma semana. A CSP vai por cliente, começando pelos que não têm checkout.
Um detalhe operacional: coloque a data no comentário do bloco.
# BEGIN seguranca-cabecalhos (base v1, HSTS curto desde 2026-03-02)
Daqui a seis meses, quando outra pessoa abrir o .htaccess desse cliente, ela vai saber se o max-age já podia ter subido ou se ainda está na janela de observação. É o tipo de informação que ninguém lembra e que custa meia hora de investigação para recuperar.
A frase para mandar ao cliente antes da primeira janela
Use antes da primeira janela, não depois de alguém reclamar:
Funciona porque nomeia o risco, promete reversibilidade e deixa claro o que o cliente deve reportar. Cliente que sabe o que observar encontra o problema no primeiro dia, não no fechamento do mês.
O que este processo não resolve
Cabeçalho de resposta é camada de mitigação, não correção. Ele reduz o estrago de uma falha que já existe, e não substitui:
- WordPress, tema e plugin atualizados.
- Senha forte e segundo fator no painel e no administrador do site.
- Backup testado, com restauração já ensaiada pelo menos uma vez.
- Revisão de permissão de arquivo e de usuário com acesso de administrador.
Se o site de um cliente está com plugin abandonado há três anos, publicar CSP não compra segurança: compra a sensação dela. Priorize a atualização. O bloco de cabeçalhos leva quinze minutos e continua valendo depois, como segunda camada.
E existe um limite honesto na verificação por curl: ela prova que o cabeçalho saiu. Não prova que a política está correta, nem que o site inteiro funciona sob ela. Essa parte só a navegação real nas páginas críticas resolve, com o console aberto. Não existe atalho para isso, e é exatamente por isso que a CSP entra por último.
Referências
- Documentação oficial (litespeed) — Security Headers. Consultado em 2026-09-17.