Chương trình học Bài 67 trên tổng số 156 · Content Security Policy và việc nhúng khung
Content Security Policy và việc nhúng khung

Trusted Types

Vì sao điều này quan trọng CSP chặn các thẻ script bị chèn. Nhưng nhiều lỗi hiện đại nằm bên trong chính JavaScript của bạn: một dòng như box.innerHTML = comment biến văn bản từ một khách truy cập thành HTML sống. Đó là kiểu chèn mã dựa trên DOM từ Mô-đun 10 (Bài 59), và nó xảy ra sau khi trang đã tải. Trusted Types khiến trình duyệt từ chối những dòng nguy hiểm đó trừ khi giá trị đã đi qua một bước kiểm tra do bạn viết.

Hãy tưởng tượng một nhà máy nơi chỉ những bộ phận có dấu kiểm định mới được đưa lên dây chuyền lắp ráp. Không ai có thể bắt vít một bộ phận ngẫu nhiên nhặt được ở bãi đỗ xe, kể cả do vô tình. Trusted Types thêm con dấu đó vào các chuỗi mà mã của bạn đưa vào những nơi nguy hiểm.

DOM: viết tắt của Document Object Model, cây các phần tử sống mà trình duyệt dựng từ một trang, thứ JavaScript có thể đọc và thay đổi.

Sink: một chỗ trong DOM nơi một chuỗi trở thành mã hay markup. Ví dụ: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval và các đối số chuỗi cho setTimeout, và script.src.

Trusted Types: một tính năng trình duyệt, được bật bằng CSP, theo đó các sink đó chỉ chấp nhận những đối tượng đặc biệt (TrustedHTML, TrustedScript, TrustedScriptURL) được tạo bởi một policy, một hàm nhỏ bạn viết và đặt tên. Một chuỗi trơn được gán cho một sink sẽ ném ra lỗi thay vì chạy.

Bật nó lên

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': thi hành nó trên mọi sink liên quan tới script.
  • trusted-types comments: tên policy duy nhất mã của bạn được tạo. Một script bị chèn không thể đăng ký một policy của riêng nó dưới một cái tên khác. trusted-types 'none' cấm tạo bất kỳ cái nào.

Dùng nó trong mã của bạn

// 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

Cái lợi lớn là cho người duyệt mã. Thay vì săn mọi innerHTML trong một kho mã lớn, bạn duyệt vài hàm policy. Nếu chúng an toàn, trình duyệt bảo đảm mọi thứ khác đều đi qua chúng.

Một policy tên default là đặc biệt: trình duyệt tự động gọi nó mỗi khi một chuỗi trơn tới một sink. Nó hữu ích trong lúc chuyển đổi mã cũ, nhưng nó cũng là chỗ lỗi ẩn náu, nên hãy giữ nó chặt và ghi nhật ký những gì đi qua.

Hỗ trợ và triển khai

Trusted Types được hỗ trợ trong mọi engine lớn: các trình duyệt dựa trên Chromium, Safari 26 và Firefox 148 (kiểm tra vào tháng Mười 2026). Khách truy cập trên các trình duyệt cũ hơn đơn giản là không có bước kiểm tra thêm, nên hãy tiếp tục thoát ký tự và giữ CSP dựa trên nonce. Mã có thể kiểm tra nó bằng if (window.trustedTypes).

Triển khai nó như mọi chính sách: trước hết gửi require-trusted-types-for 'script' trong một header Content-Security-Policy-Report-Only. Mọi chuỗi tới một sink đều được báo cáo, cho bạn thấy chính xác những dòng nào cần một policy hoặc, tốt hơn, chuyển sang textContent.

Một hiểu lầm phổ biến: "Trusted Types làm sạch HTML giùm tôi". Nó không làm sạch gì cả. Nó buộc các chuỗi đi qua policy của bạn. Một policy trả về đầu vào không đổi (createHTML: s => s) qua được bước kiểm tra và không bảo vệ gì.

Tóm tắt

  • Chèn mã DOM xảy ra trong chính JavaScript của bạn tại các sink như innerHTML; chỉ quy tắc thẻ script thì không bắt được nó.
  • require-trusted-types-for 'script' khiến các sink từ chối chuỗi trơn; trusted-types NAME giới hạn những policy nào được tồn tại.
  • Duyệt vài hàm policy thay vì mọi sink, và ưu tiên textContent ở nơi bạn có thể.
  • Được hỗ trợ trong mọi engine lớn (kiểm tra vào tháng Mười 2026); hãy triển khai ở dạng report-only trước.

Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này

Bài tập này sẽ sớm mở.

Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.