Web ve Geliştirme

İçerik Güvenlik Politikası (CSP): Web Sitenizde Nasıl Kontrol Edebilir, Düzeltir ve Yapılandırabilirsiniz

Content Security Policy (CSP): How to Check, Fix and Configure It on Your Website

Apache, Nginx, WordPress ve Joomla üzerinde İçerik Güvenlik Politikası başlıklarını nasıl kontrol edebileceğinizi, ekleyebileceğinizi ve düzeltebileceğinizi, pratik tanılama araçları ve barındırma rehberliği ile öğrenin.

İçerik Güvenlik Politikası (CSP): Web Sitenizde Nasıl Kontrol Edilir, Düzeltilir ve Yapılandırılır

HTTPS ve yazılım güncellemeleri hayati öneme sahiptir, ancak bir ziyaretçinin tarayıcısında çalışacak her kötü amaçlı betiği engellemezler. İçerik Güvenlik Politikası (CSP), bir sayfanın yükleyebileceği ve çalıştırabileceği kaynaklar üzerinde tarayıcı tarafından zorlanan kısıtlamalar ekler. Belirli çapraz site betikleme (XSS) saldırılarını azaltmaya yardımcı olur, ancak bağlamsal çıkış kaçırma, giriş doğrulama veya bağımlılık güncellemelerinin yerini almaz.

Bu pratik eğitim, mevcut politikalarınızı nasıl inceleyeceğinizi, kaynağını nasıl bulacağınızı, değişiklikleri güvenli bir şekilde nasıl tanıtacağınızı ve Apache, Nginx, WordPress ve Joomla'daki sorunları nasıl düzelteceğinizi gösterir.

1. Mevcut CSP'nizi kontrol edin

Chrome veya Firefox: Sayfayı açın, F12 tuşuna basın, Ağ (Network) seçeneğini seçin, sayfayı yenileyin, HTML belgesine tıklayın ve Yanıt Başlıklarını inceleyin. Content-Security-Policy (zorunlu) veya Content-Security-Policy-Report-Only (sadece tanısal) ifadelerini arayın. İhlaller için Konsol'u kontrol edin.

Komut satırı: curl -I https://example.com/ komutunu çalıştırın. macOS/Linux'ta, yanıtı curl -sSI https://example.com/ | grep -i content-security-policy ile filtreleyin. HEAD yanıtları GET yanıtlarından farklı olabileceği için, tarayıcı Geliştirici Araçları ile doğrulayın.

Online araçlar: SecurityHeaders.com güvenlik başlıklarını kontrol eder; Google CSP Değerlendirici bir politikadaki zayıflıkları işaretler. Hiçbiri web sitesinin tamamen güvenli olduğunu kanıtlamaz.

Tek bir yanıtta CSP başlığının olmaması, her sayfanın CSP'ye sahip olmadığını kanıtlamaz. <meta http-equiv="Content-Security-Policy"> etiketini de inceleyin: meta politikalarının sınırlamaları vardır; frame-ancestors veya Report-Only desteği yoktur.

2. Politikanın tanımlandığı yeri bulun

Ortam Muhtemel konum
Apache / uyumlu LiteSpeed .htaccess, sanal konak veya sunucu yapılandırması
Nginx server / location yapılandırması
PHP header() kullanan uygulama kodu
WordPress Eklenti, özel kod, ters proxy veya barındırıcı
Joomla Sistem – HTTP Başlıkları eklentisi, sunucu veya proxy
Cloudflare Yanıt Başlığı Dönüştürme Kuralları
Yönetilen barındırma Barındırma paneli veya sağlayıcı tarafından yönetilen yapılandırma

Başka bir tane eklemeden önce mevcut yanıt başlıklarını inceleyin. Tarayıcılar birden fazla CSP politikasını kümülatif olarak uygular; yeni izin verici bir başlık, mevcut kısıtlayıcı bir başlığı iptal etmez. CDN ve barındırma kurallarını da kontrol edin.

3. Apache'de .htaccess kullanarak CSP ekleyin

Barındırıcınızın dosya yöneticisini veya SFTP'yi (FileZilla/WinSCP) kullanarak, index.php içeren genel dizini bulun; genellikle public_html veya httpdocs olur. Gizli dosyaları görünür yaparak .htaccess'yi görün. Bir yedek indirin ve CMS tarafından yönetilen yeniden yazma bloğunun içine özel kurallar koymaktan kaçının.

Apache'nin mod_headers etkinse ve barındırıcı bu yönergeleri 허용 ediyorsa, şunu ekleyin:

<IfModule mod_headers.c>
    Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>

Yenileyin ve Ağ → Başlıklar altında başlığı doğrulayın. İhlaller için Konsol'u kontrol edin. Report-Only olası kısıtlamaları bildirir ancak kaynakları engellemez. Bu örnek tanısaldır, tam bir dağıtım politikası değildir.

Güvenilir bir CDN betiği bildirilirse, önce amacını ve sahipliğini onaylayın. Yönergeyi script-src 'self' https://cdn.example.com olarak uyarlayabilirsiniz; engellenen her konağı kör körüne eklemeyin. Konak beyaz listeleri, iyi tasarlanmış nonce/hash politikalarına göre XSS'ye karşı daha az dayanıklıdır.

Giriş, formlar, ödeme, editörler ve diğer iş akışlarını test ettikten sonra, Content-Security-Policy-Report-Only'i test edilmiş politikanızı zorlayacak Content-Security-Policy ile değiştirebilirsiniz. Site bozulursa, yedeklenen dosyayı geri yükleyin, sunucu/CDN önbelleklerini temizleyin ve tekrar test edin. Düzenleme sonrası HTTP 500, sözdizimi veya sunucu izni sorunu olduğunu gösterir.

Illustration of the article's main concept

4. Nginx'te CSP'yi yapılandırın

Nginx .htaccess'i görmez. Sunucuyu yönetiyorsanız, etkin yapılandırmasını inceleyin (genellikle /etc/nginx/sites-available/ veya /etc/nginx/conf.d/). İlgili server bloğunda şunu kullanın:

add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;

sudo nginx -t ile test edin, ardından sudo systemctl reload nginx ile yeniden yükleyin. add_header mirası ve daha spesifik location'lardaki kurallara dikkat edin. Nginx yapılandırmasına erişimi olmayan yönetilen barındırmada, sağlayıcının kontrol panelini veya desteğini kullanın.

5. WordPress: eklenti veya küçük özel entegrasyon

Kod gerektirmeyen yol: Önce barındırınızın veya mevcut bir güvenlik başlığı eklentisinin zaten CSP gönderip göndermediğini kontrol edin. CSP'yi açıkça destekleyen ve tercihen Report-Only desteği olan, bakımı yapılan bir eklenti seçin; genel bir güvenlik eklentisinin her ikisini de desteklediğini varsaymayın. Ayarlarında Report-Only'yi etkinleştirin, muhafazakar bir tanısal politikayla başlayın, kaydedin ve hem genel sayfaları hem de wp-admin'i zorunlu kılmadan önce test edin.

Geliştirici yolu: wp-content/plugins/ceikay-csp/ceikay-csp.php oluşturun:

<?php
/**
 * Plugin Name: CeiKay CSP Example
 * Description: CSP diagnostics on the WordPress frontend.
 */
add_action('send_headers', function () {
    if (is_admin()) {
        return;
    }

    header(
        "Content-Security-Policy-Report-Only: "
        . "default-src 'self'; "
        . "script-src 'self'; "
        . "object-src 'none'; "
        . "base-uri 'self'"
    );
});

Eklentiler → Yüklü Eklentiler bölümünden etkinleştirin, ardından yanıt başlığını onaylayın. Bu, web sunucusundan, CDN'den veya başka bir eklentiden gelen mevcut bir CSP'yi geçersiz kılmaz. wp-admin'i kasıtlı olarak hariç tutar ve tam bir zorunlu politika sağlamaz.

Sorun giderme: Bir CAPTCHA başarısız olursa, engellenen script-src, frame-src ve connect-src isteklerini inceleyin ve CAPTCHA sağlayıcısının entegrasyon kılavuzuna bakın. Bir sayfa oluşturucu satır içi betikler engellendiğini bildirirse, CSP nonce'ları veya hash'ler için desteği kontrol edin. 'unsafe-inline''i otomatik olarak eklemeyin. Yanıt başına nonce'lar için, tam sayfa önbelleğinin aynı nonce ve HTML'i ziyaretçiler arasında yeniden kullanmadığından emin olun.

6. Joomla: yerel HTTP Başlıkları eklentisini kullanın

Joomla yönetiminde Sistem → Eklentiler'i açın, HTTP Başlıkları için arama yapın ve Sistem – HTTP Başlıkları'ı açın. Tam menü kelimesi Joomla sürümüne ve diline göre değişebilir.

CSP seçeneklerini etkinleştirin ve genel sitede Report-Only ile başlayın. script-src 'self' gibi bir yönergeyi tanılayarak başlayın; kaydedin ve Konsol'u inceleyin. Şablonları, sayfa oluşturucuları, editörleri, iletişim formları, CAPTCHA'ları, ödeme entegrasyonları ve medya özelliklerini test edin.

Refused to execute inline script görürseniz, hangi şablon veya uzantının onu oluşturduğunu tespit edin. Desteklendiği yerlerde uyumlu bir nonce veya hash yaklaşımı tercih edin; betiğin meşru olduğunu onaylamadan yetkilendirmeyin. Yönetici panelini ön yüzden ayrı test edin. Sunucu zaten CSP ayarlıysa, çelişkili politikaları yığmak yerine yapılandırmaları uzlaştırın.

Kurulu sürümünüz tarafından desteklenen seçenekler için Joomla HTTP Başlıkları belgelerine bakın.

7. Tüm politikayı değil, gerçek ihlali düzeltin

İhlal Araştırılacaklar Tipik düzeltme
script-src Harici veya satır içi JavaScript Kaynağı doğrulayın; uygun nonce/hash veya dar kapsamlı kaynak kullanın
style-src Stil sayfası veya satır içi CSS Oluşturulan stilleri inceleyin; onaylanmış kaynak veya uyumlu hash/nonce kullanın
img-src Harici görüntü veya data URL Gerekliyse sadece doğrulanmış görüntü konağına izin verin
connect-src fetch/XHR/WebSocket API kaynağını doğrulayın ve dar kapsamlı izin ekleyin
frame-src Gömülü video/CAPTCHA/ödeme çerçevesi Sağlayıcının belgelenen alan adlarını takip edin
form-action Form gönderim hedefi Meşru gönderim kaynağına izin verin
frame-ancestors Sayfanızı gömecek diğer siteler Kasten izin verilen ebeveyn kaynaklarını açıkça belirtin, veya 'none' kullanın

Örneğin, https://images.example.com/photo.webp'deki meşru bir görüntü img-src 'self' tarafından engelleniyorsa, ilgili yöneyi konağın güvenilir olduğunu onayladıktan sonra img-src 'self' https://images.example.com olarak değiştirin. Tek bir görüntüyü düzeltmek için default-src'i zayıflatmayın.

Technical workflow illustration

frame-ancestors ve form-action gibi bazı yönergeler default-src'e geri dönmez. Gerekli olduğunda bunları açıkça ekleyin.

8. Barındırma CSP yapılandırmasını etkiler mi?

Evet—CSP tarayıcı standardı aynı kalır, ancak yanıt başlıkları üzerindeki kontrolünüz değişir. Apache paylaşımlı barındırma .htaccess'i açığa çıkarabilir; yönetilen Nginx sağlayıcı panelini gerektirebilir; VPS yöneticileri sunucu yapılandırmasını değiştirebilir; ve CDN'ler uygulama yanıtı oluşturulduktan sonra başlık ekleyebilir.

Bir barındırma hizmeti seçmeden önce sorun: Root erişimi olmadan CSP başlıklarını ayarlayıp kaldırabilir miyim? Report-Only kullanabilir miyim? Nihai yanıtı inceleyebilir miyim? Özel başlıklar planımda mevcut mu? Destek, CDN veya uygulama kurallarıyla çakışmaları açıklayabilir mi?

Cloudways: barındırma seviyesi HTTP başlığı kontrolleri

Cloudways, HTTP yanıt başlıklarını (CSP dahil) yönetmek için Web Kuralları → Başlık Kuralları'nı belgelemiştir. Bu, uygulama dosyalarını düzenlemeye bir barındırma seviyesi alternatifi sunar; uygulamanız ve planınız için mevcut özelliklere tabidir. Bu otomatik olarak güvenli bir CSP oluşturmaz; yönergelerinizi yine de test etmeniz ve sürdürmeniz gerekir.

Cloudways tekliflerini inceleyin

9. Nonce tabanlı CSP ile daha güçlü koruma

Katı bir CSP, yalnızca alan adı beyaz listelerine güvenmek yerine, öngörülemez nonce'ları veya hash'leri kullanır. Basitleştirilmiş bir PHP örneği:

<?php
$nonce = base64_encode(random_bytes(16));
header(
    "Content-Security-Policy: "
    . "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
    . "object-src 'none'; "
    . "base-uri 'none'"
);

HTML şablonunda:

<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
    console.log('Trusted script');
</script>

Her yanıt için yeni bir öngörülemez nonce oluşturun. Başlığı ve HTML nonce'ını tutarlı tutun ve ters proxy'ler ile tam sayfa önbellekleri etrafında plan yapın. 'strict-dynamic' ile, güvenilir bir betik daha fazla betik yükleyebilir; bu nedenle güvenilir yükleyicileri dikkatle denetleyin. Bu bir örnektir, tüm uygulamalar için bırakın-kullanın tam bir politika değildir.

10. Son dağıtım kontrol listesi

  1. Tüm mevcut CSP başlıklarını ve meta politikalarını belirleyin.
  2. Sunucu ve CMS yapılandırmasını yedekleyin.
  3. Betikleri, stilleri, çerçeveleri, API'leri, görüntüleri ve harici hizmetleri envantere alın.
  4. Önce Report-Only politikasını dağıtın.
  5. Her ihlali araştırın ve sadece güvenilir, gerekli davranışları yetkilendirin.
  6. Ön yüz, yönetim, giriş, ödeme, formlar ve entegrasyonları test edin.
  7. Önbelleği, nonce'ları, CDN davranışını ve yinelenen başlıkları kontrol edin.
  8. Zorunluluğu kademeli olarak etkinleştirin ve yazılım güncellemelerinden sonra izleyin.

Sonuç

Faydalı bir CSP, bir kontrol listesinden kopyalanan basit bir başlık değildir. Mevcut yapılandırmanızı inceleyin, tanımlandığı yeri bulun, Report-Only modunda test edin, kesin uyumluluk sorunlarını düzeltin ve sonra web siteniz için uygun bir politikayı zorlayın. WordPress ve Joomla yöneticileri CMS araçlarıyla başlayabilir; geliştiriciler Apache, Nginx veya PHP'yi kullanabilir; ve barındırma platformları doğrudan başlık kontrolleri sunabilir.

CSP saldırı fırsatlarını azaltır, ancak güvenli kodlama, güncellemeler, kimlik doğrulama ve izleme yanında bir katman olarak kalır.