Cabeçalhos de Segurança HTTP - Análise
docAnalise os cabeçalhos de segurança do seu navegador.
Cabeçalhos de segurança HTTP são instruções que o servidor envia na resposta para moldar como o navegador trata a página: quais origens são confiáveis, se o documento pode ser embutido em frame, qual informação é compartilhada no link de referência e quais recursos do navegador ficam disponíveis. Este artigo explica os cabeçalhos principais, erros comuns de configuração e como ler um relatório sem supor que a presença de um cabeçalho já garante segurança.
Como os cabeçalhos chegam até você
Toda resposta HTTP carrega uma linha de status e um conjunto de campos de cabeçalho antes do corpo do documento. Os cabeçalhos de segurança ficam nessa resposta e são avaliados pelo navegador na hora de carregar a página. Eles não substituem a correção do aplicativo, nem o tratamento de entrada no servidor: funcionam como uma camada adicional de restrição no lado do cliente.
Para inspecionar manualmente, é possível abrir as ferramentas de desenvolvedor do navegador na aba de rede e conferir os cabeçalhos da resposta principal, ou consultar a resposta com uma ferramenta de linha de comando que mostra apenas o cabeçalho. O conteúdo prático é o mesmo: nome do campo, valor e se o navegador o entendeu.
Os cabeçalhos principais e erros comuns
| Cabeçalho | Função | Erro comum de configuração |
|---|---|---|
| Strict-Transport-Security (HSTS) | Obriga conexão HTTPS no domínio, por um tempo definido | max-age curto demais para efeito real; includeSubDomains aplicado sem revisar os subdomínios; preload enviado sem condições de sustentação |
| Content-Security-Policy (CSP) | Lista origens permitidas para scripts, estilos, imagens e outros recursos | allow-all demasiado amplo, uso indevido de wildcard, nonce ou hash ausentes; política em report-only aplicada como se estivesse bloqueando |
| X-Frame-Options | Permite ou nega o embarque da página em um frame | Configurado apenas nesse campo enquanto frame-ancestors da CSP contradiz a regra |
| frame-ancestors (CSP) | Define quais origens podem embutir o documento | Regra que libera tudo por padrão, ignorando o suporte combinado com o campo antigo |
| Referrer-Policy | Controla qual URL de origem é enviada ao navegar para outro site | Política permissiva que vaza caminhos completos e parâmetros sensíveis em links externos |
| Permissions-Policy | Restringe acesso a câmera, microfone, geolocalização e outros recursos do navegador | Desativa recursos que o site precisa, ou deixa padrões abertos para capacidades não utilizadas |
| X-Content-Type-Options | Impede que o navegador adivinhe o tipo de conteúdo | Faltar no corpo principal, deixando o navegador fazer sniffing em respostas específicas |
| COOP, COEP e CORP | Isolam o documento entre origens e habilitam recursos de isolamento cross-origin | Ativar COEP sem ajustar os recursos cross-origin, quebrando a carga da página |
HSTS: semântica de max-age, subdomínios e preload
O HSTS avisa ao navegador que, da próxima vez, ele deve usar HTTPS sem perguntar. O valor max-age define por quantos segundos essa lembrança vale; um valor curto mal chega a ter efeito em revisitas. A diretriz includeSubDomains estende a regra a todos os subdomínios, o que exige que cada um deles sirva HTTPS de forma consistente. O preload registra o domínio em listas que embarcam nos navegadores; uma vez incluído, reverter é trabalhoso, e qualquer subdomínio que ainda use HTTP fica inacessível para esses clientes.
CSP: origens, nonce e modo report-only
A CSP parte de uma fonte padrão e lista origens permitidas por tipo de recurso. Scripts podem ser liberados por origem, por nonce gerado a cada resposta ou por hash do próprio script inline. Uma política bem feita restringe o que não é necessário; uma política ampla com curingas perde grande parte do valor de proteção. O modo report-only envia relatórios de violação sem bloquear nada, e serve para ajustar a regra antes da aplicação efetiva. É um erro tratar uma política em report-only como se estivesse bloqueando efetivamente os recursos.
Como ler o resultado
- Presença e nome correto — confira se o cabeçalho aparece na resposta principal e se o nome do campo está escrito conforme a especificação. Um campo digitado de forma divergente é ignorado pelo navegador.
- Valor efetivo — leia a política por tipo de recurso, não apenas o tamanho do cabeçalho. Uma CSP longa com curingas amplos protege menos que uma curta e restritiva.
- Consistência entre regras — X-Frame-Options e frame-ancestors não devem se contradizer; COEP e recursos cross-origin precisam conversar entre si.
- Avisos de política antiga — campos descontinuados ou mal suportados aparecem como parcialmente eficazes. Cruze o relatório com a prática real do navegador antes de priorizar ajustes.
Equívocos comuns
- «Ter uma CSP já torna o site seguro.» A CSP reduz superfície de execução de scripts, mas não corrige falhas de aplicação, nem validação de entrada, nem permissões de servidor.
- «HSTS com preload não tem custo.» Preload exige HTTPS sustentado em todo o domínio e subdomínios. Se um subdomínio ainda depender de HTTP, o navegador não consegue carregá-lo.
- «Cabeçalho ausente é uma falha explorável imediata.» Muitos campos são proteções secundárias. A ausência indica oportunidade de endurecimento, não por si só um comprometimento ativo.
- «Relatório de pontuação alta significa conformidade total.» A pontuação soma presença de campos. Uma política ampla pode marcar presença e oferecer pouca restrição prática.
Perguntas frequentes
Posso adicionar cabeçalhos de segurança pelo navegador?
Algumas extensões podem injetar campos em resposta, mas a autoridade da política vem do servidor. Para visitantes do site, o que vale é o cabeçalho enviado pela resposta original; ajustes locais não se propagam para outros usuários.
Onde vejo os cabeçalhos de um site que estou visitando?
Nas ferramentas de desenvolvedor, na aba de rede, selecione o documento principal e abra os detalhes de cabeçalho. Procure os campos de segurança entre os cabeçalhos de resposta, não na requisição enviada.
Qual cabeçalho devo revisar primeiro em um site próprio?
Comece por HSTS e CSP, pois definem o canal seguro e as origens confiáveis de recursos. Depois confira frame-ancestors, Referrer-Policy e o bloqueio de sniffing de conteúdo antes de ajustar políticas de isolamento mais complexas.