강의 계획 레슨 156개 중 67번째 · 콘텐츠 보안 정책과 틀 넣기
콘텐츠 보안 정책과 틀 넣기

Trusted Types

왜 중요한가 CSP는 주입된 스크립트 태그를 막아요. 하지만 많은 현대 버그는 여러분 자신의 JavaScript 안에 살아요: box.innerHTML = comment 같은 줄은 방문자의 글을 살아 있는 HTML로 바꿔요. 그게 10모듈(59번 레슨)의 DOM 기반 주입이고, 페이지가 불러와진 뒤에 일어나요. Trusted Types는 여러분이 쓴 확인을 거치지 않은 값이면 브라우저가 그런 위험한 줄을 거부하게 해요.

검사 도장이 찍힌 부품만 조립 라인에 오를 수 있는 공장을 상상해 보세요. 아무도 주차장에서 주운 아무 부품을, 실수로라도, 달 수 없어요. Trusted Types는 코드가 위험한 곳에 먹이는 문자열에 그 도장을 더해요.

DOM: Document Object Model의 줄임말로, 브라우저가 페이지로 만드는 살아 있는 요소 나무이고, JavaScript가 읽고 바꿀 수 있어요.

싱크: 문자열이 코드나 마크업이 되는 DOM의 자리. 예: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval과 setTimeout의 문자열 인자, 그리고 script.src.

Trusted Types: CSP로 켜는 브라우저 기능으로, 그 아래에서 싱크는 여러분이 쓰고 이름 붙인 작은 함수인 정책이 만든 특별한 객체(TrustedHTML, TrustedScript, TrustedScriptURL)만 받아요. 싱크에 할당한 평범한 문자열은 돌지 않고 오류를 던져요.

켜기

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': 스크립트와 관련된 모든 싱크에 강제해요.
  • trusted-types comments: 코드가 만들 수 있는 유일한 정책 이름. 주입된 스크립트는 다른 이름으로 자기 정책을 등록할 수 없어요. trusted-types 'none'은 어떤 것도 만들지 못하게 해요.

코드에서 쓰기

// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
  createHTML: (text) => escapeHtml(text),   // or a well-tested sanitiser
});

box.innerHTML = comment;                              // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment);   // allowed, escaped
box.textContent = comment;                            // not a sink at all: always fine

큰 이득은 검토자에게 있어요. 큰 코드베이스에서 모든 innerHTML을 뒤지는 대신, 몇 안 되는 정책 함수를 검토하면 돼요. 그게 안전하면 브라우저가 나머지 모든 게 그것을 거치도록 강제해요.

default라는 정책은 특별해요: 평범한 문자열이 싱크에 닿을 때마다 브라우저가 자동으로 불러요. 옛 코드를 옮기는 동안 쓸모 있지만, 실수가 숨는 곳이기도 하니 엄격하게 두고 통과하는 걸 기록하세요.

지원과 펼치기

Trusted Types는 모든 주요 엔진에서 지원돼요: Chromium 기반 브라우저, Safari 26, Firefox 148(2026년 10월 확인). 옛 브라우저의 방문자는 그냥 추가 확인을 받지 못하니, 이스케이프와 nonce 기반 CSP를 지키세요. 코드는 if (window.trustedTypes)로 확인할 수 있어요.

다른 정책처럼 펼치세요: 먼저 Content-Security-Policy-Report-Only 헤더로 require-trusted-types-for 'script'를 보내세요. 싱크에 닿는 모든 문자열이 보고되어, 어떤 줄에 정책이, 아니면 더 좋게 textContent로의 전환이 필요한지 정확히 보여 줘요.

흔한 오해: "Trusted Types가 HTML을 정화해 준다". 아무것도 정리하지 않아요. 문자열이 여러분의 정책을 거치도록 강제해요. 입력을 그대로 돌려주는 정책(createHTML: s => s)은 확인을 통과하고 아무것도 지키지 않아요.

요약

  • DOM 주입은 innerHTML 같은 싱크에서 여러분 자신의 JavaScript 안에서 일어나요. 스크립트 태그 규칙만으로는 잡지 못해요.
  • require-trusted-types-for 'script'는 싱크가 평범한 문자열을 거부하게 하고, trusted-types NAME은 어떤 정책이 있을 수 있는지 제한해요.
  • 모든 싱크 대신 몇 안 되는 정책 함수를 검토하고, 할 수 있는 곳에서는 textContent를 고르세요.
  • 모든 주요 엔진에서 지원돼요(2026년 10월 확인). 먼저 보고 전용으로 펼치세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.