amaranth.log
💻 개발

[기술부채] iframe과 postMessage

서론

회사에서 개발 중인 서비스에서, iframe을 통해 사내 다른 서비스의 페이지를 참조하게 해야 하는 요구사항이 있었다. 여기서 인증 토큰을 iframe 페이지에 전달해야 했는데, 이 과정에서 알게 된 postMessage라는 표준 인터페이스에 대해 정리해보려고 한다.

iframe이란?

<iframe>은 HTML 문서 내에 다른 HTML 문서를 삽입하여 보여주는 기술로, 웹 페이지 안에 독립적인 창을 만들어 유튜브 영상, 지도, 외부 페이지 등을 표시할 때 주로 사용된다.
<iframe src="https://www.example.com" width="600" height="400" />
사용 예시
  • src: 삽입할 페이지의 URL 주소
  • width/height: 프레임의 너비/높이(픽셀 혹은 % 단위)
  • allow: 삽입된 페이지에서의 전체 화면(fullscreen), 마이크, 카메라 등 특정 기능을 허용할 것인지에 대한 여부를 결정
  • loading="lazy": 페이지를 스크롤해서 해당 위치에 도달할 때 iframe 내의 콘텐츠를 불러오도록 하는 설정. 페이지의 초기 로드 성능을 높일 수 있다.
  • sandbox: 보안을 위해 사용한다. 삽입된 페이지에서의 스크립트 실행이나 팝업을 제한할 수 있다.
<iframe> 태그를 렌더링하면 브라우저는 해당 문서를 위한 새로운 문서 실행 환경을 생성한다. 이렇게 생성된 실행 환경은 별도의 전역 객체와 DOM, JavaScript 실행 컨텍스트, 이벤트 루프를 갖는다. 즉, 부모 페이지와 iframe은 같은 메모리를 공유하지 않는다.

활용 사례

  • 유튜브 영상 삽입, 구글 지도, 광고 배너 등
  • iframe은 별도의 브라우징 컨텍스트를 가지기 때문에, 메인 스레드의 부하를 줄이는 용도로 활용될 수도 있다.

주의사항

  • 네이버나 구글 같은 큰 사이트들은 보안을 위해 자신의 페이지가 다른 사이트의 <iframe> 안에 들어가는 것을 막아두기도 한다. 이런 페이지를 iframe으로 접근하면 연결 거부 오류가 뜰 수 있다.
    • 🤔
      X-Frame-Options 응답 헤더
      • DENY: 어떤 도메인에서든 페이지를 iframe으로 삽입할 수 없다.
      • SAMEORIGIN: 동일한 도메인 내에서만 페이지를 iframe으로 삽입할 수 있다.
      💡
      팁: <iframe> 태그 사이에 넣는 텍스트는 브라우저가 프레임을 지원하지 않을 때만 화면에 나타난다. (예: "이 브라우저는 iframe을 지원하지 않습니다.")
  • 반응형 디자인: 모바일 화면에서는 크기가 고정되면 보기 불편할 수 있으므로 CSS를 활용해 비율을 맞춰주는 작업이 필요하다.
    • 🤔
      과거에는 외부 <div>로 감싸고 padding을 이용한 해킹 기법을 썼지만, 최신 브라우저에서는 CSS의 aspect-ratio 속성을 사용한다.
      iframe { width: 100%; aspect-ratio: 16 / 9; /* 16:9 비율 유지 */ }
  • 서로 다른 도메인(Cross-Origin)의 페이지를 iframe으로 불러오면 보안 정책(SOP) 때문에 직접적인 자바스크립트 조작이 어렵다.

동일 출처 정책(Same-Origin Policy, SOP)

: 다른 도메인으로부터의 접근을 차단하는 브라우저의 보안 정책
브라우저는 모든 문서에 origin이라는 식별자를 부여한다.
origin(https://example.com:433)은 프로토콜(https), 도메인(example.com), 포트(433)으로 구성된다.
이 세 가지 구성 요소가 모두 동일하면 같은 출처(same-origin)으로 간주된다.
만일 어떤 두 문서의 origin이 다르면 브라우저는 문서 간의 DOM, JavaScript 변수, 쿠키, LocalStorage 접근을 모두 차단한다.
이 규칙에 따라 서로 다른 origin의 문서를 iframe으로 로드하면, 부모와 iframe은 서로의 내부 상태(DOM, 함수 등)에 접근할 수 없다.
이런 문제를 해결하기 위해 postMessage를 사용할 수 있다.

postMessage

: 서로 다른 실행환경(window, worker, iframe 등) 사이에서 안전하게 데이터를 주고받기 위한 표준 인터페이스
서로 다른 Origin을 가진 페이지 간에 데이터를 전달하기 위해 사용한다.

postMessage가 필요한/사용되는 상황들

  • 결제 모듈(PG) 연동: 결제창 iframe이 부모 페이지에 결제 완료를 알려야 할 때 사용할 수 있다.
  • SSO 인증 토큰 공유: 메인 서비스에 로그인할 때 iframe으로 심어둔 다른 도메인의 서비스(채팅 상담 봇 등)도 자동으로 로그인되어야 할 때 사용할 수 있다.
  • 외부 미디어 제어: 유튜브에서 퍼온 영상을 iframe으로 띄웠을 때, 내 사이트의 버튼으로 영상을 제어하고자할 때 사용할 수 있다.
  • silent refresh: access token을 갱신할 때 숨겨진 iframe에서 인증 서버를 다시 호출하고 얻은 access token을 부모 페이지에 전달할 때 사용할 수 있다.
  • 웹앱의 새로운 버전 업데이트 알림: 사용자가 업데이트 버튼을 누르면 Service Worker에 메시지를 보내 새로고침을 유도하고, 대기중이던 새로운 Service Worker를 즉시 활성화시킨다.
  • 오프라인 캐싱 진행률 표시: 대용량 정적 리소스나 데이터를 백그라운드에서 캐싱할 때, Service Worker는 캐싱 작업 루프 안에서 진행 상황에 대한 데이터를 지속적으로 전송한다. 메인 스레드에서 이를 받아 실시간 진행률 표시에 이용할 수 있다.
  • 백그라운드 동기화 및 UI 반영: Service Worker는 사용자가 오프라인에서 작성한 변경사항을 인터넷이 연결되는 순간 서버로 전송하는데, 서버 전송이 성공적으로 완료되었을 때 Service Worker는 메인 스레드로 성공 메시지를 보낸다. 이를 UI를 업데이트하는 데 사용할 수 있다.

postMessage의 기본 메커니즘

송신 측에서 메시지를 던지면 수신 측에서 이벤트 리스너를 통해 메시지를 감지한다.
  • 송신측
      1. 송신측에서 메시지를 생성한다.
      1. 브라우저가 메시지 데이터를 복사하고 대상 window(iframe)의 이벤트 큐에 메시지를 넣는다.
      // 대상 윈도우 객체(=전역 객체).postMessage(데이터, 타겟_오리진); const iframeWindow = document.getElementById('myIframe').contentWindow; iframeWindow.postMessage( { type: 'LOGIN_SUCCESS', userId: 123 }, // 보낼 데이터 'https://partner-service.com' );
  • 수신측
      1. 이벤트 루프가 message 이벤트를 실행한다.
      1. 수신자가 이벤트 핸들러로 받는다.
      window.addEventListener('message', (event) => { // 🛡️ 보안 체크: 신뢰할 수 있는 출처인지 반드시 확인! if (event.origin !== 'https://my-app.com') return; console.log('받은 데이터:', event.data); // 필요하다면 응답을 보낼 수도 있음 // event.source.postMessage('확인했습니다!', event.origin); });
🤔
SOP 정책에 따라 origin이 다르면 문서 간의 내부 상태에 접근할 수 없다고 했는데, 전역 객체(contentWindow)엔 접근할 수 있는 건가요?
contentWindow는 iframe 요소의 전역 객체를 가리키는데, 정확하게 표현하면 실제로 접근하는 것은 전역 객체 원본이 아니다. 전역 객체의 일부 API(postMessage 등)만 허용된 프록시 객체이다.
document.getElementById('myIframe').contentWindow;

유의사항

  • postMessage(data, ‘*’)처럼 별표를 쓰면 어떤 사이트든 메시지를 가로챌 수 있기 때문에, 보안을 위해 수신측 도메인을 명시해주는 것이 좋다.
  • postMessage는 메모리를 공유하지 않고, structed clone이라는 알고리즘을 통해 데이터를 복사해 전달한다. 때문에 메시지로 함수, DOM 요소 등은 보낼 수 없고 JSON 형태의 객체 또는 배열, 숫자, 문자열이 적합하다.
    • 🤔
      structed clone 알고리즘
      : 자바스크립트 엔진이 복잡한 데이터나 객체를 완벽하게 깊은 복사(Deep Copy)하기 위해 사용하는 내장 알고리즘
      이 알고리즘으로 생성된 객체는 원본 데이터와의 참조 관계가 제거되기 때문에, 송신측과 수신측은 완전히 독립된 데이터를 가지게 되고 이로 인해 메모리 안전성, 격리 유지, 예측 가능한 동작이 보장된다.
      다만 대용량 데이터의 경우 전달 비용이 크다는 단점이 있다.
 
📚 기술 부채27 / 31
  1. 1편[기술부채] 우테코 5기 레벨1 - 6주차: 블랙잭 미션, RDD와 try-with-resources2023년 3월 20일
  2. 2편[기술부채] 우테코 5기 레벨1 - 7주차: 체스 미션, 방어적 복사와 커맨드 패턴2023년 3월 27일
  3. 3편[기술부채] 우테코 5기 레벨1 - 8주차: 체스 미션, 테스트 더블과 커넥션 풀2023년 4월 14일
  4. 4편[기술부채] 우테코 5기 레벨2 - 1주차: 웹 자동차 경주, 스프링 MVC 매핑과 DI2023년 4월 16일
  5. 5편[기술부채] 우테코 5기 레벨2 - 2주차: @Valid와 Dirty Checking2023년 5월 1일
  6. 6편[기술부채] 우테코 5기 레벨2 - 3주차: 장바구니 미션, MockMvc vs RestAssured와 PRG 패턴2023년 5월 3일
  7. 7편[기술부채] 우테코 5기 레벨2 - 5주차: Mockito와 동적 쿼리2023년 5월 14일
  8. 8편[기술부채] 우테코 5기 레벨2 - 6주차: 지하철 미션, Profile과 JPA 연관관계2023년 5월 23일
  9. 9편[기술부채] 우테코 5기 레벨2 - 9주차: CORS Preflight와 멱등성, 필드 주입2023년 6월 12일
  10. 10편[기술부채] 우테코 5기 레벨2 - 8주차: 장바구니 협업 미션, LocalDateTime 직렬화와 시맨틱 버저닝2023년 6월 12일
  11. 11편[기술부채] 우테코 5기 레벨2 - 7주차: OSIV와 영속성 컨텍스트, CORS 인증2023년 6월 30일
  12. 12편[기술부채] 우테코 5기 레벨3 - 3주차: 오프셋·커서 페이지네이션과 @ElementCollection2023년 7월 18일
  13. 13편[기술부채] 우테코 5기 레벨3 - 7주차: Batch Insert와 @EventListener2023년 8월 12일
  14. 14편[기술부채] 우테코 5기 레벨3 - 8주차: JPQL Distinct와 MultipleBagFetchException2023년 8월 31일
  15. 15편[기술부채] 우테코 5기 레벨3 - 6주차: 동시성 이슈와 @Transient2023년 8월 31일
  16. 16편[기술부채] 우테코 5기 레벨3 - 1주차: 무결성과 정합성, Elastic Beanstalk2023년 8월 31일
  17. 17편[기술부채] 우테코 5기 레벨4 - 1주차: @TransactionalEventListener와 트랜잭션 전파2023년 9월 10일
  18. 18편[기술부채] 우테코 5기 레벨4 - 2주차: 톰캣 만들기와 Location 헤더2023년 9월 11일
  19. 19편[기술부채] 우테코 5기 레벨4 - 3주차: 로드밸런서, CQRS와 커버링 인덱스2023년 9월 18일
  20. 20편[기술부채] 우테코 5기 레벨4 - 4주차: @MVC 구현하기 미션2023년 9월 24일
  21. 21편[기술부채] 우테코 5기 레벨4 - 5주차: @MVC 구현하기 3단계와 JSON 응답2023년 10월 2일
  22. 22편[기술부채] 우테코 5기 레벨4 - 6주차: JDBC 라이브러리 구현하기 1~3단계2023년 10월 9일
  23. 23편[기술부채] 우테코 5기 레벨4 - 7주차: JDBC 라이브러리 구현하기 3단계2023년 10월 16일
  24. 24편[Spring] Spring DTO의 데이터 바인딩과 직렬화2023년 12월 5일
  25. 25편[기술부채] 클라이언트 사이드 라우팅2026년 2월 5일
  26. 26편[기술부채] 왜 리액트는 클래스를 버리고 함수를 선택했을까(feat. React Hooks)2026년 2월 12일
  27. 27편[기술부채] iframe과 postMessage2026년 2월 20일
  28. 28편[기술부채] Service Worker(서비스 워커)2026년 2월 24일
  29. 29편[기술부채] 커링의 어원과 함수형 프로그래밍2026년 3월 12일
  30. 30편[기술부채] AG-UI와 CopilotKit - 12026년 3월 27일
  31. 31편[기술부채] AG-UI와 CopilotKit - 22026년 3월 29일