blog
Infraestrutura web

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.

JR · · 11 min de leitura · 3 tabelas · 7 blocos de código

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
  1. Os quatro cabeçalhos e o que cada um realmente quebra
  2. A ordem de implantação, do dia 0 ao dia 30
  3. O bloco pronto para o .htaccess
  4. Como conferir os cabeçalhos com curl -sI
  5. CSP em Report-Only, que é onde mora o risco
  6. O plano de reversão, linha por linha
  7. Padronizar em vários sites sem virar um projeto
  8. 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.

Ordem de implantação dos cabeçalhosBase seguranosniff, SAMEORIGIN, Referrer-PolicyCSP observandoReport-Only, console abertoHSTS curtomax-age reversível em minutosHSTS estendidolevantar subdomínios e certificadosEstado finalmax-age longo, CSP bloqueando
Uma coisa por vez: se algo quebra, você já sabe o que foi.

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:

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.

Reversão linha por linha quando algo quebraCopiar o .htaccess antes de editarReversão total vira uma linhaCliente relata sintoma na páginaVídeo sumiu, botão de pagar mortoConferir se o cabeçalho duplicaPlugin ou CDN publicando tambémComentar a linha responsávelVale na próxima requisiçãoRefazer em Report-Only até checkoutConsole limpo antes de bloquear
Cada diretiva em uma linha para permitir reversão cirúrgica.

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:

  1. cabecalhos-base.htaccess, com os três cabeçalhos seguros e o HSTS curto. Igual em todos os sites, sem variação.
  2. csp-modelo.htaccess, em Report-Only, com comentários indicando onde entram os domínios de terceiro de cada cliente.
  3. checar.sh, o laço de curl -sI da seção anterior, apontando para o seu sites.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:

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

  1. Documentação oficial (litespeed) — Security Headers. Consultado em 2026-09-17.
Leia também