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 commentsrequire-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월 확인). 먼저 보고 전용으로 펼치세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.