📖 Sözlük · Terim
Content Security Policy nedir?
Kısa cevap
Content Security Policy (CSP), bir web sayfasının hangi kaynaklardan script, stil, görsel ya da iframe yükleyebileceğini tarayıcıya bildiren güvenlik başlığıdır. Sayfaya sızan zararlı bir kod çalışmaya kalkarsa, izin listesinde olmadığı için tarayıcı onu engeller.
Son güncelleme: 21 Ekim 2026 · Hazırlayan: Rebitra ekibi
Kısaca ne işe yarar?
Tarayıcı, bir sayfayı açtığında içindeki her script'i çalıştırmaya meyillidir. Sayfaya birinin yorum alanından ya da kirli bir eklentiden kod sokması durumunda, tarayıcı bu kodun sizden mi başkasından mı geldiğini kendi başına ayırt edemez. CSP bu ayrımı sunucunun söylemesini sağlar: sayfa yanıtıyla birlikte `Content-Security-Policy` başlığı gönderilir ve başlıkta "script'ler yalnızca benim alan adımdan ve şu analiz servisinden gelebilir" gibi kurallar yazılır.
Başlıktaki kurallara yönerge denir. Sık görülenler şunlardır:
- `default-src`: başka yönerge tanımlanmamış her kaynak türü için varsayılan izin listesi.
- `script-src`: JavaScript'in nereden yüklenebileceği.
- `img-src`: görsellerin nereden gelebileceği.
- `frame-ancestors`: sayfanızın başka bir sitede iframe içinde gösterilip gösterilemeyeceği.
CSP, hatalı kodu düzeltmez. Amacı, bir açık bulunduğunda zararın boyutunu sınırlamaktır. Bu yüzden tek başına değil, girdi doğrulama ve güncel yazılımla birlikte düşünülür; XSS saldırılarına karşı en etkili ikinci savunma hattı olarak anılır.
Örnekle anlatalım
Adana'da seramik ve banyo ürünleri satan bir mağazanın e-ticaret sitesini düşünün. Sitede ödeme formu, canlı destek eklentisi ve bir reklam pikseli çalışıyor. Bir gün canlı destek eklentisini sağlayan üçüncü tarafın sunucusu ele geçiriliyor ve eklentinin script dosyasına, ödeme formundaki kart bilgilerini başka bir adrese gönderen birkaç satır ekleniyor.
Sitede CSP yoksa tarayıcı bu değişmiş dosyayı sorgusuz çalıştırır. Sitede `connect-src` ve `script-src` yönergeleri düzgün tanımlıysa, kod veriyi kendi izin listenizde olmayan bir adrese göndermeye çalıştığı anda tarayıcı isteği keser ve konsola ihlal raporu yazar. Müşterinin verisi çıkmamış, siz de raporu inceleyip sorunu fark etmiş olursunuz.
Nasıl kurulur?
CSP doğrudan en katı haliyle açılmaz, çünkü sitenizin kullandığı meşru bir kaynağı unutursanız sayfa bozulur. Yaygın yol şöyledir:
- Önce `Content-Security-Policy-Report-Only` başlığıyla kuralları yalnızca raporlama modunda çalıştırırsınız.
- Gelen ihlal raporlarından meşru kaynakları ayıklayıp izin listesine eklersiniz.
- Raporlar temizlendiğinde başlığı gerçek `Content-Security-Policy` olarak etkinleştirirsiniz.
Başlık web sunucusu (Nginx, Apache), CDN ya da uygulama katmanı üzerinden eklenir.
Sık yapılan hatalar
- `unsafe-inline` ve `unsafe-eval` eklemek: Sayfa bozulmasın diye bu ifadeler eklendiğinde CSP'nin asıl koruması büyük ölçüde kaybolur. Mümkünse nonce ya da hash tabanlı izin kullanılır.
- Aşırı geniş joker kullanmak: `script-src *` demek, her yerden script yüklenebilsin demektir ve başlığı anlamsız kılar.
- Raporlamayı atlayıp doğrudan zorlamak: Ödeme ya da harita gibi kritik bir parçanın sessizce kırılmasına yol açar.
- Yeni eklenen servisleri unutmak: Sonradan kurulan bir analiz ya da sohbet aracı, izin listesine eklenmezse çalışmaz.
Sitenizin güvenlik başlıklarını gözden geçirtmek istiyorsanız web sitesi güvenliği hizmetimize bakabilirsiniz. Başlığın, saldırganı bir adım önde düşünen testlerle nasıl doğrulandığını anlamak için red team terimine göz atın.
Web Sitesi Güvenliği için ücretsiz ön görüşme: bu konuyu kendi işinize göre netleştirelim.
Bununla ilgili diğer sorular
CSP eklemek sitemi yavaşlatır mı?
Hayır, fark edilir bir yavaşlama yapmaz. Başlık birkaç yüz bayttan oluşur ve kuralları tarayıcı kendi içinde değerlendirir. Asıl risk hız değil, yanlış yazılmış bir kuralın meşru bir script'i engellemesidir.
CSP varsa siteme zararlı kod giremez mi?
Girmesi engellenmez; çalışması ve veri göndermesi sınırlanır. CSP bir ek koruma katmanıdır. Açığın kendisini kapatmak için kod güvenliği, güncellemeler ve girdi doğrulama yine gereklidir.