Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 76 – Flash mesaj ve CSRF token fikri

Tek kullanımlık flash mesaj ve CSRF token üretimi ile güvenli form işleme yöntemlerini adım adım öğrenin.

Ders 76 – Flash mesaj ve CSRF token fikri

Web uygulamalarında kullanıcı deneyimini iyileştirmek ve güvenliği sağlamak iki ayrı ama birbiriyle sıkı ilişkili konudur. Bu derste, bir sonraki istekte gösterilip otomatik olarak silinen flash mesaj sistemini ve CSRF (Cross Site Request Forgery) saldırılarına karşı koruma sağlayan tek kullanımlık token mekanizmasını ayrıntılı bir şekilde inceleyeceğiz. Öğrenecekleriniz:

Flash Mesaj Nedir ve Neden Kullanılır?

Flash mesaj, bir HTTP isteği sonrasında kullanıcıya bir kez gösterilmek üzere $_SESSION içinde saklanan kısa bir bilgilendirme metnidir. Örneğin bir form gönderildiğinde "Kayıt başarılı" ya da "Hata oluştu" gibi mesajlar bir sonraki sayfa yüklemesinde ekrana basılır ve ardından oturumdan silinir. Bu sayede mesajların tekrarlı gösterilmesi engellenir.

CSRF Token Kavramı

CSRF saldırısı, bir kullanıcının oturum çerezleri üzerinden yetkisiz bir isteğin hedef siteye gönderilmesiyle gerçekleşir. Bu riski önlemek için sunucu tarafında tek kullanımlık bir token üretir ve bu tokenı formun gizli bir alanı (input type="hidden") içinde göndeririz. Sunucu, gelen istekteki tokenı oturumda saklanan tokenla karşılaştırarak isteğin geçerli olup olmadığını doğrular.

Adım Adım Uygulama

Aşağıdaki adımları takip ederek hem flash mesaj hem de CSRF token sistemini sıfırdan kuracağız.

  1. Oturumu Başlatın: Her sayfanın en üstünde session_start(); çağrısını yapın.
  2. Flash Mesaj Fonksiyonları:
    • setFlash($type, $message) – Mesajı oturuma kaydeder.
    • getFlash() – Mesajı alır, ekrana basar ve oturumdan siler.
  3. CSRF Token Fonksiyonları:
    • generateCsrfToken() – 32 bayt rastgele veri üretir, hex olarak saklar.
    • validateCsrfToken($token) – Gelen tokenı oturumdakiyle karşılaştırır.
  4. Form Oluşturma: Form içinde <input type="hidden" name="_csrf" value=""> ekleyin.
  5. Form İşleme: POST isteği geldiğinde token doğrulaması yapın, ardından flash mesajı ayarlayın.

Örnek Kod

Aşağıdaki ders76.php dosyası, tüm adımları tek bir dosyada birleştirir. Kodu kendi geliştirme ortamınıza kopyalayıp çalıştırabilirsiniz.

 $type, 'message' => $message];
}

function getFlash(): string {
    if (!isset($_SESSION['flash'])) {
        return '';
    }
    $flash = $_SESSION['flash'];
    // Mesajı gösterdikten hemen sonra oturumdan sil
    unset($_SESSION['flash']);
    $class = $flash['type'] === 'success' ? 'alert-success' : 'alert-danger';
    return "
{$flash['message']}
"; } // ---------- CSRF token fonksiyonları ---------- function generateCsrfToken(): void { // token zaten varsa yeniden üretme, aynı oturum içinde aynı kalır if (empty($_SESSION['_csrf'])) { $_SESSION['_csrf'] = bin2hex(random_bytes(32)); } } function validateCsrfToken(string $token): bool { return hash_equals($_SESSION['_csrf'] ?? '', $token); } // Token üret (ilk istekte) generateCsrfToken(); // Form gönderildi mi? if ($_SERVER['REQUEST_METHOD'] === 'POST') { $postedToken = $_POST['_csrf'] ?? ''; if (!validateCsrfToken($postedToken)) { setFlash('error', 'Geçersiz CSRF token. Lütfen sayfayı yenileyin.'); } else { // Burada gerçek iş mantığınızı (veritabanı, dosya vs.) koyabilirsiniz setFlash('success', 'Form başarıyla işlendi!'); // Tokenı bir daha kullanmamak için yenileyebiliriz unset($_SESSION['_csrf']); generateCsrfToken(); } // Post sonrası yönlendirme (POST/Redirect/GET) önerilir header('Location: ' . $_SERVER['PHP_SELF']); exit; } ?> Flash Mesaj ve CSRF Demo

Basit Form

Sık Karşılaşılan Hatalar

  • Tokenı session_destroy() gibi bir işlemle silmek, sonraki isteklerde hataya yol açar.
  • Flash mesajı $_SESSION['flash'] anahtarını yanlış yazmak (ör. flas) mesajın hiç gösterilmemesine neden olur.
  • CSRF tokenı üretirken rand() gibi kriptografik olmayan fonksiyonlar kullanmak güvenlik açığı yaratır.
  • POST/Redirect/GET (PRG) desenini uygulamazsanız, sayfa yenilendiğinde aynı form tekrar gönderilir ve flash mesaj iki kez gösterilir.

Özet ve Kontrol Listesi

Bu derste öğrendiklerinizin kısa bir özeti ve uygulamayı test ederken göz önünde bulundurmanız gereken maddeler:

  • Her sayfada session_start(); çağrısı bulunmalı.
  • Flash mesaj setFlash() ile ayarlanıp getFlash() ile gösterilmeli ve otomatik silinmelidir.
  • CSRF token bin2hex(random_bytes(32)) ile güvenli bir şekilde üretilmeli.
  • Formda gizli _csrf alanı bulunmalı ve sunucu tarafında hash_equals() ile doğrulanmalı.
  • İşlem sonrası header('Location: ...'); exit; ile PRG uygulanmalı.
  • Üretim ortamında hata mesajlarını kullanıcıya doğrudan göstermemeli, loglamayı tercih etmelisiniz.

Sık Sorulan Sorular

1. Flash mesajı birden fazla sayfada gösterebilir miyim?

Evet, fakat mesajı $_SESSION içinde bir dizi olarak tutup her sayfada bir eleman alıp silmeniz gerekir. Basit tek mesaj senaryosu için bir anahtar yeterlidir.

2. CSRF tokenı her istek için yeniden üretmek gerekir mi?

Hayır, aynı oturum içinde bir token yeterlidir. Ancak token bir kez kullanıldıktan sonra (ör. başarılı form gönderimi) yenilenmesi önerilir.

3. Tokenı JavaScript ile okuyabilir miyim?

Genel olarak tokenı sadece sunucu tarafı HTML içinde gizli alan olarak sunmak en güvenli yaklaşımdır. JavaScript ile erişmek XSS riskini artırır.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel