서드파티 쿠키의 황혼기, 크로스사이트 iframe 내에서 기존 세션과 스토리지를 합법적이고 안전하게 유지하는 웹 표준 API를 깊이 파헤칩니다.
과거의 웹 생태계에서는 부모 창(https://parent.com)에 임베드된 서드파티 iframe(https://widget.com)이 자유롭게 자신의 쿠키(Cookie)와 LocalStorage에 접근할 수 있었습니다. 이를 통해 단일 로그인(SSO) 상태 유지, 임베드형 댓글 시스템, 챗봇, 결제 모듈 등이 원활하게 작동했습니다.
그러나 사용자의 웹 방문 이력을 무단으로 추적하는 크로스사이트 트래킹(Cross-site Tracking) 문제가 심각해짐에 따라 주요 브라우저 엔진들은 강력한 개인정보 보호 정책을 도입하기 시작했습니다.
이로 인해 정상적인 비즈니스 목적으로 상호작용하는 임베드 위젯조차 세션 쿠키를 읽지 못해 **“로그인을 했는데도 iframe 안에서는 로그인 상태가 해제되는 현상”**이 발생하게 되었습니다. 이러한 문제를 해결하기 위해 등장한 브라우저 표준이 바로 Storage Access API입니다.
Storage Access API는 크로스사이트(Cross-site) 텍스트 context 내부(주로 iframe)에 위치한 문서가, 브라우저에 의해 차단되거나 격리된 최상위(Unpartitioned) 스토리지 영역에 대한 접근 권한을 명시적으로 요청하고 획득할 수 있도록 지원하는 W3C 표준 Web API입니다.
이 API를 활용하면 추적 방지 메커니즘을 우회하는 편법(예: 팝업 릴레이, 리다이렉트 트릭)을 사용하지 않고도, 사용자의 명시적 승인(User Gesture) 기반 하에 임베드된 사이트의 퍼스트파티 스토리지와 세션을 복원할 수 있습니다.
// iframe 내부 스크립트 예시
if (document.hasStorageAccess) {
const hasAccess = await document.hasStorageAccess();
if (!hasAccess) {
// 권한 요청 시도
try {
await document.requestStorageAccess();
console.log("Unpartitioned 스토리지 접근 승인됨!");
} catch (err) {
console.error("스토리지 접근 거부됨:", err);
}
}
}Storage Access API를 이해하려면 먼저 최신 브라우저의 스토리지 파티셔닝 개념을 파악해야 합니다.
| 구분 | Partitioned Storage (격리 스토리지) | Unpartitioned Storage (통합 스토리지) |
|---|---|---|
| 키 구조 | (Top-level Site, Embedded Site) 키 묶음 |
(Embedded Site) 단일 키 |
| 접근 범위 | 해당 특정 부모 사이트에 속한 iframe 내에서만 유효 | 독립 탭에서 해당 사이트를 직접 방문했을 때와 동일한 스토리지 |
| 쿠키 공유 | 부모 사이트가 달라지면 쿠키 값이 완전히 분리됨 | 모든 사이트에 임베드되더라도 동일한 로그인 세션 쿠키 참조 |
| 보안/추적 | 교차 사이트 추적 불가능 (안전) | 사용자 승인 없이는 크로스사이트 추적 위험 존재 |
Storage Access API는 Partitioned Storage 상태로 갇혀 있는 iframe을, 권한 획득 후 Unpartitioned Storage 접근이 가능한 상태로 전환해 주는 역할을 합니다.
document.hasStorageAccess() 메서드는 현재 문서가 unpartitioned 스토리지에 접근할 수 있는 권한을 이미 가지고 있는지 여부를 나타내는 Promise<boolean>을 반환합니다.
async function checkStorageAccess() {
// 1. API 지원 여부 확인
if (!('hasStorageAccess' in document)) {
console.log("이 브라우저는 Storage Access API를 지원하지 않거나, 최상위 문서입니다.");
return true;
}
try {
// 2. 스토리지 접근 상태 확인
const hasAccess = await document.hasStorageAccess();
if (hasAccess) {
console.log("이미 Unpartitioned 스토리지 접근 권한이 있습니다.");
return true;
} else {
console.log("스토리지 접근 권한이 제한되어 있습니다.");
return false;
}
} catch (error) {
console.error("권한 상태 확인 중 에러 발생:", error);
return false;
}
}hasAccess === true: 추가 요청 없이 document.cookie를 읽거나 API 요청 시 쿠키가 자동으로 포함됩니다.hasAccess === false: 사용자의 클릭이나 터치 동작(User Gesture)을 유도하는 UI 버튼을 화면에 렌더링해야 합니다.document.requestStorageAccess() 메서드를 호출하면 브라우저에 권한을 요청합니다. 하지만 브라우저는 무분별한 요청을 방지하기 위해 엄격한 전제 조건을 요구합니다.
click, touchend 등 사용자의 직접적인 상호작용 이벤트 핸들러 내부에서 호출되어야 합니다.src 주소와 요청하는 도메인의 origin이 동일해야 합니다.widget.com)를 과거에 최상위 탭으로 직접 방문하여 상호작용한 적이 있어야 합니다 (Safari/Chrome의 추적 방지 룰).const loginButton = document.getElementById('btn-widget-login');
loginButton.addEventListener('click', async () => {
try {
// 사용자 제스처 이벤트 핸들러 안에서 호출
await document.requestStorageAccess();
// 권한 획득 성공! unpartitioned 쿠키를 참조하여 세션 복원
console.log("스토리지 접근 승인 완료. 데이터 갱신 중...");
fetchUserData();
} catch (err) {
// 사용자가 브라우저 팝업에서 거부했거나 조건 미충족
console.warn("스토리지 접근 권한이 거부되었습니다.", err);
showFallbackLoginUI();
}
});부모 페이지에서 iframe을 렌더링할 때 sandbox 속성을 사용하는 경우, Storage Access API가 작동하려면 반드시 allow-storage-access-by-user-activation 토큰을 포함해야 합니다.
이 토큰이 누락되면 iframe 내부에서 document.requestStorageAccess()를 호출할 때 즉시 거부(Reject) 예외가 발생합니다.
<!-- 부모 페이지 HTML -->
<iframe
src="https://auth-widget.example.com/login"
sandbox="allow-scripts allow-same-origin allow-storage-access-by-user-activation"
title="인증 위젯">
</iframe>| sandbox 토큰 | 역할 |
|---|---|
allow-scripts |
iframe 내부 자바스크립트 실행 허용 |
allow-same-origin |
iframe이 자신의 origin 맥락을 유지하도록 허용 |
allow-storage-access-by-user-activation |
Storage Access API 호출 및 프롬프트 팝업 허용 |
다음은 서드파티 댓글 위젯 또는 단일 로그인(SSO) 위젯에서 사용되는 실전 방어적 프로그래밍 코드 패턴입니다.
// widget-app.js (https://comments-service.com 에서 실행되는 iframe 스크립트)
class StorageAccessManager {
constructor() {
this.hasAccess = false;
}
async initialize() {
// 1. Storage Access API 지원 체킹
if (!document.hasStorageAccess) {
// API 미지원 브라우저는 기본 처리
this.hasAccess = true;
return;
}
this.hasAccess = await document.hasStorageAccess();
if (this.hasAccess) {
this.loadAuthenticatedContent();
} else {
this.renderPermissionRequestUI();
}
}
renderPermissionRequestUI() {
const container = document.getElementById('widget-container');
container.innerHTML = `
<div class="auth-prompt">
<p>댓글을 작성하려면 로그인 세션 접근 승인이 필요합니다.</p>
<button id="request-access-btn">로그인 상태 연동하기</button>
</div>
`;
document.getElementById('request-access-btn').addEventListener('click', () => {
this.handleRequestAccess();
});
}
async handleRequestAccess() {
try {
// User Gesture 내에서 권한 요청
await document.requestStorageAccess();
this.hasAccess = true;
console.log("스토리지 접근 승인 완료");
// UI 갱신 및 데이터 로드
this.loadAuthenticatedContent();
} catch (error) {
console.error("사용자가 스토리지 접근을 거부했거나 실패했습니다:", error);
this.renderFallbackUI();
}
}
async loadAuthenticatedContent() {
// unpartitioned cookie가 세션 헤더로 자동 전송됨
const res = await fetch('https://comments-service.com/api/user-session', {
credentials: 'include'
});
const user = await res.json();
if (user.isLoggedIn) {
document.getElementById('widget-container').innerText = `환영합니다, ${user.name}님!`;
} else {
document.getElementById('widget-container').innerText = "로그인이 필요합니다.";
}
}
renderFallbackUI() {
document.getElementById('widget-container').innerHTML = `
<p>세션 연동 실패. <a href="https://comments-service.com/login" target="_blank">새 창에서 로그인</a> 해주세요.</p>
`;
}
}
// 위젯 실행
const manager = new StorageAccessManager();
document.addEventListener('DOMContentLoaded', () => manager.initialize());| 항목 | 과거 기존 방식 (SameSite=None) | Storage Access API 사용 방식 |
|---|---|---|
| 사용자 개입 | 없음 (암묵적 자동 전송) | 명시적 클릭(User Gesture) 또는 브라우저 정책 승인 필요 |
| 보안/추적 방지 | 보안 취약 및 사용자 무단 추적 가능 | 사용자 동의 기반 접근으로 차세대 개인정보 규제 준수 |
| Safari/Firefox | 기본값으로 무조건 차단됨 | 조건 충족 시 정상 동작 지원 |
| 스토리지 형태 | 동일한 Unpartitioned Cookie 사용 | 요청 성공 시에만 Partitioned -> Unpartitioned 전환 |
| 개발자 구현 복잡도 | 단순 (SameSite=None; Secure 설정) |
상태 조회 및 클릭 이벤트 핸들러 연동 로직 필요 |
각 브라우저 제조사마다 사용자 경험 강화를 위해 Storage Access API를 처리하는 세부 정책이 조금씩 다릅니다.
requestStorageAccess() 호출 시 브라우저 자체 프롬프트 팝업을 띄워 사용자 동의를 구합니다.requestStorageAccess() 요청이 즉시 Reject됩니다.requestStorageAccess() 호출 시 별도 프롬프트 팝업 없이 자동으로 승인됩니다.실무 환경에서 Storage Access API를 도입할 때 흔히 겪는 시행착오입니다.
NotAllowedError 예예페이지 로드 시점(DOMContentLoaded 또는 useEffect 내)에서 document.requestStorageAccess()를 바로 실행하면 안 됩니다.
// ❌ 잘못된 예시: 페이지 로드 시 자동 호출 (에러 발생)
window.addEventListener('load', async () => {
await document.requestStorageAccess(); // Error: Must be handled during user interaction!
});
// ⭕ 올바른 예시: 사용자 버튼 클릭 내부 호출
myButton.addEventListener('click', async () => {
await document.requestStorageAccess(); // 정상 작동
});사용자가 단 한 번도 https://third-party.com을 주소창에 직접 쳐서 들어간 적이 없다면, iframe 내에서 requestStorageAccess()는 사용자 프롬프트조차 띄우지 못하고 실패합니다. 이 경우 팝업창(window.open)을 띄워 퍼스트파티 탭에서 1회 이상 상호작용하도록 유도해야 합니다.
requestStorageAccess()가 Resolved(승인)된 후에도 기존에 렌더링된 iframe 맥락의 window.localStorage는 즉시 갱신되지 않고 여전히 partitioned 상태를 가리킬 수 있습니다. 안전한 쿠키 및 스토리지 동기화를 위해서는 권한 획득 후 서버 통신(fetch)을 다시 호출하거나 iframe 내 데이터를 리로드하는 것이 좋습니다.
Storage Access API가 모든 크로스사이트 통신 문제의 만병통치약은 아닙니다. 다음과 같은 경우에는 다른 대안 기술을 사용하는 것이 훨씬 적절합니다.
window.postMessage API를 사용하는 것이 안전하고 간단합니다.hasStorageAccess()로 현재 unpartitioned 스토리지 권한을 조회하고, 권한이 없을 경우 사용자 이벤트 기반으로 requestStorageAccess()를 호출합니다.sandbox를 적용할 경우 allow-storage-access-by-user-activation 속성을 추가해야 합니다.✨ 한 줄 요약
Storage Access API는 사용자 동의(User Gesture)를 다리로 삼아 서드파티 iframe에게 unpartitioned 스토리지 접근을 허용하는 현명한 브라우저 보안 표준입니다.




