Saltar para o conteúdo

Cabeçalhos HTTP

Cabeçalhos são informação extra que pedidos e respostas trocam — quem é o visitante, que tipo de conteúdo está a ser enviado, o que cachear, instruções de segurança. Muitas das definições da FortFox traduzem-se em cabeçalhos enviados ao browser.

6 min de leitura

A anatomia de um pedido HTTP

GET /sobre-nos HTTP/1.1
Host: o-meu-site.pt
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4)
Accept: text/html,application/xhtml+xml
Accept-Language: pt-PT,pt;q=0.9,en;q=0.7
Cookie: session=abc123def456

O GET /sobre-nos HTTP/1.1 é o pedido. Tudo o que vem a seguir são cabeçalhos. Cada um na sua linha, no formato Nome: valor.

Cabeçalhos de pedido (o browser → o servidor)

Os mais comuns que vais encontrar:

CabeçalhoO que diz
HostA que site o pedido é dirigido (importante quando o mesmo IP serve vários).
User-AgentIdentifica o browser e o sistema operativo.
AcceptQue formatos o browser aceita receber (text/html, image/webp…).
Accept-LanguageQue línguas o utilizador prefere.
Accept-EncodingQue compressões o browser percebe (gzip, br…).
RefererDe que página o utilizador veio (com link clicado).
CookieCookies que o site previamente pediu para o browser memorizar.
AuthorizationToken ou credenciais para autenticar o pedido (APIs).
X-Forwarded-ForIP original do visitante quando há proxies pelo meio.

Cabeçalhos de resposta (o servidor → o browser)

Os que controlam coisas importantes:

CabeçalhoO que diz
Content-TypeQue tipo de conteúdo está no corpo (text/html, application/json, image/png…).
Content-LengthTamanho do corpo em bytes.
Content-EncodingComo o corpo está comprimido (gzip, br).
Cache-ControlComo (e por quanto tempo) este conteúdo pode ser cacheado.
Set-CookiePede ao browser que memorize um cookie.
LocationPara redirecionamentos — para onde o browser deve ir.
Strict-Transport-Security"Para este site, usa SEMPRE HTTPS" (HSTS).
X-Frame-OptionsSe outros sites podem incorporar este num iframe.
X-Content-Type-Options"Não adivinhes o tipo de ficheiro — usa o que eu disse."
Referrer-PolicyQue parte da página de origem mostrar quando o utilizador clica em links externos.
Content-Security-Policy (CSP)Lista permissiva do que o browser pode carregar (scripts, imagens, fontes...).

Cabeçalhos de segurança (os que a FortFox emite)

Estes são instruções que dizes ao browser para proteger o visitante. Cobrem ataques comuns:

Strict-Transport-Security (HSTS)

"A partir de agora, nunca aceites HTTP para este site. Mesmo que eu te diga o contrário."

Impede que um atacante consiga forçar o visitante a usar uma ligação não cifrada. Uma vez que o browser viu este cabeçalho, lembra-se durante o tempo especificado (tipicamente 6 meses a 1 ano).

X-Frame-Options

"Este site não pode ser carregado dentro de um <iframe> noutro site."

Defende contra clickjacking — quando alguém embebe o teu site num iframe transparente para enganar o utilizador a clicar em coisas sem querer.

Valores comuns:

  • DENY — ninguém pode embeber.
  • SAMEORIGIN — só o próprio site.

X-Content-Type-Options: nosniff

"Não tentes adivinhar o tipo do ficheiro — usa exatamente o que eu te disse no Content-Type."

Sem isto, alguns browsers tentam "ser espertos" e adivinhar o tipo de um ficheiro com base no conteúdo, o que pode permitir que um upload disfarçado de imagem seja executado como JavaScript.

Referrer-Policy

"Quanto deves dizer ao próximo site sobre de onde o utilizador veio."

Por exemplo, strict-origin-when-cross-origin envia o domínio mas não o caminho completo, para sites externos.

Content-Security-Policy (CSP)

A mais poderosa e a mais complicada de configurar. Define uma lista do que o browser pode carregar (scripts, imagens, estilos, fontes). Impede XSS — porque mesmo que um atacante consiga injetar um <script> na página, o browser recusa-se a executá-lo se a origem não estiver na CSP.

Cabeçalhos custom (o teu servidor pode inventar)

Servidores podem enviar cabeçalhos próprios prefixados com X- (convenção legada) ou nomes inventados:

X-Powered-By: FortFox
X-Request-ID: 9c5a3e7b-1f2d-4f8a
X-Cache: HIT

São visíveis no browser (DevTools → Network → Headers) mas geralmente não afetam comportamento — servem para debug e telemetria.

Em mais detalhe técnico

Trailers (HTTP/1.1) e HEADERS frames (HTTP/2): em HTTP/2 os cabeçalhos são enviados em frames separados do corpo e comprimidos com HPACK (algoritmo específico para reduzir o overhead de repetir os mesmos cabeçalhos em pedidos consecutivos).

Pseudo-headers (HTTP/2): a primeira linha do HTTP/1.1 (GET /path HTTP/1.1) desapareceu — passa a ser representada como pseudo-cabeçalhos :method, :scheme, :authority, :path.

Vary: cabeçalho de resposta que diz à cache que outros cabeçalhos do pedido devem fazer parte da cache key. Ex: Vary: Accept-Language faz com que a cache guarde versões separadas para pt e en. Essencial para multilíngue ou A/B testing.

Conditional requests: cabeçalhos como If-None-Match (com um ETag anterior) ou If-Modified-Since permitem que o browser pergunte "mudou desde a última vez?". Se não mudou, o servidor responde 304 Not Modified (sem corpo), economizando largura de banda.

Cookies modernos: atributos Secure (só sobre HTTPS), HttpOnly (não acessível ao JavaScript), SameSite (estrito/lax/none — defesa contra CSRF). Cookies sem SameSite apropriado são bloqueados pelos browsers modernos em contextos cross-site.

WebSocket upgrade: ligações WebSocket começam como pedidos HTTP normais com cabeçalho Upgrade: websocket, depois o servidor responde 101 Switching Protocols e a partir daí a ligação muda de paradigma.

Próximos passos

  • Como funciona a web — base do request/response.
  • HTTPS e certificados — porque HSTS e CSP fazem sentido sobretudo em HTTPS.
  • (em breve) Cabeçalhos de segurança na FortFox — guia prático de configuração.

← Toda a documentação