Müfredat 156 dersinden 67. · İçerik Güvenlik Politikası ve çerçeveleme
İçerik Güvenlik Politikası ve çerçeveleme

Güvenilir Türler

Neden önemli CSP blokları enjekte edilen script etiketleri. Ancak birçok modern hata kendi JavaScript kodunun içinde yaşar: box.innerHTML = comment gibi bir satır bir ziyaretçiden gelen metni canlı HTML haline getirir. Bu, Modül 10 (Ders 59) içindeki DOM tabanlı enjeksiyondur ve sayfa yüklendikten sonra gerçekleşir. Trusted Types, değer senin yazdığın bir kontrolden geçmedikçe tarayıcının bu tehlikeli satırları reddetmesini sağlar.

Sadece üzerinde denetim damgası olan parçaların montaj hattına girebildiği bir fabrika hayal et. Kimse otoparkta bulunan rastgele bir parçayı yanlışlıkla bile olsa monte edemez. Trusted Types, kodunun tehlikeli yerlere gönderdiği dizelere o damgayı ekler.

DOM: Document Object Model'in kısaltmasıdır, tarayıcının bir sayfadan oluşturduğu ve JavaScript'in okuyup değiştirebildiği canlı öğeler ağacıdır.

Sink: bir stringin koda veya işaretlemeye dönüştüğü DOM alanı. Örnekler: element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval ve setTimeout ile script.src fonksiyonlarına gönderilen string argümanları.

Trusted Types: CSP ile açılan, sinklerin sadece bir policy tarafından oluşturulan özel nesneleri (TrustedHTML, TrustedScript, TrustedScriptURL) kabul etmesini sağlayan bir tarayıcı özelliği. Bir sinke atanan düz bir string çalışmak yerine hata verir.

Onuna açıyorum

Content-Security-Policy: require-trusted-types-for 'script'; trusted-types comments
  • require-trusted-types-for 'script': tüm script ile ilgili sinkler üzerinde zorunlu kıl.
  • trusted-types comments: kodunun oluşturabileceği tek politika adı. Enjekte edilen bir script başka bir isim altında kendi politikasını kaydedemez. trusted-types 'none' herhangi birinin oluşturulmasını yasaklar.

Kodunda kullanmak

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

Büyük kazanç incelemeciler için. Büyük bir kod tabanında her innerHTML avlamak yerine, sadece birkaç politika fonksiyonunu incelersin. Eğer bunlar güvenliyse, tarayıcı diğer her şeyin onlardan geçmesini zorunlu kılar.

adındaki default politikası özeldir: tarayıcı, düz bir string bir sinke ulaştığında onu otomatik olarak çağırır. Eski kodu taşırken yararlıdır, ancak hataların gizlendiği bir yerdir, bu yüzden onu katı tut ve içinden geçenleri logla.

Destekle ve yayına al

Trusted Types tüm büyük motorlarda destekleniyor: Chromium tabanlı tarayıcılar, Safari 26 ve Firefox 148 (Ekim 2026'da kontrol edildi). Eski tarayıcılardaki ziyaretçiler ekstra kontrolü alamaz, bu yüzden kaçış işlemlerine devam et ve nonce tabanlı CSP'ni koru. Kod bunu if (window.trustedTypes).

ile test edebilir.

Herhangi bir politika gibi uygula: önce require-trusted-types-for 'script' ifadesini bir Content-Security-Policy-Report-Only başlığında gönder. Bir sink noktasına ulaşan her string raporlanır ve hangi satırların bir politikaya veya daha iyisi textContent ifadesine geçişe ihtiyaç duyduğunu sana tam olarak gösterir.

A yaygın bir yanlış anlaşılma: "Trusted Types HTML'i benim için temizler". Hiçbir şeyi temizlemez. Stringleri your politikanızdan geçirir. Girdisini değiştirmeden döndüren bir politika (createHTML: s => s) kontrolü geçer ve hiçbir şeyi korumaz.

Özet

  • DOM injection kendi JavaScript kodunda innerHTML gibi sink noktalarında gerçekleşir; sadece script-tag kuralları bunu yakalayamaz.
  • require-trusted-types-for 'script' düz metinlerin reddedilmesini sağlar; trusted-types NAME hangi politikaların var olabileceğini sınırlar.
  • Her sink yerine birkaç policy fonksiyonunu gözden geçir ve mümkün olduğunca textContent tercih et.
  • Tüm ana motorlarda destekleniyor (Ekim 2026 kontrol edildi); önce sadece raporlama modunda yayınla.

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.