Tutorial

CSRF Nedir? SameSite Cookie ve Token ile Korunma

Mehmet Fatih Ünal
2 Kasım 2026
6 dk okuma
#CSRF#SameSite#Cookie#Web Güvenliği#HTTP#Kimlik Doğrulama
CSRF Nedir? SameSite Cookie ve Token ile Korunma

CSRF nedir ve oturum çerezi neden yeterli değildir?

CSRF, saldırganın başka bir sitedeki oturumu açık kullanıcının tarayıcısına istenmeyen bir işlem göndertmesidir. Tarayıcının hedef siteye ait çerezi otomatik eklemesi, o işlemin kullanıcı tarafından istendiğini kanıtlamaz. MDN CSRF rehberi, bu saldırının istek ve oturum ilişkisini açıklar.

Bir hesap ayarının değiştirilmesi için yalnızca geçerli oturum çerezine bakıldığını düşünün. Sunucu kullanıcının kim olduğunu tanıyabilir, fakat isteğin kendi formundan mı başka bir sayfadan mı geldiğini henüz doğrulamamıştır. Kimlik doğrulama ile işlem niyeti aynı soru değildir.

SameSite Lax, Strict ve None neyi değiştirir?

SameSite, çerezin farklı site bağlamlarındaki isteklere eklenip eklenmeyeceğini belirler. Strict daha sınırlayıcıdır; Lax belirli güvenli üst seviye gezinmelere izin verir; None ise farklı site bağlamında gönderime izin verir ve Secure gerektirir. Set-Cookie referansı, bu kuralları ve tarayıcı varsayımlarındaki farkları belgeler.

Aşağıdaki başlık, HTTPS üzerinden verilen örnek bir oturum çerezini gösterir. Değer gerçek bir oturum bilgisi değildir:

Set-Cookie: __Host-session=example-session-value; Path=/; Secure; HttpOnly; SameSite=Lax

__Host- öneki destekleyen tarayıcılarda Secure, Path=/ ve Domain alanının bulunmaması gibi koşullar getirir. HttpOnly, JavaScript'in çerezi okumasını sınırlar; tarayıcının isteğe çerez eklemesini engellemez.

SameSite'ı açıkça belirleyin. Varsayılan davranışı bütün tarayıcılarda aynı kabul etmeyin. Lax kullanılan bir uygulamada durum değiştiren GET uç noktaları hâlâ sorun oluşturabilir; veri değiştiren işlemleri güvenli okuma metoduna yerleştirmeyin.

Aynı site ile aynı origin aynı şey mi?

Aynı site ile aynı origin farklı sınırlar tanımlar. Örneğin https://app.example.com ve https://uploads.example.com farklı origin'lerdir, fakat aynı site kapsamındadır. Bir alt alan adındaki güvenilmeyen içerik bu ayrımı önemli hale getirir.

Bu nedenle SameSite, tek başına bütün alt alan adı risklerini çözmez. OWASP CSRF önleme rehberi, bu sınırları ve ek savunmaları açıklar. Oturum çerezini tek host'a sınırlamak da hedef host'a yapılan isteğin niyetini kendiliğinden doğrulamaz.

CSRF token nasıl kullanılmalıdır?

CSRF token, meşru sayfanın isteğe eklediği ve sunucunun doğruladığı tahmin edilemez bir değerdir. Kullanılan çatı bu korumayı sağlıyorsa, yeni bir token sistemi tasarlamadan önce onun yerleşik mekanizmasını kullanın.

Bu HTML bir sunucu şablonu örneğidir. csrfToken, sunucunun ürettiği ve güvenli biçimde yerleştirdiği değeri temsil eder; yer tutucuyu sabit bir token olarak kullanmayın.

<form method="post" action="/settings/email">
  <input type="hidden" name="csrfToken" value="{{ csrfToken }}" />
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <button type="submit">Save</button>
</form>

Sunucu, eksik veya geçersiz token'ı veri değişikliği başlamadan reddetmelidir. Token'ı yalnızca sayfada üretmek, gönderilen değeri kontrol etmeyen uç noktayı korumaz. Senkronize token yaklaşımında değer oturumla ilişkilendirilir; başka bir oturumun token'ı kabul edilmemelidir.

Token'ı sorgu dizisine koymak yerine form alanı veya uygun istek başlığıyla taşıyın. JSON uç noktalarında özel başlık kullanmak yararlı olabilir, fakat sunucu bu başlığı ve seçilen koruma yöntemini gerçekten zorunlu tutmalıdır. Basitçe bir başlık adı seçmek koruma sağlamaz.

CORS veya Origin kontrolü token yerine geçer mi?

CORS, başka origin'deki JavaScript'in yanıtı okuma iznini düzenler; bazı istekler yanıt okunamasa da sunucuya ulaşabilir. Bu yüzden yalnızca izin vermeyen CORS başlığına güvenmek, işlemin gerçekleşmediğini göstermez. CORS rehberi, preflight ile gerçek yanıt denetimini ayırır.

Origin ve gerektiğinde Referer denetimleri, istek kaynağını sunucu tarafında değerlendirmek için kullanılabilir. Beklenen origin'i tam eşleşmeyle kontrol edin; alan adı içindeki bir kelimeyi aramak yeterli değildir. Başlığın bulunmadığı durumlar ve meşru dış entegrasyonlar için açık bir politika tanımlayın.

Fetch Metadata başlıkları da isteğin bağlamı hakkında ek bilgi verir. web.dev Fetch Metadata rehberi, Sec-Fetch-Site gibi alanlarla kaynak yalıtımını anlatır. Eksik başlıkları otomatik olarak güvenilir saymak veya bütün API istemcilerini tek kuralla reddetmek yerine, uygulamanın desteklediği istemcileri hesaba katın.

CSRF koruması nasıl doğrulanır?

CSRF kontrolü, yalnızca başarısız yanıta bakmakla doğrulanmaz. Reddedilen isteğin kalıcı bir değişiklik yapmadığını da kontrol edin.

  1. Geçerli oturum ve token ile meşru formun çalıştığını doğrulayın.
  2. Eksik, değiştirilmiş ve başka oturuma ait token'ları reddedin.
  3. Farklı origin ve aynı site kapsamındaki alt alan adı senaryolarını ayırın.
  4. GET uç noktalarının veri değiştirmediğini, geri gezinmenin ve birden fazla sekmenin bozulmadığını kontrol edin.

Uç nokta kaynak yetkisini de kontrol etmelidir: geçerli token, başka kullanıcının hesabını değiştirme izni değildir. Yetkilendirme rehberi, bu ayrı erişim kararını açıklar.

Sık sorulan sorular

HttpOnly CSRF'yi engeller mi? Tek başına hayır. Çerezin okunmasını sınırlar, otomatik gönderimini durdurmaz.

SameSite=None kullanmak her zaman hata mı? Hayır. Bazı entegrasyonlar bunu gerektirebilir; uygun ek korumalarla birlikte tasarlanmalıdır.

CSRF token XSS'yi çözer mi? Hayır. Aynı origin'de çalışabilen saldırgan kod, CSRF savunmasını da etkisizleştirebilir. Bu iki risk ayrı ele alınmalıdır.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar