Siteyi açıyorsunuz ve sayfa beyaz. Tarayıcı konsolu Refused to load the script ile dolu ve sunucuya hiçbir istek ulaşmıyor. Ya da daha kötüsü: Strict-Transport-Security başlığını bir yıllık max-age ile ayarladınız ve şimdi yalnızca HTTP'ye sahip bir alt alan adı erişilemez hale geldi. Sorun neredeyse her zaman başlığın adında değil, değerindedir. Bu metin değerlerin referansıdır: her güvenlik başlığı doğru sözdizimi, gerçek etkisi ve yanlış etkinleştirmeyle göze alacağınız riskle birlikte.
Güvenlik başlığı nedir ve tarayıcı onunla ne yapar
Güvenlik başlığı, HTTP yanıtındaki bir satırdır ve tarayıcıya hangi kaynağı yükleyip hangisini yüklemeyeceğini ve hangi koşullarda yükleyeceğini söyler. Bu satırı sunucunuz değil, tarayıcı uygular. Yani değer yanlışsa sunucu sağlıklı çalışır ve yalnızca kullanıcı hiçbir şey görmez. Bu da hata ayıklamayı 500 hatasından daha zor hale getirir.
Mevcut değeri görmek için ham bir istek gönderin:
curl -sI https://example.com | grep -iE 'strict-transport|content-security|x-frame|x-content-type|referrer|permissions'
Çıktı boşsa hiçbir güvenlik başlığı ayarlanmamıştır. Bir değer görürseniz, değiştirmeden önce onu bir yere kopyalayın. Bozuk bir CSP'yi önceki sürümü olmadan geri almak pek keyifli bir iş değildir.
Her güvenlik başlığının önerilen değeri
Strict-Transport-Security
Tarayıcıyı belirli bir süre boyunca yalnızca HTTPS kullanmaya zorlar. Sözdizimi:
Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
max-age saniye cinsindendir; 31536000 bir yıl demektir. includeSubDomains seçeneğini yalnızca tüm alt alan adları geçerli HTTPS'e sahipse ekleyin. Burada hata yapıyorlar: başlığı ana alan adına includeSubDomains ile ayarlıyorlar ve sonra dahili panel için eski bir alt alan adının HTTP üzerinde olduğunu hatırlıyorlar. Sonuç şu olur: o panel tüm güncel tarayıcılarda açılmaz ve geri dönüş yolu da yoktur, çünkü tarayıcı max-age süresi dolana kadar HTTP'ye güvenmez. Emin değilseniz, önce max-age=300 ile başlayın ve bir hafta sorunsuz geçtikten sonra sayıyı yükseltin.
preload seçeneğini yalnızca preload listesine kaydolmayı planlıyorsanız ekleyin; o listeden çıkarılması aylar sürer.
Content-Security-Policy
En zor ve en işlevsel başlık. Betik, stil, görsel ve çerçevenin nereden yüklenmesine izin verildiğini belirler. Muhafazakâr ve kullanılabilir bir değer:
Content-Security-Policy: default-src 'self'; script-src 'self' https://cdn.example.com; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; frame-ancestors 'self'; base-uri 'self'; form-action 'self'
Pratikte karşılaşacağınız iki nokta. Birincisi, script-src içindeki 'unsafe-inline' neredeyse tüm XSS korumasını etkisiz kılar; satır içi betik enjekte eden WordPress veya başka bir CMS'niz varsa, 'unsafe-inline' açmak yerine nonce kullanın. İkincisi, frame-ancestors X-Frame-Options'ın yerini alır ve günümüz tarayıcılarında önceliklidir.
CSP'yi asla doğrudan üretim ortamında default-src 'none' ile başlatmayın. Önce aynı politikayı Content-Security-Policy-Report-Only ile uygulayın, raporları birkaç gün okuyun, sonra devreye alın. Bu ikisi arasındaki fark yalnızca bir kelimedir ve sonuçları arasındaki fark bir sitenin erişilemez hale gelmesi olabilir.
X-Content-Type-Options
X-Content-Type-Options: nosniff
Yalnızca bir geçerli değeri vardır: nosniff. MIME sniffing'i engeller, yani tarayıcı dosya türünü içeriğinden tahmin etmeye kalkışmaz. Yanlış uzantıyla sunulan yüklenmiş dosyalar varsa, bu başlık bir görselin çalıştırılabilir betiğe dönüşmesini engeller. Bedeli şudur: sunucunuz yanlış Content-Type gönderiyorsa, dosya artık "zorla" çalışmaz ve sunucu başlığını düzeltmeniz gerekir.
Referrer-Policy
Referrer-Policy: strict-origin-when-cross-origin
Yeni tarayıcıların varsayılan değeri budur, ancak daha zayıf bir değere sahip eski sitelerde açıkça yazılması gerekir. Analitikte yönlendiren istatistikleri sizin için önemliyse no-referrer koymayın; o değer her şeyi kaldırır ve raporlarda gelen trafiği kör eder. URL'lerinde hassas bağlantılar (şifre sıfırlama token'ı) bulunan siteler için no-referrer tüm alan adında değil, yalnızca o yolda mantıklıdır.
Permissions-Policy
Permissions-Policy: geolocation=(), camera=(), microphone=()
Tarayıcı API'lerine erişimi kapatır. Boş parantez hiç kimse için, alan adının kendisi dahil, anlamına gelir. Sitenizde sohbet veya harita widget'ı varsa () değil geolocation=(self) koyun.
Değer karşılaştırma tablosu
| Başlık | Önerilen değer | Yanlış etkinleştirme riski |
|---|---|---|
| Strict-Transport-Security | max-age=31536000; includeSubDomains | HTTP alt alan adlarının süre dolana kadar kilitlenmesi |
| Content-Security-Policy | default-src 'self' + açık kaynaklar | Beyaz sayfa, analitik betiklerinin bozulması |
| X-Content-Type-Options | nosniff | Yanlış Content-Type'lı dosya artık yüklenmez |
| Referrer-Policy | strict-origin-when-cross-origin | Analitikte yönlendirme verisinin kaybı |
| Permissions-Policy | geolocation=(), camera=() | Etkileşimli widget'ların çalışmaması |
Nerede ayarlamalı: web sunucusu mu uygulama mı
Nginx'iniz varsa başlıkları uygulama kodunda değil, server bloğunda koyun. Avantajı, PHP veya Node'un hiç çalışmadığı statik dosyalarda da uygulanmasıdır:
add_header Content-Security-Policy "default-src 'self'" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
always kelimesini atlamayın. O olmadan Nginx başlığı hata yanıtlarına (4xx ve 5xx) eklemez ve o hata sayfaları da korumasız kalır.
Apache'de karşılığı .htaccess veya vhost yapılandırmasındaki Header always set'tir. WordPress kullanıyorsanız ve tema koduna dokunmak istemiyorsanız, WordPress siteleri için eksiksiz güvenlik başlığı yapılandırma rehberi eklenti ve yapılandırma yolunu adım adım ele alır.
Nadiren karşılaşılan ama can sıkıcı pratik bir kısıtlama: CDN kullanıyorsanız, bazı başlıkları CDN yeniden yazar veya kaldırır. Her zaman sunucunun içinden değil, ağın dışından curl -sI ile test edin.
Canlı sitede doğru çalışma sırası
- Tüm başlıkların mevcut değerini
curl -sIile kaydedin. - Önce risksiz başlıkları uygulayın:
X-Content-Type-OptionsveReferrer-Policy. - CSP'yi
Report-Onlymodunda ayarlayın ve raporları inceleyin. - HSTS'ye
max-age=300ile başlayın, bir hafta sorunsuz geçtikten sonra bir yıla çıkarın. - Her değişiklikten sonra kilit bir sayfayı ve bir formu elle test edin.
Siteniz hacimsel saldırıların hefiyse, güvenlik başlığı bunu engellemez; o katman başka bir yerdedir. DDoS koruması ağ katmanında çalışır ve bu başlıkların tamamlayıcısıdır, yerine geçmez.
Giriş formu veya yönetim paneli olan siteler için güvenlik başlığı işin yalnızca yarısıdır. İki adımlı kimlik doğrulamayı etkinleştirmeyi ciddiye alın, çünkü CSP şifrenin çalınmasını engellemez.
SSL hatanız veya eksik zinciriniz varsa, önce onu çözün; HSTS kusurlu sertifika üzerinde sorunu yalnızca daha kalıcı hale getirir. Tarayıcıda SSL hatası sorun giderme doğru başlangıç noktasıdır. Ve hangi IP'lerin sitenize saldırdığını bilmek istiyorsanız, Kötü amaçlı IP engelleme kontrol paneli ve güvenlik duvarı yöntemlerini açıklar.
Sık sorulan sorular
Güvenlik başlığı site hızını düşürebilir mi?
Hayır, hız üzerinde doğrudan bir etkisi yoktur. Başlık yanıta yalnızca birkaç bayt ekler. Tek dolaylı etki, CSP bir kaynağı engellerse tarayıcının yeniden istek göndermesidir ve bu ek gidiş geliş yükleme süresini artırır. Bu da başlığın doğasında olan bir maliyet değil, yanlış CSP'nin işaretidir.
CSP ayarladıktan sonra sayfa neden beyaz oldu?
Çünkü default-src değerini 'self' veya 'none' olarak ayarladınız ve siteniz betiği veya fontu başka bir alan adından (CDN, Google Fonts, analitik servisi) alıyor. Tarayıcı konsolu engellenen adresi tam olarak gösterir. Tüm CSP'yi kaldırmak yerine o alan adını ilgili direktife ekleyin.
X-Frame-Options ile frame-ancestors arasındaki fark nedir?
X-Frame-Options daha eskidir ve yalnızca DENY, SAMEORIGIN ve ALLOW-FROM olmak üzere üç değer kabul eder; sonuncusu birçok tarayıcıda desteklenmez. frame-ancestors CSP içinde daha yenidir, birden fazla alan adı kabul eder ve önceliklidir. İkisini de ayarlarsanız, yeni tarayıcılar frame-ancestors'ı uygular.
Tüm başlıkları aynı anda etkinleştirmeli miyim?
Hayır. Her başlığı ayrı ayrı ekleyin ve her birinden sonra siteyi test edin. Birkaç başlığı aynı anda etkinleştirmek, bir şey bozulduğunda suçluyu bulmayı birkaç dakikadan birkaç saate çıkarır. Önerilen sıra önceki bölümde verilmiştir.
Bu metinden yalnızca bir şey akılda kalacaksa, şu olsun: HSTS'deki max-age ve CSP'deki default-src değerini üretim ortamında uygulamadan önce bir alt alan adında test edin. Bu ikisini geri almak diğer tüm başlıklardan daha zordur.