Kurrikulum Leson 121 van 156 · Bou die verdedigings
Bou die verdedigings

Reëls vir toegang tot berging

Waarom dit saak maak Partitioning stop spoorders, maar dit log jou ook uit van ingebedde dinge wat jy eintlik wil hê: 'n kommentaarboks, 'n video waarvoor jy betaal, 'n aanmeldknoppie. As die engine geen manier terug bied nie, skakel mense die beskerming af. Die Storage Access API is daardie weg terug, en sy reëls besluit of dit jou of 'n spoorder help. In hierdie laboratorium skryf jy daardie reëls.

Dink aan 'n bibliotiekkaart. Jy het by die bibliotiek aangemeld, so die kaart werk daar. Nou is jy by 'n vriend se huis, en hulle huisreël is dat buitekaarte nie binne werk nie. Jy kan steeds jou kaart daar gebruik as jy dit doelbewus oorhandig, die bibliotiek is een by wat jy werklik bygekom het, en die toestemming is vir hierdie huis net, vir 'n rukkie.

In die praktykewêreld is talk.example 'n kommentardiens. Sam teken in op talk.example self. Sy widget is ingebed op news.example. Met partitioning aan kry die widget op die nuuswebwerf 'n vars, leë koekie-houer, so dit wys "teenmeld om te pos" al is Sam ingeteken.

Ingebed raam (iframe): 'n bladsy wat binne 'n ander bladsy vertoon word, soos 'n venster in 'n muur. Die comments widget is 'n raam van talk.example binne news.example.

Gebruikersgebaar: 'n regte klik, tik of sleuteltoets deur die persoon, 'n oomblik gelede. Blaaiers noem dit user activation. 'n Skrip wat op sy eie hardloop kan nie een vervals nie.

Grant: die blutser se nota dat een ingebedde webwerf sy eie cookies binne een topvlak-webwerf mag gebruik tot 'n vervaldatum.

Hoe die regte API lyk

Bin die frame kan 'n script vra document.hasStorageAccess() (het ek my cookies?) en, na 'n klik, document.requestStorageAccess() (gee asseblief vir my). Die blantaser kontroleer sy reëls, kan vir die persoon 'n aanvraag wys, en antwoord dan ja of nee. Die API is beskikbaar in Safari, Firefox en Chrome (Chrome vanaf weer 119). In Chrome maak dit net saak vir mense watderdeparty cookies blokkeer, want Chrome stuur hulle steeds standaard, en die Related Website Sets funksie wat eenmaal toegang toegelaat het outomaties, is uitgefaseer (kontroleer Oktober 2026). Die les "The Storage Access API" in die vorige module het gedek hoe enjins verskil; hier bou jy die kernreëls.

Ons enreëls

Reg engines verskil in die besonderhede (prompts, tydlimiete, ekstra kontroles). Ons oefenengine gebruik vier eenvoudige reëls, wat in volgorde gekontroleer word, wat die idees wat hulle deel vasvang:

  1. As die frame se site die top-level site is, sê ja: dit het reeds sy eie storage.
  2. As daar geen gebruikersgebaar was nie, sê nee. 'n Widget mag nie stil vra terwyl die bladsy laai nie.
  3. As die persoon nog nooit die frame se webwerf direk oopgemaak het (as 'n top-vlak bladsy), sê nee. Dit keer dat 'n advertisie-frame wat jy nooit gekies het nie, toegang kry net omdat jy daarop geklik het.
  4. Sê andersom ja, en rekord 'n grant vir presies hierdie paar, (frame_site, top_site), wat GRANT_SECONDS (30 days) vanaf nou verval.

Dit is eenvoudiger om toegang later te kontroleer: dieselfde webwerf beteken ja; anders moet jy die paar in die grants opsoek en sê ja net as dit daar is en nog nie verval het nie.

Python-dele wat jy gaan gebruik

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 vra "is daar enige waarde?". Om dit eerste in 'n and te sit maak saak: as dit False is, stop Python en vergelyk nooit None met 'n getal nie, wat 'n fout sou wees.

Tyd in die oefenwêreld is 'n telling van sekondes (world.now), so "30 dae van nou af" is net now + 30 * 24 * 3600, wat die module vir jou gee as GRANT_SECONDS.

Die storie wat jou reëls moet pas

widget_story(request_fn, access_fn) speel ses stappe op die oefen AccessBrowser en gee 'n lys van (step, result)-paaie terug:

oopgemaak nie
StapMoet die widget ingeteken wees?
1. Sam maak news.example oop (ingeaan op talk.example vroeër)No: partitioned
2. Die widget vra wanneer die bladsy laai, sonder 'n klikNie: geen gebaar
3. Sam klik op "Sign in to comment"Ja: toegelaat vir hierdie paar
4. Sam maak recipes.example oop met dieselfde widgetNo: die toegekening was vir news.example net
5. AdCo se advertisieraam vra na 'n klik op die advertisieNo: Sam het nooit adco.example
6. 31 dae later, nuus.example weerNo: die toegekening het verval

Die module hou ook EXPECTED_STORY, die lys van regte antwoorde, sodat jy kan vergelyk terwyl jy werk.

A algemene wanbeleving

"Sodra 'n widget toegang kry, kan dit my oral volg." Nie met hierdie reëls nie. Die toestemming is vir een paar webwerwe. Dieselfde widget op 'n ander webwerf begin weer met 'n leë jar, en die toestemming loop uit. Daardie paar-reël is wat die API verhoed om 'n nuwe manier om te spoor te word.

In ander tale

Die widget-kant, in die JavaScript sou 'n regte kommentaar-widget loop:

// 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
});

Die enjin-kant, die toegangskontrole, in 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,
    }
}

Opsomming

  • Partisionering gee ingebedde raamwerke 'n leë jar; die Storage Access API laat 'n gewenste widget vra om sy eie cookies terug.
  • Goe reëls het 'n regte klik nodig, 'n webwerf wat die persoon regtig gebruik het, en 'n toegekening vir een paar webwerwe wat verval.
  • Die paar-reël is wat verhoed dat die API 'n opsporingsinstrument word.
  • Die API werk in Safari, Firefox en Chrome (Chrome 119), nagekies Oktober 2026.
Jou beurt

Skryf request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now) met die vier reëls in volgorde: dieselfde webwerf gee True terug; geen user_gesture gee False terug; nie visited_before gee False terug; anders stel grants[(frame_site, top_site)] = now + GRANT_SECONDS in en gee True terug. Skryf has_storage_access(grants, frame_site, top_site, now): True vir dieselfde webwerf, anders True net wanneer die paar in grants is en now is voor sy vervaldatum. Stel dan story = widget_story(request_storage_access, has_storage_access) in.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.