Storage Access の規則
なぜ大切か 分離はトラッカーを止めますが、本当に欲しい埋め込みのもの、つまりコメント欄、お金を払った動画、サインインのボタンからもログアウトさせてしまいます。エンジンが戻る道を用意しなければ、人は守りをオフにします。Storage Access API がその戻る道で、その規則が、それがあなたを助けるのかトラッカーを助けるのかを決めます。このラボでは、その規則を書きます。
図書館のカードを考えてください。図書館で登録したので、カードはそこで使えます。今、友だちの家にいて、その家のルールでは外のカードは家の中では使えません。それでも、あなた がわざと渡し、その図書館が本当に入会したもので、許可がこの家だけ、しばらくの間なら、そこでカードを使えます。
練習用の世界では、talk.example はコメントのサービスです。Sam は talk.example そのものでサインインします。そのウィジェットは news.example に埋め込まれています。分離がオンだと、ニュースサイトの上のウィジェットは新しい空の Cookie の入れ物を得るので、Sam がサインインしていても「投稿するにはサインイン」と表示します。
埋め込みのフレーム(iframe):壁の窓のように、別のページの中に表示されたページです。コメントのウィジェットは、news.example の中の talk.example のフレームです。
ユーザーの操作:今しがた、その人がした本物のクリック、タップ、キーの押下です。ブラウザはそれを ユーザーアクティベーション と呼びます。自分で動いているスクリプトはそれを偽れません。
許可:ひとつの埋め込みのサイトが、ひとつのトップレベルのサイトの中で、期限まで自分の Cookie を使ってよいという、ブラウザのメモです。
本物の API の見た目
フレームの中で、スクリプトは document.hasStorageAccess()(自分の Cookie はある?)を尋ねられ、クリックの後で document.requestStorageAccess()(どうか私の Cookie をください)を尋ねられます。ブラウザは規則を確かめ、その人に確認を表示するかもしれず、それからはいかいいえで答えます。この API は Safari、Firefox、Chrome(Chrome はバージョン 119 から)に入っています。Chrome は今も既定でサードパーティ Cookie を送るので、そこではサードパーティ Cookie をブロックする人にとってだけ意味があり、かつて自動でアクセスを与えていた Related Website Sets の機能は取りやめられました(2026 年 10 月確認)。前のモジュールの「Storage Access API」のレッスンで、エンジンの違いを扱いました。ここでは中核の規則を作ります。
このエンジンの規則
本物のエンジンは細部(確認、時間の上限、追加の確認)で違います。練習用のエンジンは、それらに共通する考え方をとらえた、順に確かめる 4 つのただの規則を使います:
- フレームのサイトがトップレベルのサイトなら、はいと言う。それはすでに自分のストレージを持っています。
- ユーザーの操作がなければ、いいえと言う。ウィジェットは、ページが読み込まれる間に黙って尋ねてはいけません。
- その人がフレームのサイトを一度も直接(トップレベルのページとして)開いたことがなければ、いいえと言う。これで、選んだこともない広告のフレームが、クリックしたというだけでアクセスを得るのを止めます。
- それ以外は、はいと言い、ちょうどこの組
(frame_site, top_site)について、今からGRANT_SECONDS(30 日)で期限切れになる許可を記録する。
後でアクセスを確かめるのはもっと単純です。同じサイトならはい、そうでなければ許可の中で組を探し、それがあってまだ期限切れでないときだけはいと言います。
使う 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 Nonex is not None は「そもそも値があるか?」を尋ねます。それを and の最初に置くのが大事です。それが False なら Python はそこで止まり、None を数と比べることは決してしません。そうすればエラーになるからです。
練習用の世界の時刻は秒の数(world.now)なので、「今から 30 日」はただの now + 30 * 24 * 3600 で、モジュールはそれを GRANT_SECONDS として用意しています。
規則が合格しなければならない物語
widget_story(request_fn, access_fn) は、練習用の AccessBrowser で 6 つの手順を演じ、(step, result) の組のリストを返します:
| 手順 | ウィジェットはサインインしているべきか? |
|---|---|
| 1. Sam が news.example を開く(前に talk.example でサインイン済み) | いいえ:分離されている |
| 2. ページが読み込まれる間に、ウィジェットがクリックなしで尋ねる | いいえ:操作がない |
| 3. Sam が「コメントするにはサインイン」をクリックする | はい:この組について許可された |
| 4. Sam が同じウィジェットのある recipes.example を開く | いいえ:許可は news.example だけのもの |
| 5. 広告のクリックの後で、AdCo の広告のフレームが尋ねる | いいえ:Sam は一度も adco.example を開いていない |
| 6. 31 日後、また news.example | いいえ:許可が期限切れ |
モジュールは正しい答えのリスト EXPECTED_STORY も保っているので、進みながら比べられます。
よくある誤解
「ウィジェットがいったんアクセスを得たら、どこでも私を追える」。この規則ではそうなりません。許可はひとつのサイトの組についてです。ほかのサイトの同じウィジェットは、また空の入れ物から始まり、許可は期限切れになります。その組の規則こそが、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 で、望まれたウィジェットは自分の Cookie を返してほしいと頼めます。
- 良い規則には、本物のクリック、その人が本当に使ったサイト、そして期限切れになる、ひとつのサイトの組についての許可が必要です。
- 組の規則こそが、API が追跡の道具になるのを止めます。
- この API は Safari、Firefox、Chrome(Chrome 119)に入っています(2026 年 10 月確認)。
4 つの規則を順に使って 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、そうでなければ組が grants にあり、now がその期限より前のときだけ True。それから story = widget_story(request_storage_access, has_storage_access) とします。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。