Silabus Pelajaran 67 dari 156 · Kebijakan Keamanan Konten dan pembingkaian
Kebijakan Keamanan Konten dan pembingkaian

Trusted Types

Kenapa ini penting Blok CSP yang disisipkan tag script. Tapi banyak bug modern ada di dalam JavaScript milikmu sendiri: baris seperti box.innerHTML = comment mengubah teks dari pengunjung menjadi HTML aktif. Itu adalah injeksi berbasis DOM dari Modul 10 (Pelajaran 59), dan itu terjadi setelah halaman dimuat. Trusted Types membuat browser menolak baris berbahaya tersebut kecuali nilainya melewati pengecekan yang kamu tulis.

Bayangkan sebuah pabrik di mana hanya bagian dengan stempel inspeksi yang boleh masuk ke lini perakitan. Tidak ada yang boleh memasang bagian acak yang ditemukan di tempat parkir, bahkan secara tidak sengaja. Trusted Types menambahkan stempel itu ke string yang dimasukkan kode kamu ke tempat berbahaya.

DOM: singkatan dari Document Object Model, struktur pohon elemen yang dibangun browser dari sebuah halaman, yang bisa dibaca dan diubah oleh JavaScript.

Sink: tempat di DOM di mana string menjadi kode atau markup. Contoh: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval dan argumen string ke setTimeout, dan script.src.

Trusted Types: fitur browser, diaktifkan oleh CSP, di mana sink hanya menerima objek khusus (TrustedHTML, TrustedScript, TrustedScriptURL) yang dibuat oleh policy, fungsi kecil yang kamu tulis dan beri nama. String biasa yang diberikan ke sink akan memicu error alih-alih dijalankan.

Menyalakannya

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': terapkan pada semua sink terkait script.
  • trusted-types comments: satu-satunya nama policy yang boleh dibuat kode kamu. Script yang disisipkan tidak bisa mendaftarkan policy miliknya sendiri di bawah nama lain. trusted-types 'none' melarang pembuatan apa pun.

Menggunakannya di kode kamu

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

Keuntungan besarnya adalah untuk reviewer. Daripada mencari setiap innerHTML di codebase yang besar, kamu cukup meninjau beberapa fungsi policy. Jika fungsi itu aman, browser akan memastikan semua hal lainnya melewati fungsi tersebut.

Kebijakan

A bernama default itu spesial: browser memanggilnya secara otomatis setiap kali string biasa mencapai sink. Ini berguna saat memindahkan kode lama, tapi ini juga tempat di mana kesalahan tersembunyi, jadi jaga agar tetap ketat dan catat apa yang lewat.

Dukungan dan peluncuran

Trusted Types didukung di semua mesin utama: browser berbasis Chromium, Safari 26 dan Firefox 148 (dicek Oktober 2026). Pengunjung di browser lama tidak mendapatkan pengecekan tambahan, jadi tetap gunakan escaping dan tetap gunakan CSP berbasis nonce milikmu. Kode bisa mengeceknya dengan if (window.trustedTypes).

Terapkan seperti kebijakan apa pun: kirim require-trusted-types-for 'script' di header Content-Security-Policy-Report-Only dulu. Setiap string yang mencapai sink akan dilaporkan, menunjukkan dengan tepat baris mana yang butuh kebijakan atau, lebih baik, beralih ke textContent.

Kesalahpahaman umum: "Trusted Types membersihkan HTML untukku". Ia tidak membersihkan apa pun. Ia memaksa string melewati policy milikmu. Policy yang mengembalikan input tanpa perubahan (createHTML: s => s) lolos pengecekan dan tidak melindungi apa pun.

Ringkasan

  • DOM injection terjadi di JavaScript kamu pada sink seperti innerHTML; aturan script-tag saja tidak bisa menangkapnya.
  • require-trusted-types-for 'script' membuat sinks menolak string biasa; trusted-types NAME membatasi kebijakan mana yang boleh ada.
  • Tinjau beberapa fungsi policy saja daripada setiap sink, dan utamakan textContent jika kamu bisa.
  • Didukung di semua engine utama (dicek Oktober 2026); rilis di report-only dulu.

Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini

Latihan ini akan segera dibuka

Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.