# 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.

> 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.

João Rizzon · 2026-09-25 · Infraestrutura web

---

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](https://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.

```apacheconf
# 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:

- **`always`** faz 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=HTTPS`** evita 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 no `curl`, a variável `HTTPS` pode 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 o `env=HTTPS`.
- **`Referrer-Policy`** com `strict-origin-when-cross-origin` manda 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:

```bash
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:

```bash
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:

```bash
# 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):

```apacheconf
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:

```bash
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 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.

```apacheconf
# 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:

> **** Vamos ativar no servidor do seu site quatro cabeçalhos de segurança, que são instruções enviadas ao navegador junto com cada página. Eles reduzem risco de clickjacking, vazamento de endereço em links de saída e injeção de script. Junto sobe uma quinta regra, a política de conteúdo, em modo de observação: nessa fase ela não bloqueia nada, só registra o que seria bloqueado, para eu mapear os serviços externos do site (vídeo, chat, pagamento, analytics) antes de ativá-la de verdade. A ativação é feita em etapas e é reversível linha por linha. Se algo no site parar de aparecer ou de funcionar, me avise que removo a linha responsável em minutos, e nada do conteúdo do site é alterado.

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.

