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.
- Oturumu Başlatın: Her sayfanın en üstünde
session_start();çağrısını yapın. - Flash Mesaj Fonksiyonları:
setFlash($type, $message)– Mesajı oturuma kaydeder.getFlash()– Mesajı alır, ekrana basar ve oturumdan siler.
- CSRF Token Fonksiyonları:
generateCsrfToken()– 32 bayt rastgele veri üretir, hex olarak saklar.validateCsrfToken($token)– Gelen tokenı oturumdakiyle karşılaştırır.
- Form Oluşturma: Form içinde
<input type="hidden" name="_csrf" value="= $_SESSION['_csrf'] ?? '' ?>">ekleyin. - 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
= getFlash(); ?>
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ıpgetFlash()ile gösterilmeli ve otomatik silinmelidir. - CSRF token
bin2hex(random_bytes(32))ile güvenli bir şekilde üretilmeli. - Formda gizli
_csrfalanı bulunmalı ve sunucu tarafındahash_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.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.