Depolama Erişimi kuralları
Neden önemli Bölümleme takipçileri durdurur ama aslında istediğin gömülü şeylerden de seni çıkış yaptırır: bir yorum kutusu, ödeme yaptığın bir video, bir giriş butonu. Eğer motor geri dönüş yolu sunmazsa, insanlar korumayı kapatır. Storage Access API o geri dönüş yoludur ve kuralları sana mı yoksa bir takipçiye mi yardım edeceğine karar verir. Bu laboratuvarda bu kuralları yazıyorsun.
Bir kütüphane kartı düşün. Kütüphaneye kayıt oldun, bu yüzden kart orada çalışıyor. Şimdi bir arkadaşının evindesin ve onların kuralı dışarıdan gelen kartların içeride çalışmaması. Eğer sen kartı bilerek verirsen, kütüphane gerçekten üye olduğun bir yerse ve izin sadece bu ev için kısa bir süreliğine geçerliyse, kartını orada hala kullanabilirsin.
Pratik dünyada, talk.example bir yorum servisidir. Sam, talk.example üzerinde oturum açar. Widget'ı news.example içine gömülüdür. Bölümleme açıkken, haber sitesindeki widget yeni ve boş bir çerez kavanozu alır, bu yüzden Sam oturum açmış olsa bile "paylaşım için oturum aç" mesajını gösterir.
Gömülü çerçeve (iframe): başka bir sayfanın içinde gösterilen bir sayfa, tıpkı bir duvardaki pencere gibi. Yorumlar widget'ı, talk.example içindeki news.example'den bir çerçevedir.
Kullanıcı hareketi: bir an önce kişi tarafından yapılan gerçek bir tıklama, dokunma veya tuş basımı. Tarayıcılar buna kullanıcı etkinleştirme der. Kendi başına çalışan bir script bunu taklit edemez.
Grant: tarayıcının, gömülü bir sitenin bir üst düzey site içinde belirli bir süreye kadar kendi çerezlerini kullanabileceğine dair notu.
Gerçek API nasıl görünüyor
Çerçevenin içinde, bir script document.hasStorageAccess() (çerezlerim var mı?) diye sorabilir ve bir tıklamadan sonra document.requestStorageAccess() (lütfen onları bana ver) diyebilir. Tarayıcı kurallarını kontrol eder, kişiye bir istem gösterebilir ve sonra evet veya hayır cevabı verir. API Safari, Firefox ve Chrome (Chrome sürüm 119'dan beri) içinde yer alır. Chrome'da bu durum sadece üçüncü taraf çerezlerini engelleyen kişiler için geçerlidir, çünkü Chrome hala varsayılan olarak onları gönderir ve bir kez erişim verildiğinde otomatik olarak erişim sağlayan Related Website Sets özelliği emekli edildi (Ekim 2026'da kontrol edildi). Önceki modüldeki "The Storage Access API" dersi motorların nasıl farklılık gösterdiğini kapsıyordu; burada temel kuralları oluşturuyorsun.
Motorumuzun kuralları
Gerçek motorlar detaylarda (promptlar, zaman sınırları, ekstra kontroller) farklılık gösterir. Bizim pratik motor, paylaştıkları fikirleri yakalayan, sırayla kontrol edilen dört basit kural kullanır:
- Eğer çerçevenin sitesi üst düzey site ise evet de: zaten kendi depolama alanına sahip.
- Eğer kullanıcı hareketi yoksa, hayır de. Bir widget sayfa yüklenirken sessizce isteyemez.
- Eğer kişi siteyi doğrudan (üst düzey bir sayfa olarak) hiç açmadıysa hayır de. Bu, seçmediğin bir reklam çerçevenin sadece üzerine tıkladığın için erişim kazanmasını engeller.
- Aksi takdirde evet de ve tam olarak bu çift için,
(frame_site, top_site), şu andan itibarenGRANT_SECONDS(30 gün) süren bir izin kaydet.
Eri erişimi kontrol etmek daha basit: aynı site ise evet; aksi takdirde çifti grants içinde ara ve sadece orada varsa ve henüz süresi dolmadıysa evet de.
Kullanacağın Python parçaları
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 "hiç değer var mı?" diye sorar. Onu and içinde başa koymak önemlidir: eğer False ise, Python durur ve None ifadesini bir sayıyla asla karşılaştırmaz, bu da bir hata olur.
Pratik dünyadaki zaman saniye (world.now) sayısıdır, bu yüzden "şu andan itibaren 30 gün" sadece now + 30 * 24 * 3600 olur ve modül bunu sana GRANT_SECONDS olarak verir.
Kurallarının geçmesi gereken hikaye
widget_story(request_fn, access_fn), pratik AccessBrowser üzerinde altı adım oynar ve bir (step, result) çiftleri listesi döndürür:
| Adım | Widget giriş yapılmış olmalı mı? |
|---|---|
| 1. Sam news.example açıyor (daha önce talk.example üzerinde oturum açtı) | No: partitioned |
| 2. Sayfa yüklenirken widget, tıklama olmadan sorar | No: hareket yok |
| 3. Sam "Yorum yapmak için giriş yap" butonuna tıklar | Evet: bu çift için onaylandı |
| 4. Sam, recipes.example dosyasını aynı widget | ile açıyor.No: hibe sadece news.example içindi |
| 5. AdCo's advert frame, advert | üzerine tıklandıktan sonra sorulur.No: Sam asla adco.example | açmadı
| 6. 31 gün sonra, news.example tekrar | No: grant süresi doldu |
Modül aynı zamanda EXPECTED_STORY, doğru cevaplar listesini de tutar, böylece ilerlerken karşılaştırabilirsin.
Yaygın bir yanılgı
"Bir widget erişim aldığında, beni her yerde takip edebilir." Bu kurallarla olmaz. İzin sadece bir site çifti içindir. Başka bir sitedeki aynı widget tekrar boş bir kavanozla başlar ve izin biter. API'nin yeni bir takip yöntemine dönüşmesini engelleyen şey bu çift kuralıdır.
Diğer dillerde
Widget tarafı, JavaScript içinde gerçek bir yorum widget'ı şu şekilde çalışırdı:
// 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
});Motor tarafı, erişim kontrolü, Rust dilinde:
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,
}
}Özet
- Partitioning gömülü çerçevelere boş bir kavanoz verir; Storage Access API istenen bir widgetin kendi çerezlerini geri istemesine izin verir.
- İyi kurallar için gerçek bir tıklama, kişinin gerçekten kullandığı bir site ve süresi dolan bir site çifti için bir hibe gerekiyor.
- Çift kuralı, API'nin bir takip aracına dönüşmesini engelleyen şeydir.
- API, Safari, Firefox ve Chrome (Chrome 119) üzerinde çalışıyor, Ekim 2026'da kontrol edildi.
request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now)'yi sırasıyla dört kural kullanarak yaz: aynı site True döndürür; user_gesture yoksa False döndürür; visited_before değilse False döndürür; aksi takdirde grants[(frame_site, top_site)] = now + GRANT_SECONDS'yi ayarla ve True döndür. has_storage_access(grants, frame_site, top_site, now)'yi yaz: aynı site için True, aksi takdirde sadece çift grants içindeyse ve now süresi dolmadan önceyse True döndür. Sonra story = widget_story(request_storage_access, has_storage_access)'yi ayarla.
Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor
Bu alıştırma yakında açılacak
Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.
Bu tarayıcı learn.floati.life için çerezleri engelliyor, bu yüzden burada bitirdiğin dersler sırasıyla açılamıyor. Bu site için çerezlere izin ver ve sayfayı yenile.