पाठ्यक्रम 156 में से पाठ 121 · बचाव बनाएँ
बचाव बनाएँ

Storage Access नियम

यह क्यों मायने रखता है Partitioning trackers रोकता है, पर यह आपको उन embedded चीज़ों से भी logged out कर देता है जो आप सचमुच चाहते हैं: एक comments box, एक video जिसके लिए आप भुगतान करते हैं, एक sign-in button। अगर engine वापसी का कोई रास्ता न दे, तो लोग सुरक्षा बंद कर देते हैं। Storage Access API वह वापसी का रास्ता है, और उसके नियम तय करते हैं कि वह आपकी मदद करता है या एक tracker की। इस lab में आप वे नियम लिखते हैं।

एक library card की सोचें। आपने library में sign up किया, इसलिए card वहाँ काम करता है। अब आप एक दोस्त के घर पर हैं, और उनके घर का नियम है कि बाहरी cards अंदर काम नहीं करते। आप फिर भी वहाँ अपना card इस्तेमाल कर सकते हैं अगर आप उसे जानबूझकर सौंपें, library वह है जिसमें आप सचमुच शामिल हुए, और अनुमति सिर्फ़ इस घर के लिए है, कुछ समय के लिए।

अभ्यास दुनिया में talk.example एक comments सेवा है। Sam talk.example पर ही sign in करता है। उसका widget news.example पर embed है। partitioning चालू होने पर, समाचार साइट पर widget को एक नया, ख़ाली cookie jar मिलता है, इसलिए वह "sign in to post" दिखाता है भले ही Sam signed in है।

Embedded frame (iframe): एक पन्ने के अंदर दिखाया एक पन्ना, एक दीवार में एक खिड़की की तरह। comments widget news.example के अंदर talk.example का एक frame है।

User gesture: व्यक्ति का एक असली click, tap या key press, एक पल पहले। ब्राउज़र इसे user activation कहते हैं। अपने आप चलती एक script इसे नक़ली नहीं बना सकती।

Grant: ब्राउज़र का नोट कि एक embedded साइट एक top-level साइट के अंदर अपनी cookies इस्तेमाल कर सकती है, एक समाप्ति समय तक।

असली API कैसी दिखती है

frame के अंदर एक script document.hasStorageAccess() (क्या मेरे पास मेरी cookies हैं?) और, एक click के बाद, document.requestStorageAccess() (कृपया मुझे वे दो) पूछ सकती है। ब्राउज़र अपने नियम जाँचता है, व्यक्ति को एक prompt दिखा सकता है, और फिर हाँ या ना जवाब देता है। API Safari, Firefox और Chrome (Chrome में version 119 से) में आती है। Chrome में यह सिर्फ़ third-party cookies रोकने वालों के लिए मायने रखती है, क्योंकि Chrome अब भी डिफ़ॉल्ट रूप से उन्हें भेजता है, और Related Website Sets feature जो कभी अपने आप पहुँच देता था बंद हो चुका है (अक्टूबर 2026 में जाँचा)। पिछले मॉड्यूल के पाठ "The Storage Access API" ने ढका कि engines कैसे अलग हैं; यहाँ आप मूल नियम बनाते हैं।

हमारे engine के नियम

असली engines विवरणों में अलग हैं (prompts, समय सीमाएँ, अतिरिक्त जाँचें)। हमारा अभ्यास engine चार सादे नियम इस्तेमाल करता है, क्रम में जाँचे, जो उनके साझा विचार पकड़ते हैं:

  1. अगर frame की साइट top-level साइट है, तो हाँ कहें: उसके पास पहले से अपनी storage है।
  2. अगर कोई user gesture नहीं था, तो ना कहें। एक widget पन्ना load होते समय चुपचाप नहीं पूछ सकता।
  3. अगर व्यक्ति ने frame की साइट कभी सीधे (एक top-level पन्ने के रूप में) नहीं खोली, तो ना कहें। यह आपके कभी न चुने एक विज्ञापन frame को सिर्फ़ इसलिए पहुँच पाने से रोकता है कि आपने उस पर click किया।
  4. नहीं तो हाँ कहें, और ठीक इस जोड़े, (frame_site, top_site), के लिए एक grant दर्ज करें जो अब से 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 की एक संख्या से तुलना नहीं करता, जो एक error होता।

अभ्यास दुनिया में समय सेकंडों की एक गिनती है (world.now), इसलिए "अब से 30 दिन" बस now + 30 * 24 * 3600 है, जो module आपको GRANT_SECONDS के रूप में देता है।

वह कहानी जो आपके नियमों को पास करनी है

widget_story(request_fn, access_fn) अभ्यास AccessBrowser पर छह क़दम खेलता है और (step, result) जोड़ों की एक सूची लौटाता है:

क़दमक्या widget signed in होना चाहिए?
1. Sam news.example खोलता है (पहले talk.example पर signed in)नहीं: partitioned
2. widget पन्ना load होते समय पूछता है, बिना click केनहीं: कोई gesture नहीं
3. Sam "Sign in to comment" click करता हैहाँ: इस जोड़े के लिए दिया गया
4. Sam उसी widget के साथ recipes.example खोलता हैनहीं: grant सिर्फ़ news.example के लिए था
5. AdCo का विज्ञापन frame विज्ञापन पर एक click के बाद पूछता हैनहीं: Sam ने कभी adco.example नहीं खोला
6. 31 दिन बाद, फिर news.exampleनहीं: grant ख़त्म हो गया

module EXPECTED_STORY भी रखता है, सही जवाबों की सूची, ताकि आप चलते-चलते तुलना कर सकें।

एक आम ग़लतफ़हमी

"एक बार एक widget को पहुँच मिल जाए, तो वह हर जगह मेरा पीछा कर सकता है।" इन नियमों के साथ नहीं। grant साइटों के एक जोड़े के लिए है। दूसरी साइट पर वही widget फिर एक ख़ाली jar से शुरू होता है, और grant ख़त्म हो जाता है। वह जोड़ा नियम ही API को tracking का एक नया तरीका बनने से रोकता है।

दूसरी भाषाओं में

widget वाली ओर, उस JavaScript में जो एक असली comments widget चलाता:

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

engine वाली ओर, पहुँच जाँच, 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,
    }
}

सार

  • Partitioning embedded frames को एक ख़ाली jar देता है; Storage Access API एक चाहे widget को अपनी cookies वापस माँगने देती है।
  • अच्छे नियमों को एक असली click, एक ऐसी साइट जो व्यक्ति ने सचमुच इस्तेमाल की, और साइटों के एक जोड़े के लिए एक grant चाहिए जो ख़त्म हो।
  • जोड़ा नियम ही API को एक tracking औज़ार बनने से रोकता है।
  • 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) सेट करें।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।