Conteúdo do curso Lição 121 de 156 · Construa as defesas
Construa as defesas

Regras de Storage Access

Por que isso importa O particionamento para os rastreadores, mas também desconecta você de coisas incorporadas que você realmente quer: uma caixa de comentários, um vídeo que você paga, um botão de login. Se o motor não oferece um caminho de volta, as pessoas desligam a proteção. A Storage Access API é esse caminho de volta, e as regras dela decidem se ela ajuda você ou ajuda um rastreador. Neste laboratório você escreve essas regras.

Pense num cartão de biblioteca. Você se inscreveu na biblioteca, então o cartão funciona lá. Agora você está na casa de um amigo, e a regra da casa é que cartões de fora não valem lá dentro. Você ainda pode usar o seu cartão ali se você o entregar de propósito, se a biblioteca for uma em que você realmente se inscreveu, e se a permissão for só para esta casa, por um tempo.

No mundo de prática, talk.example é um serviço de comentários. Sam entra no próprio talk.example. O widget dele está incorporado em news.example. Com o particionamento ligado, o widget no site de notícias recebe um pote de cookies novo e vazio, então mostra "entre para comentar" mesmo com Sam conectado.

Quadro incorporado (iframe): uma página mostrada dentro de outra página, como uma janela numa parede. O widget de comentários é um quadro de talk.example dentro de news.example.

Gesto do usuário: um clique, toque ou tecla de verdade feito pela pessoa, há pouco. Os navegadores chamam isso de ativação do usuário. Um script rodando sozinho não consegue falsificar um.

Concessão: a anotação do navegador de que um site incorporado pode usar os próprios cookies dentro de um site de nível superior, até um horário de validade.

Como é a API real

Dentro do quadro, um script pode perguntar document.hasStorageAccess() (eu tenho os meus cookies?) e, depois de um clique, document.requestStorageAccess() (por favor, me dê os meus cookies). O navegador confere as regras dele, pode mostrar um aviso à pessoa e então responde sim ou não. A API existe no Safari, no Firefox e no Chrome (no Chrome desde a versão 119). No Chrome ela só importa para quem bloqueia cookies de terceiros, porque o Chrome ainda os envia por padrão, e o recurso Related Website Sets, que antes concedia acesso automaticamente, foi aposentado (verificado em outubro de 2026). A lição "A Storage Access API" do módulo anterior mostrou como os motores diferem; aqui você constrói as regras centrais.

As regras do nosso motor

Os motores reais diferem nos detalhes (avisos, limites de tempo, verificações extras). Nosso motor de prática usa quatro regras simples, verificadas em ordem, que capturam as ideias que eles compartilham:

  1. Se o site do quadro é o site de nível superior, diga sim: ele já tem o próprio armazenamento.
  2. Se não houve gesto do usuário, diga não. Um widget não pode pedir em silêncio enquanto a página carrega.
  3. Se a pessoa nunca abriu o site do quadro diretamente (como página de nível superior), diga não. Isso impede que um quadro de anúncio que você nunca escolheu ganhe acesso só porque você clicou nele.
  4. Senão, diga sim e registre uma concessão exatamente para este par, (frame_site, top_site), que expira GRANT_SECONDS (30 dias) a partir de agora.

Verificar o acesso depois é mais simples: mesmo site significa sim; senão, procure o par nas concessões e diga sim só se ele estiver lá e ainda não tiver expirado.

Peças de Python que você vai usar

grants = {}                                     # an empty dict
grants[("talk.example", "news.example")] = 5000 # key is a tuple, value an expiry time
expiry = grants.get(("talk.example", "blog.example"))
print(expiry)                                   # None: .get gives None when the key is missing
print(expiry is not None and 4000 < 5000)       # False, because expiry is None

x is not None pergunta "existe algum valor?". Colocá-lo primeiro num and importa: se for False, o Python para e nunca compara None com um número, o que seria um erro.

O tempo no mundo de prática é uma contagem de segundos (world.now), então "daqui a 30 dias" é só now + 30 * 24 * 3600, que o módulo dá a você como GRANT_SECONDS.

A história em que as suas regras precisam passar

widget_story(request_fn, access_fn) executa seis passos no AccessBrowser de prática e retorna uma lista de pares (step, result):

PassoO widget deveria estar conectado?
1. Sam abre news.example (conectado em talk.example antes)Não: particionado
2. O widget pede enquanto a página carrega, sem cliqueNão: sem gesto
3. Sam clica em "Entre para comentar"Sim: concedido para este par
4. Sam abre recipes.example com o mesmo widgetNão: a concessão era só para news.example
5. O quadro de anúncio da AdCo pede depois de um clique no anúncioNão: Sam nunca abriu adco.example
6. 31 dias depois, news.example de novoNão: a concessão expirou

O módulo também guarda EXPECTED_STORY, a lista das respostas certas, para você comparar enquanto avança.

Um equívoco comum

"Depois que um widget ganha acesso, ele pode me seguir para todo lado." Não com estas regras. A concessão é para um par de sites. O mesmo widget em outro site começa de novo com um pote vazio, e a concessão acaba. Essa regra do par é o que impede a API de virar um novo jeito de rastrear.

Em outras linguagens

O lado do widget, no JavaScript que um widget de comentários real rodaria:

// Inside the talk.example frame, on news.example
signInButton.addEventListener("click", async () => {      // a real click: a user gesture
  if (!(await document.hasStorageAccess())) {
    try {
      await document.requestStorageAccess();                // the browser applies its rules
    } catch {
      showMessage("Open talk.example to sign in first");   // refused
      return;
    }
  }
  loadComments();   // requests now carry talk.example's own cookie
});

O lado do motor, a verificação de acesso, em Rust:

use std::collections::HashMap;
fn has_storage_access(grants: &HashMap<(String, String), u64>,
                      frame_site: &str, top_site: &str, now: u64) -> bool {
    if frame_site == top_site { return true; }
    match grants.get(&(frame_site.to_string(), top_site.to_string())) {
        Some(expiry) => now < *expiry,
        None => false,
    }
}

Resumo

  • O particionamento dá aos quadros incorporados um pote vazio; a Storage Access API deixa um widget desejado pedir os próprios cookies de volta.
  • Boas regras exigem um clique de verdade, um site que a pessoa realmente usou e uma concessão para um par de sites que expira.
  • A regra do par é o que impede a API de virar uma ferramenta de rastreamento.
  • A API existe no Safari, no Firefox e no Chrome (Chrome 119), verificado em outubro de 2026.
Sua vez

Escreva request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now) usando as quatro regras em ordem: mesmo site retorna True; sem user_gesture retorna False; sem visited_before retorna False; senão defina grants[(frame_site, top_site)] = now + GRANT_SECONDS e retorne True. Escreva has_storage_access(grants, frame_site, top_site, now): True para o mesmo site; senão, True só quando o par está em grants e now é anterior à validade. Depois defina story = widget_story(request_storage_access, has_storage_access).

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.