Cloudflare WAF Geçişi
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
WAF Geçişi sekmesi, sitenizin önündeki güvenlik duvarının Otopilot tarama ve uptime isteklerini bot sanıp engellemesini önler: projeye özel bir geçiş anahtarı üretir, Cloudflare için hazır kural ifadesini ve diğer güvenlik duvarları için izin verilecek User-Agent değerini gösterir, kuralın çalışıp çalışmadığını iki gerçek istekle doğrular.
Cloudflare, Sucuri, Akamai, Imperva ya da hosting tarafındaki ModSecurity, Imunify360, LiteSpeed ve Wordfence gibi korumalar ziyaretçi olmayan istekleri challenge sayfasıyla ya da hata koduyla karşılayabilir. Bunun sonucu başarısız taramalar, sıfır sayfalı raporlar ve aslında açık olan site için gelen yanlış "site çökük" bildirimleridir. Sekme Proje Ayarları ekranındadır; başlığı WAF Geçiş Anahtarı'dır ve yanındaki rozet durumu söyler: Kapalı, Anahtar üretildi, Aktif ya da Doğrulanamadı. Sistem sitenizde bilinen bir güvenlik duvarı imzası gördüyse sekmenin üstünde "örnek.com sitesinin Cloudflare ile korunduğunu tespit ettik" biçiminde sarı bir not çıkar.
Geçiş iki yolla çalışır. Cloudflare kullanıyorsanız anahtar her isteğin özel bir başlığında taşınır ve Cloudflare'da bu başlığı arayan tek bir Custom rule, eşleşen istekleri güvenlik bileşenlerini atlayarak geçirir. Başka bir WAF ya da hosting kullanıyorsanız ekrandaki User-Agent değerine izin veren bir kural eklenir; IP adresi vermeniz gerekmez. WAF Geçişini Aktifleştir düğmesine basıldığında sitenize biri anahtarsız, biri anahtarlı iki istek gönderilir ve her ikisinin HTTP durumu ekrana yazılır. Doğrulama yalnız anahtar başlığını sınar; User-Agent kuralı Otopilot tarafından otomatik doğrulanamaz.
Sekme, sitesi bir güvenlik duvarının arkasında olan herkes için ilk kurulum adımlarından biridir; özellikle Bot Fight Mode ya da yüksek Security Level açık Cloudflare sitelerinde taramaların sağlıklı tamamlanmasını sağlar. Anahtar üretme, gösterme, yenileme ve doğrulama yalnız proje sahibine açıktır.
Sık yanlış anlama, anahtarı üretmenin tek başına yeterli olduğudur. Anahtar üretilince durum Anahtar üretildi olur ama doğrulanana kadar "Aktif" sayılmaz; Cloudflare kuralını yayınlayıp WAF Geçişini Aktifleştir ile sınamanız gerekir. Anahtarı yenilerseniz eski anahtar hemen geçersizleşir ve Cloudflare kuralını yeni değerle güncellemeniz gerekir.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Güvenlik duvarınızın (ör. Cloudflare) yönetim paneline erişiminiz olmalıdır; yoksa talimatları hosting ya da destek ekibinize iletebilirsiniz.
- Geçiş anahtarını yalnız proje sahibi üretebilir, gösterebilir, yenileyebilir ve doğrulayabilir; ekip üyeleri "Geçiş anahtarını yalnızca proje sahibi üretebilir ve doğrulayabilir." notunu görür.
- Cloudflare'da Custom rules ekleyebileceğiniz bir zone yetkisi gerekir; Super Bot Fight Mode ayarları paketinize göre değişir.
- Cloudflare dışındaki sistemler için yalnızca User-Agent talimatı verilir; bu kuralı panelinize ekleyebilmeniz ya da ekletebilmeniz gerekir.
Adım Adım Kullanım
- Projenin Proje Ayarları ekranını açıp WAF Geçişi sekmesine geçin; sekme yüklenirken "Yükleniyor…" yazar, durum alınamazsa Tekrar dene düğmesi çıkar.
- Güvenlik duvarı tespiti bölümünü okuyun: bir WAF imzası görüldüyse "Cloudflare tespit edildi." gibi bir rozet, hosting güvenlik duvarı görüldüyse kırmızı rozet ve uyarı kutusu çıkar; hiçbir imza yoksa "Tespit edilemedi." yazar.
- Geçiş Anahtarı Üret düğmesine basın; rozet Anahtar üretildi olur ve anahtar yalnız bu kez açık hâlde gösterilir. Sadece anahtar değeri kutusundaki Kopyala ile anahtarı güvenli bir yere alın.
- Cloudflare kullanıyorsanız Cloudflare panelinde yapılacaklar bölümündeki İfadeyi Kopyala düğmesiyle hazır ifadeyi kopyalayın; ifade anahtar başlığını ve anahtarın kendisini içerir.
- Cloudflare panelinde siteyi seçin, Security › Security rules yolunu açın ve Create rule › Custom rules seçeneğine girin; kural adını ekranda yazdığı gibi "Otopilot WAF Bypass" olarak verin.
- "When incoming requests match…" kutusuna kopyaladığınız ifadeyi yapıştırın; "Then take action" bölümünde Skip eylemini seçip All managed rules ve paketinizde varsa All Super Bot Fight Mode Rules seçeneklerini işaretleyin.
- "More components to skip" altında Zone Lockdown, User Agent Blocking, Browser Integrity Check, Security Level, Rate limiting rules (Previous) ve Managed rules (Previous) bileşenlerini de işaretleyin; Place at: Last ve Log matching requests varsayılan kalabilir, kuralı Deploy ile yayınlayın.
- Cloudflare dışında bir WAF ya da hosting kullanıyorsanız Başka bir WAF veya hosting kullanıyorsanız bölümündeki User-Agent'ı Kopyala düğmesiyle değeri alın ve panelinize "bu User-Agent'lı istekleri geçir" kuralı olarak ekleyin ya da ekletin.
- Kural yayına girdikten sonra WAF Geçişini Aktifleştir düğmesine basın; düğme "Doğrulanıyor…" olur ve sitenize anahtarlı ve anahtarsız iki istek gider.
- Sonuç kutusunu okuyun: yeşil kutuda "Doğrulandı: anahtarlı istek örnek.com tarafından engellenmeden geçti." ve iki isteğin HTTP kodları, kırmızı kutuda "Doğrulanamadı:" ile başlayan neden yazar. Rozet buna göre Aktif ya da Doğrulanamadı olur.
- Daha sonra anahtarı görmek için Anahtarı Göster, gizlemek için Anahtarı Gizle düğmesini kullanın; anahtar sızdıysa Anahtarı Yenile ile yenisini üretip Cloudflare kuralını güncelleyin ve doğrulamayı tekrarlayın.
Cloudflare Kuralında Atlanacak Bileşenler
- All managed rules
- All Super Bot Fight Mode Rules (paketinizde varsa)
- "More components to skip" altında: Zone Lockdown, User Agent Blocking, Browser Integrity Check, Security Level
- Rate limiting rules (Previous) ve Managed rules (Previous)
- Place at: Last ve Log matching requests varsayılan kalsın; ardından Deploy.
Önemli Notlar
- IP Access Rules ve Free Bot Fight Mode skip edilemez; bu sorun değildir.
- Super Bot Fight Mode kullanıyorsanız Security › Bots bölümünde "Definitely automated traffic" ayarını Allow yapın.
- Anahtar isteğin bir başlığında taşınır; Cloudflare Request Header Modification ile bu başlığı origin sunucunuza gitmeden silmeniz önerilir, aksi hâlde anahtar sunucu loglarınıza düşer.
- Başka bir WAF kullanıyorsanız doğrulama yalnız anahtar başlığını sınar; User-Agent izni otomatik doğrulanamaz.
Ekrandaki öğeler
- WAF Geçiş Anahtarı ve durum rozeti — Kapalı (anahtar yok), Anahtar üretildi (anahtar var, doğrulanmadı), Aktif (doğrulandı), Doğrulanamadı (son doğrulama başarısız).
- Tespit notu — sitede Cloudflare, Sucuri, Akamai ya da Imperva imzası görüldüyse sekmenin üstündeki sarı açıklama.
- Geçiş Anahtarı Üret — ilk anahtarı oluşturur; ekip üyesine gösterilmez.
- Güvenlik duvarı tespiti — WAF ve hosting güvenlik duvarı rozetleri ya da "Tespit edilemedi." notu; altında Güvenlik duvarınıza / hosting panelinize verilecek User-Agent kutusu.
- Hosting uyarısı — Hosting sunucunuzun güvenlik duvarı isteklerimizi engelliyor başlıklı kırmızı kutu.
- Geçiş anahtarınız satırı — Anahtar sonu: ile anahtarın son karakterleri, Anahtarı Göster / Anahtarı Gizle ve Anahtarı Yenile düğmeleri.
- Sadece anahtar değeri — anahtarın kopyalanabilir tam değeri; gizliyken "Gizli — tam değeri görmek için "Anahtarı Göster"e basın." yazar.
- Cloudflare panelinde yapılacaklar — Cloudflare ifadesi kutusu, İfadeyi Kopyala ve yedi adımlık kural talimatı.
- Anahtar sızıntısı uyarısı — anahtar başlığının origin sunucuya gitmeden silinmesi önerisi.
- Başka bir WAF veya hosting kullanıyorsanız — User-Agent değeri ve User-Agent'ı Kopyala.
- WAF Geçişini Aktifleştir — doğrulamayı başlatır; yanında Son doğrulama: tarihi ya da Henüz doğrulanmadı yazar.
- Sonuç kutusu — Anahtarsız istek ve Anahtarlı istek satırlarında HTTP kodu (ör. HTTP 200), yanıt yoksa "yanıt alınamadı", engellendiyse engellendi etiketi.
- Geçiş Anahtarını Yenile penceresi — yenilemenin etkisini anlatır; Evet, Yenile ve Vazgeç.
Sonuçları nasıl yorumlarsınız
- Anahtarlı istek 200 gibi başarılı bir kod döndürüyorsa geçiş çalışıyordur; anahtarsız isteğin engellenmesi sorun değil, korumanızın sürdüğünü gösterir.
- Anahtarlı istekte engellendi etiketi ve Cloudflare challenge nedeni görüyorsanız kural yayında değildir ya da ifadedeki anahtar günceli değildir.
- Anahtarlı istek 403 veya 5xx döndürüyorsa ve challenge nedeni yoksa engel büyük olasılıkla Cloudflare'ın arkasındaki sunucuda ya da hosting güvenlik duvarındadır; User-Agent izni gerekir.
- "yanıt alınamadı" ve ağ nedenleri (zaman aşımı, bağlanılamadı, çok fazla yönlendirme) güvenlik duvarından çok sitenin erişilebilirliğiyle ilgilidir.
- Rozet Aktif olduktan sonra bir sonraki taramanın sayfa sayısı önceki başarısız taramalardan belirgin biçimde yüksekse geçiş istenen etkiyi yapmıştır.
Örnek senaryo
örnek.com Cloudflare arkasında yayın yapan bir e-ticaret sitesi ve son iki taraması yalnız bir sayfa okuyup bitmiş; ayrıca "güvenlik duvarı kontrollerimizi engelliyor" bildirimi gelmiş. Proje sahibi WAF Geçişi sekmesini açıyor, üstte Cloudflare tespit notunu görüyor ve Geçiş Anahtarı Üret düğmesine basıyor. İfadeyi Kopyala ile ifadeyi alıp Cloudflare panelinde "Otopilot WAF Bypass" adlı Custom rule oluşturuyor, Skip eylemiyle listedeki bileşenleri işaretleyip kuralı Deploy ediyor. Site Super Bot Fight Mode kullandığı için Security › Bots altında "Definitely automated traffic" ayarını da Allow yapıyor.
Ardından WAF Geçişini Aktifleştir düğmesine basıyor. Sonuç kutusunda Anahtarsız istek satırı HTTP 403 ve engellendi, Anahtarlı istek satırı HTTP 200 gösteriyor; "Anahtarsız istek engellendi, anahtarlı istek geçti; kural çalışıyor." notu ve Aktif rozeti çıkıyor. Son olarak Cloudflare'da Request Header Modification ile anahtar başlığını origin'e gitmeden siliyor. Projelerim kartından başlattığı yeni tarama bu kez sitenin sayfalarını okuyarak tamamlanıyor.
İpuçları
- Anahtarı ilk üretildiği anda kopyalayın; daha sonra da Anahtarı Göster ile görebilirsiniz ama ekip içinde paylaşmanız gerekiyorsa güvenli bir parola yöneticisi kullanın.
- Cloudflare kuralını eklerken ifadeyi elle yazmayın; tırnak ya da köşeli parantez hatası kuralın hiç eşleşmemesine neden olur.
- Hosting rozeti görüyorsanız Cloudflare kuralı tek başına yetmez; User-Agent değerini hosting destek ekibine "izin listesine eklensin" notuyla iletin.
- Anahtarı yalnız sızdığından şüphelendiğinizde yenileyin; her yenilemede Cloudflare kuralını güncellemek ve yeniden doğrulamak gerekir. User-Agent kuralı yenilemeden etkilenmez.
- Cloudflare'da kural sırasını değiştirdiyseniz ya da yeni bir güvenlik ayarı açtıysanız doğrulamayı yeniden çalıştırın; Son doğrulama: tarihi son sınamanın ne zaman yapıldığını gösterir.
- Site için bir Cloudflare Worker bağlantısı kuracaksanız WAF geçişini önce tamamlamak, kanal testlerinin güvenlik duvarına takılmasını önler.
Sık yapılan hatalar
- Anahtarı üretip Cloudflare kuralını eklemeden durumun Aktif olmasını beklemek.
- Anahtarı Yenile sonrası Cloudflare'daki ifadeyi güncellemeyi unutmak; eski anahtarlı kural artık eşleşmez ve taramalar yeniden engellenir.
- Kuralda yalnız All managed rules seçeneğini işaretleyip Browser Integrity Check ve Security Level gibi ek bileşenleri atlamak.
- Anahtar başlığını origin'e geçirmeye devam edip anahtarın sunucu loglarına düşmesine izin vermek.
Sık Karşılaşılan Sorunlar
- Doğrulanamadı: Cloudflare isteği challenge ile engelledi (cf-mitigated: challenge); kural anahtarla eşleşmiyor ya da henüz yayında değil.: Kural yayında değil ya da ifade eski anahtarı içeriyor. Cloudflare'da kuralın Deploy edildiğini ve ifadenin ekrandaki güncel ifadeyle aynı olduğunu kontrol edip yeniden doğrulayın.
- Doğrulanamadı: Site anahtarlı isteğe HTTP 403 döndürdü.: İstek Cloudflare'dan geçmiş olabilir ama sunucu ya da hosting güvenlik duvarı reddediyor. User-Agent değerini hosting izin listesine ekletin; hosting rozeti çıkıyorsa sorun büyük olasılıkla oradadır.
- Anahtarsız istek engellendi, anahtarlı istek geçti; kural çalışıyor.: Beklenen ve doğru sonuçtur. Güvenlik duvarınız normal botları engellemeye devam ederken Otopilot istekleri anahtar sayesinde geçiyor.
- Şu an engel yok; kural eklendiğinde de geçeceğiz. (Anahtarsız istek de engellenmedi.): Sitenizde şu an istekleri engelleyen bir koruma yok. Durum Aktif sayılır; ileride Cloudflare korumasını sıkılaştırırsanız kural istekleri geçirmeye devam eder.
- Önce bir geçiş anahtarı üretin.: Doğrulama anahtarsız yapılamaz. Geçiş Anahtarı Üret düğmesiyle anahtarı oluşturun, kuralı ekleyin ve sonra doğrulayın.
- Çok sık denediniz; birkaç saniye bekleyip tekrar deneyin.: Doğrulama düğmesine art arda basıldı. Birkaç saniye bekleyin; Cloudflare kuralının yayılması için de kısa bir süre tanımak doğru sonucu verir.
- Doğrulanamadı: Site zaman aşımına uğradı.: Site istekleri belirlenen sürede yanıtlamadı. Sitenin tarayıcıda açıldığını kontrol edin; sunucu yavaşsa birkaç dakika sonra yeniden deneyin.
- örnek.com: güvenlik duvarı kontrollerimizi engelliyor: Bu bildirim uptime kontrolünün bir güvenlik duvarına takıldığını, bunun kesinti sayılmadığını söyler. WAF Geçişi kurulumunu tamamlayıp doğruladığınızda kontroller yeniden ölçüm yapabilir.
İlgili Kılavuzlar
Bu adımları kendi sitenizde uygulayın
Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.