Güvenlik Başlıkları Rehberi: Doğru Değer ve Doğru Sözdizimi

CSP'den HSTS'ye kadar her güvenlik başlığının doğru değeri ve sözdizimi, siteyi erişilemez hale getiren yaygın hatalarla birlikte.

6 dk Güncellendi 12 Nov 2026

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ğerYanlış etkinleştirme riski
Strict-Transport-Securitymax-age=31536000; includeSubDomainsHTTP alt alan adlarının süre dolana kadar kilitlenmesi
Content-Security-Policydefault-src 'self' + açık kaynaklarBeyaz sayfa, analitik betiklerinin bozulması
X-Content-Type-OptionsnosniffYanlış Content-Type'lı dosya artık yüklenmez
Referrer-Policystrict-origin-when-cross-originAnalitikte yönlendirme verisinin kaybı
Permissions-Policygeolocation=(), 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ı

  1. Tüm başlıkların mevcut değerini curl -sI ile kaydedin.
  2. Önce risksiz başlıkları uygulayın: X-Content-Type-Options ve Referrer-Policy.
  3. CSP'yi Report-Only modunda ayarlayın ve raporları inceleyin.
  4. HSTS'ye max-age=300 ile başlayın, bir hafta sorunsuz geçtikten sonra bir yıla çıkarın.
  5. 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.

Bu sayfa yardımcı oldu mu?