Storage Access 규칙
왜 중요한가 분할은 추적기를 막지만, 정말 원하는 삽입된 것들에서도 로그아웃시켜요: 댓글 상자, 돈 내고 보는 동영상, 로그인 버튼. 엔진이 돌아갈 길을 주지 않으면 사람들은 보호를 꺼요. Storage Access API가 그 돌아갈 길이고, 그 규칙이 여러분을 돕는지 추적기를 돕는지 정해요. 이 실습에서는 그 규칙을 써요.
도서관 카드를 생각해 보세요. 도서관에 가입했으니 카드는 거기서 통해요. 이제 친구 집에 있는데, 그 집 규칙은 바깥 카드는 안에서 안 통한다는 거예요. 그래도 여러분이 일부러 건네고, 정말 가입한 도서관이고, 허락이 이 집에만, 한동안이라면 거기서도 카드를 쓸 수 있어요.
연습 세계에서 talk.example은 댓글 서비스예요. Sam은 talk.example 자체에서 로그인해요. 그 위젯은 news.example에 삽입돼 있어요. 분할이 켜지면 뉴스 사이트의 위젯은 새롭고 빈 쿠키 항아리를 얻으니, Sam이 로그인해 있는데도 "글을 쓰려면 로그인하세요"를 보여 줘요.
삽입 프레임(iframe): 벽의 창문처럼 다른 페이지 안에 보이는 페이지. 댓글 위젯은 news.example 안의 talk.example 프레임이에요.
사용자 제스처: 방금 사람이 한 진짜 클릭, 탭, 키 누르기. 브라우저는 사용자 활성화라고 불러요. 혼자 도는 스크립트는 그걸 꾸며 낼 수 없어요.
허가: 삽입된 사이트 하나가 최상위 사이트 하나 안에서 만료 시간까지 자기 쿠키를 써도 된다는 브라우저의 메모.
실제 API는 이렇게 생겼어요
프레임 안에서 스크립트는 document.hasStorageAccess()(내 쿠키가 있나?)를 묻고, 클릭 뒤에 document.requestStorageAccess()(그걸 줘)를 물을 수 있어요. 브라우저는 규칙을 확인하고, 사람에게 묻는 창을 보여 줄 수도 있고, 그다음 예나 아니요로 답해요. 이 API는 Safari, Firefox, Chrome(버전 119부터)에 있어요. Chrome은 여전히 기본으로 서드파티 쿠키를 보내니 서드파티 쿠키를 막는 사람에게만 의미가 있고, 한때 접근을 자동으로 허가했던 Related Website Sets 기능은 거둬들여졌어요(2026년 10월 확인). 앞 모듈의 "Storage Access API" 레슨에서 엔진마다 어떻게 다른지 다뤘어요. 여기서는 핵심 규칙을 만들어요.
우리 엔진의 규칙
실제 엔진은 세부(묻는 창, 시간 제한, 추가 확인)가 달라요. 연습 엔진은 그들이 공유하는 생각을 담은 평범한 규칙 넷을 차례로 확인해요:
- 프레임의 사이트가 최상위 사이트이면 예라고 해요: 이미 자기 저장소가 있어요.
- 사용자 제스처가 없었으면 아니요라고 해요. 위젯이 페이지가 불러와지는 동안 조용히 물으면 안 돼요.
- 사람이 프레임의 사이트를 직접(최상위 페이지로) 연 적이 없으면 아니요라고 해요. 이러면 고른 적 없는 광고 프레임이 눌렸다는 이유만으로 접근을 얻는 걸 막아요.
- 그 밖에는 예라고 하고, 정확히 이 쌍
(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에서 여섯 단계를 실행하고 (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는 원하는 위젯이 자기 쿠키를 돌려 달라고 요청하게 해요.
- 좋은 규칙에는 진짜 클릭, 사람이 정말 쓴 사이트, 만료되는 사이트 한 쌍에 대한 허가가 필요해요.
- 쌍 규칙이 API가 추적 도구가 되는 걸 막아요.
- 이 API는 Safari, Firefox, Chrome(Chrome 119)에 있어요. 2026년 10월 확인.
규칙 넷을 차례로 써서 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의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.