Conteúdo do curso Lição 35 de 156 · HTTP por dentro
HTTP por dentro

Interpretar Cookie e Set-Cookie

Por que isso importa Os cookies são o ID de rastreamento que você consegue de fato ver. Ler uma linha Set-Cookie direito diz por quanto tempo um site quer lembrar de você, se os scripts conseguem ler o cookie e se ele pode seguir você até outros sites. Acertar as pequenas regras também é o que mantém os logins seguros.

De volta ao guarda-volumes. Set-Cookie é o atendente te entregando uma ficha, com letras miúdas no verso: "válida por um ano", "mostre só no balcão principal", "não mostre a outros estabelecimentos". Cookie é você devolvendo de uma vez todas as suas fichas daquele balcão, sem as letras miúdas.

Set-Cookie: um cabeçalho de resposta que pede ao navegador para guardar um cookie. Um cabeçalho por cookie: Set-Cookie: sid=7f3a; Path=/; Secure; HttpOnly; SameSite=Lax.

Cabeçalho Cookie: um cabeçalho de requisição que leva todos os cookies que o navegador escolheu enviar, como pares name=value juntados por ; , por exemplo Cookie: sid=7f3a; theme=dark. Só os nomes e os valores viajam, nunca os atributos.

Atributo: um pedaço das letras miúdas depois do primeiro ; em Set-Cookie. Alguns têm valor (Max-Age=3600), outros são marcadores que simplesmente estão presentes (Secure).

Os atributos que você vai interpretar

  • Expires=Thu, 01 Oct 2026 00:00:00 GMT: esqueça o cookie nesta data. Guarde o texto por enquanto; o pote de cookies vai transformá-lo num horário.
  • Max-Age=3600: esqueça-o depois deste número de segundos. Zero ou negativo significa apagar agora. Se os dois estiverem presentes, Max-Age vence.
  • Domain=shopa.example: envie também para os subdomínios. Um ponto no começo (.shopa.example) é ignorado, e os nomes são comparados em minúsculas.
  • Path=/account: envie só para endereços abaixo deste caminho. Um valor que não começa com / é ignorado.
  • Secure: só por HTTPS. HttpOnly: os scripts da página não conseguem lê-lo.
  • SameSite=Strict, Lax ou None: se ele vai junto em requisições vindas de outros sites. Qualquer outro valor conta como não informado.
  • Partitioned: mantenha uma cópia separada para cada site de nível superior (CHIPS, da Etapa 1).

As partes delicadas

Os navegadores são tolerantes de propósito, e o seu parser também deve ser. Os nomes de atributo ignoram maiúsculas, então secure e SECURE contam os dois. Espaços em volta de = e ; são permitidos. Um atributo que o navegador não conhece (Priority=High, ou um erro de digitação) é pulado, não é erro. Os valores podem conter =, como em token=a=b, então divida só no primeiro =.

Algumas linhas são ignoradas por completo: uma primeira parte sem nenhum =, ou com nome vazio. As regras atuais de cookies, draft-ietf-httpbis-rfc6265bis (aprovado como padrão e aguardando o número de RFC, verificado em outubro de 2026), permitem alguns cookies incomuns sem nome; o nosso navegador de prática simplifica e os ignora, e você vai fazer o mesmo.

parse_set_cookie("id=7f3a; Max-Age=600; domain=.ShopA.example; Path=/; secure; SameSite=lax")
# {"name": "id", "value": "7f3a", "expires": None, "max_age": 600,
#  "domain": "shopa.example", "path": "/", "secure": True, "httponly": False,
#  "samesite": "Lax", "partitioned": False}

Um equívoco comum

"O cabeçalho Cookie diz ao servidor quando o meu cookie expira." Não diz. O navegador guarda todas as letras miúdas para si e envia só name=value. Um servidor que quer saber quanto tempo um cookie dura precisa lembrar do que definiu.

Experimente No DevTools, abra Application (Chrome, Edge) ou Storage (Firefox), depois Cookies, e escolha um site. Cada linha é um Set-Cookie interpretado: compare as colunas Expires, Domain, Path, Secure, HttpOnly, SameSite e Partitioned com os campos que o seu parser retorna.

Em outras linguagens

JavaScript:

function parseSetCookie(line) {
  const [first, ...attrs] = line.split(";");
  const i = first.indexOf("=");
  if (i < 0 || !first.slice(0, i).trim()) return null;
  const c = { name: first.slice(0, i).trim(), value: first.slice(i + 1).trim() };
  for (const a of attrs) {
    const j = a.indexOf("=");
    const key = (j < 0 ? a : a.slice(0, j)).trim().toLowerCase();
    const val = j < 0 ? "" : a.slice(j + 1).trim();
    if (key === "secure") c.secure = true;
    else if (key === "max-age" && /^-?\d+$/.test(val)) c.maxAge = Number(val);
    // ... and the rest, as in Python
  }
  return c;
}

Go:

// Go parses both for you: http.ParseSetCookie (Go 1.23+) and http.ParseCookie
c, err := http.ParseSetCookie("id=7f3a; Max-Age=600; Secure; SameSite=Lax")
if err == nil {
    fmt.Println(c.Name, c.Value, c.MaxAge, c.Secure, c.SameSite)
}

PHP:

// a server sets a cookie with every attribute named:
setcookie('sid', $id, ['expires' => time() + 3600, 'path' => '/',
    'secure' => true, 'httponly' => true, 'samesite' => 'Lax']);

Resumo

  • Set-Cookie leva um cookie mais os seus atributos; o cabeçalho Cookie leva só pares name=value.
  • Divida no primeiro =, compare os nomes de atributo em minúsculas e pule o que você não reconhece.
  • Max-Age deve ser um número inteiro, Path deve começar com /, e um ponto no começo de Domain é ignorado.
  • Uma linha sem = ou sem nome é ignorada por inteiro.
Sua vez

Escreva parse_cookie_header(text): o valor Cookie da requisição como um dict (divida em ;, depois no primeiro =, tire os espaços dos dois, pule pedaços sem = ou sem nome, o primeiro valor de um nome vence). Escreva parse_set_cookie(line): um dict com as chaves name, value, expires (o texto bruto ou None), max_age (um int quando o valor tem só dígitos ASCII com no máximo um - no começo, como os navegadores exigem; qualquer outra coisa, como +5, 1_000 ou --5, é ignorada e dá None), domain (em minúsculas, sem o ponto no começo, ou None), path (só se começar com /), secure, httponly, partitioned (booleanos) e samesite ("Strict", "Lax", "None" ou None), ou None para uma linha sem = ou com nome vazio.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.