Программа курса Урок 121 из 156 · Построй защиту
Построй защиту

Правила доступа к хранилищу

Почему это важно Разделение блокирует трекеры, но оно также разлогинивает вас в встроенных вещах, которые вам действительно нужны: поле для комментариев, видео, за которое вы платите, кнопка входа. Если движок не предлагает пути назад, люди отключают защиту. Storage Access API это тот самый путь назад, и его правила решают, помогает ли он вам или трекеру. В этой лабораторной работе вы пишете эти правила.

Представьте библиотечную карту. Вы зарегистрировался в библиотеке, поэтому карта работает там. Теперь вы в доме друга, и правило этого дома такое: внешние карты внутри не работают. Вы все еще можете использовать свою карту там, если вы специально передашь ее, библиотека та, в которой вы действительно записан, а разрешение дано только для этого дома на какое-то время.

В реальном мире, talk.example - это сервис комментариев. Сэм входит в систему на самом talk.example. Его виджет встроен на news.example. При включенном разделении виджет на новостном сайте получает новую пустую корзину cookie, поэтому он показывает "войдите, чтобы опубликовать", хотя Сэм вошел в систему.

Встроенный фрейм (iframe): страница, показанная внутри другой страницы, как окно в стене. Виджет комментариев это фрейм из talk.example внутри news.example.

Жест пользователя: настоящий клик, касание или нажатие клавиши человеком, произошедшее мгновение назад. Браузеры называют это активация пользователя. Скрипт, работающий самостоятельно, не может это имитировать.

Grant: заметка браузера о том, что один встроенный сайт может использовать свои собственные cookies внутри одного основного сайта до времени истечения.

Как выглядит настоящий API

Внутри фрейма скрипт может спросить document.hasStorageAccess() (есть ли у меня куки?) и, после клика, document.requestStorageAccess() (пожалуйста, дайте их мне). Браузер проверяет свои правила, может показать пользователю запрос, а затем отвечает да или нет. API поставляется в Safari, Firefox и Chrome (Chrome начиная с версии 119). В Chrome это важно только для людей, которые блокируют сторонние куки, потому что Chrome все еще отправляет их по умолчанию, а функция Related Website Sets, которая раньше автоматически давала доступ, была удалена (проверено в октябре 2026). Урок "The Storage Access API" в предыдущем модуле охватывал различия движков; здесь вы строите основные правила.

Правила нашего движка

Настоящие движки отличаются деталями (промпты, лимиты времени, дополнительные проверки). Наш учебный движок использует четыре простых правила, проверяемых по порядку, которые отражают общие идеи:

  1. Если site фрейма это top-level site, ответьте да: у него уже есть свое хранилище.
  2. Если не было жеста пользователя, скажите нет. Виджет не может запрашивать что-то молча при загрузке страницы.
  3. Если человек никогда не открывал сайт фрейма напрямую (как страницу верхнего уровня), скажите нет. Это не дает рекламному фрейму, который вы не выбирали, получить доступ только потому, что вы на него нажали.
  4. Иначе скажите да и запишите грант именно для этой пары, (frame_site, top_site), который истекает через GRANT_SECONDS (30 дней) с этого момента.

Проверка доступа позже проще: одинаковый сайт означает да; иначе ищите пару в grants и говорите да только если она там есть и еще не истекла.

Части Python, которые вы будете использовать

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 спрашивает "есть ли значение вообще?". Постановка его первым в and важна: если оно False, Python останавливается и никогда не сравнивает None с числом, что было бы ошибкой.

Время в практическом мире это количество секунд (world.now), поэтому "30 дней от текущего момента" это просто now + 30 * 24 * 3600, которое модуль дает вам как GRANT_SECONDS.

История, которую должны пройти ваши правила

widget_story(request_fn, access_fn) выполняет шесть шагов на практике AccessBrowser и возвращает список пар (step, result):

ШагДолжен ли виджет быть авторизован?
1. Сэм открывает news.example (авторизован на talk.example ранее)No: partitioned
2. Виджет запрашивает данные при загрузке страницы без кликаНет: нет жеста
3. Сэм нажимает "Sign in to comment"Да: разрешено для этой пары
4. Сэм открывает recipes.example с тем же widgetNo: грант был только для news.example
5. Рекламный кадр AdCo появляется после клика по рекламеNo: Sam никогда не открывал adco.example
6. Через 31 день, новости.example сноваNo: грант истек

Модуль также хранит EXPECTED_STORY, список правильных ответов, чтобы вы могли сравнивать в процессе.

A распространенное заблуждение

"Как только виджет получает доступ, он может следить за мной везде." Не с этими правилами. Грант предназначен для одной пары сайтов. Тот же виджет на другом сайте снова начинает с пустой банки, и грант заканчивается. Это правило пары не дает API стать новым способом слежки.

В других языках

Сторона виджета, в JavaScript реальный виджет комментариев работал бы так:

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

Сторона движка, проверка доступа на 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,
    }
}

Итог

  • Разделение дает встроенным фреймам пустую банку; Storage Access API позволяет нужному виджету запросить свои собственные куки обратно.
  • Хорошие правила требуют реального клика, сайта, который человек действительно использовал, и гранта для одной пары сайтов, который истекает.
  • Правило пары это то, что не дает API превратиться в инструмент слежки.
  • API доступен в Safari, Firefox и Chrome (Chrome 119), проверено в октябре 2026 года.
Твоя очередь

Напишите request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now), используя четыре правила по порядку: тот же сайт возвращает True; нет user_gesture возвращает False; не visited_before возвращает False; иначе установите grants[(frame_site, top_site)] = now + GRANT_SECONDS и верните True. Напишите has_storage_access(grants, frame_site, top_site, now): True для того же сайта, иначе True только когда пара в grants и now до истечения срока. Затем установите story = widget_story(request_storage_access, has_storage_access).

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.