nginx'te ModSecurity ve OWASP Core Rule Set kurulumu (Ubuntu 26.04)
6 dk okuma
nginx'e ModSecurity 3 ve güncel OWASP CRS 4 nasıl kurulur, tespit kipinde nasıl başlanır, engellemeye nasıl geçilir ve güvenlik duvarını kapatmadan yanlış alarmlar nasıl giderilir. Her adım Ubuntu 26.04'te denendi.
Web uygulama güvenlik duvarı (WAF), her isteği uygulamanızdan önce okur ve saldırıya benzeyenleri reddeder: SQL enjeksiyonu, siteler arası betik çalıştırma (XSS), /etc/passwd okuma denemeleri. ModSecurity motordur. OWASP Core Rule Set (CRS) ise ona saldırının neye benzediğini söyleyen kural listesidir.
Bu rehber ikisini nginx'e kurar. Her komutu 12 Kasım 2026'da, yeni kurulmuş bir Ubuntu 26.04.1 sisteminde çalıştırdık.
Kısaca
- Ubuntu'dan
libnginx-mod-http-modsecuritypaketini kurun. ModSecurity 3.0.14 ile gelir. - Ubuntu'nun paketlediği CRS'yi kullanmayın. Sürümü 3.3.8'dir. Güncel sürüm 4.30.0; CRS projesinden indirin.
DetectionOnlykipinde başlayın. Neyi engelleyeceğini günlüğe yazar, hiçbir şeyi engellemez.- Günlük bir hafta temiz kaldıktan sonra
Onyapın. - Yanlış alarmları WAF'ı kapatarak değil, dar bir istisnayla giderin (tek kural, tek parametre, tek yol).
1. Modülü kurun
sudo apt-get install nginx libnginx-mod-http-modsecurity
Ubuntu 26.04'te bu şunları kurar:
| Paket | Sürüm |
|---|---|
| nginx | 1.28.3 |
| libnginx-mod-http-modsecurity (bağlayıcı) | 1.0.3 |
| libmodsecurity3t64 (motor) | 3.0.14 |
| modsecurity-crs | 3.3.8 |
Modül /etc/nginx/modules-enabled/ içinde etkinleşir ve paket /etc/nginx/modsecurity.conf dosyasına temel bir yapılandırma koyar.
Tablonun son satırı tuzaktır. modsecurity-crs 3.3.8 bağımlılık olarak gelir, ama 3.3 dalı eskidir. Onu yüklemeyeceğiz.
2. Güncel Core Rule Set'i alın
sudo mkdir -p /etc/nginx/modsec && cd /etc/nginx/modsec
V=4.30.0
sudo curl -sLO https://github.com/coreruleset/coreruleset/releases/download/v$V/coreruleset-$V-minimal.tar.gz
sha256sum coreruleset-$V-minimal.tar.gz
3d678a41fd5aade34760127fef5dd64fd7a77848913fc0f70dde0cf467c94427 coreruleset-4.30.0-minimal.tar.gz
Sağlama toplamını sürüm sayfasındakiyle karşılaştırın, sonra açın:
sudo tar -xzf coreruleset-$V-minimal.tar.gz
sudo cp coreruleset-$V/crs-setup.conf.example crs-setup.conf
sudo cp /etc/nginx/modsecurity.conf modsecurity.conf
sudo cp /etc/nginx/unicode.mapping .
Şimdi her şeyi doğru sırayla yükleyen tek bir dosya oluşturun: /etc/nginx/modsec/main.conf
Include /etc/nginx/modsec/modsecurity.conf
Include /etc/nginx/modsec/crs-setup.conf
Include /etc/nginx/modsec/coreruleset-4.30.0/rules/*.conf
3. Bir site için açın
Sitenin server bloğunda:
server {
server_name example.test;
root /var/www/html;
modsecurity on;
modsecurity_rules_file /etc/nginx/modsec/main.conf;
}
sudo nginx -t && sudo systemctl reload nginx
nginx kaç kural yüklediğini söyler:
ModSecurity-nginx v1.0.3 (rules loaded inline/local/remote: 0/852/0)
4. Önce tespit kipi
Temel yapılandırma şununla başlar:
SecRuleEngine DetectionOnly
Bu kipte hiçbir şey engellenmez. Bir deneme saldırısı gönderin:
curl -s -o /dev/null -w '%{http_code}\n' "http://example.test/?id=1%27%20OR%20%271%27=%271"
200
İstek geçer, ama /var/log/nginx/modsec_audit.log kuralların ne gördüğünü kaydeder:
ModSecurity: Warning. detected SQLi using libinjection. [file ".../REQUEST-942-APPLICATION-ATTACK-SQLI.conf"] [id "942100"] [msg "SQL Injection Attack Detected via libinjection"] [data "Matched Data: s&sos found within ARGS:id: 1' OR '1'='1"]
Siteyi gerçek trafikle yaklaşık bir hafta bu kipte bırakın. Yönetim alanını kullanın, yazı kaydedin, dosya yükleyin, ödeme adımını çalıştırın. Günlükte olağan bir işleme ait her kayıt, engellemeye geçmeden önce gidermeniz gereken bir yanlış alarmdır.
5. Engellemeye geçin
/etc/nginx/modsec/modsecurity.conf içinde:
SecRuleEngine On
nginx'i yeniden yükleyip tekrar deneyin. Bizim sistemimizde:
| İstek | Yanıt |
|---|---|
| Olağan sayfa | 200 |
?id=1' OR '1'='1 (SQL enjeksiyonu) |
403 |
?f=../../etc/passwd (dosya okuma) |
403 |
?q=<script>alert(1)</script> (XSS) |
403 |
Engellenen istek nginx'in error.log dosyasında görünür:
ModSecurity: Access denied with code 403 (phase 2). Matched "Operator `Ge' with parameter `5' against variable `TX:BLOCKING_INBOUND_ANOMALY_SCORE' (Value: `20' ) [id "949110"] [msg "Inbound Anomaly Score Exceeded (Total Score: 20)"]
CRS nasıl karar verir: anomali puanı
Bu günlük satırı başta herkesin kafasını karıştırır. 949110 numaralı kural, saldırıyı bulan kural değildir. O, hakemdir.
Eşleşen her kural isteğe puan ekler: kritik bir eşleşme için 5, daha küçük tuhaflıklar için daha az. Sonunda 949110 toplamı eşikle karşılaştırır; eşik varsayılan olarak 5'tir. XSS denememiz dört kuralla eşleşti ve 20'ye ulaştı.
Yani bir engellemenin nedenini ararken 949110'u geçin ve denetim günlüğünde ondan önceki satırları okuyun. Puanı ekleyen kurallar oradadır.
Yanlış alarmları gidermek
Diyelim ki /admin/editor adresindeki düzenleyiciniz içeriği id adlı bir parametreyle gönderiyor ve 942100 kuralı bunu işaretliyor. En iyiden en kötüye üç seçeneğiniz var.
1. Tek yolda, tek kuraldan, tek parametreyi hariç tutun. /etc/nginx/modsec/exclusions-before.conf dosyasını oluşturun:
SecRule REQUEST_URI "@beginsWith /admin/editor" \
"id:1000,phase:1,pass,nolog,ctl:ruleRemoveTargetById=942100;ARGS:id"
ve main.conf içinde CRS kurallarından önce yükleyin:
Include /etc/nginx/modsec/modsecurity.conf
Include /etc/nginx/modsec/crs-setup.conf
Include /etc/nginx/modsec/exclusions-before.conf
Include /etc/nginx/modsec/coreruleset-4.30.0/rules/*.conf
Bunu denedik: aynı SQL enjeksiyonu dizgesi /admin/editor/ adresinde 200, başka her yerde yine 403 döndürüyor.
2. WAF'ı tek bir konum için kapatın. Basittir, ama o yol korumasız kalır:
location /admin/editor/ { modsecurity off; }
Bunu yalnızca zaten giriş ve IP kısıtlaması arkasında olan yollar için yapın.
3. WAF'ı site için kapatın. İlk yanlış alarmdan sonra çoğu kişinin yaptığı budur; 4. adımın önemi de buradan gelir.
Bilinen uygulamalar için önce CRS eklentilerine bakın. Proje; WordPress, Nextcloud, phpMyAdmin ve başkaları için hazır istisna setleri yayımlar; bunlar kural setinin plugins dizinine konur.
Paranoya düzeyleri
CRS'nin dört düzeyi vardır. Düzey 1 varsayılandır ve az yanlış alarm verir. Her üst düzey daha çok kural açar ve daha çok istisna ister. Yükseltmek için crs-setup.conf dosyasına ekleyin:
SecAction "id:900000,phase:1,pass,t:none,nolog,setvar:tx.blocking_paranoia_level=2"
Site engelleme kipinde sorunsuz çalışana kadar düzey 1'de kalın.
WAF neyi yapmaz
Açığı kapatmaz. WAF, bilinen saldırı kalıplarının kullanılmasını zorlaştırır. Açığı olan eklenti hâlâ açıktır ve yeni bir yöntem geçebilir. Uygulamayı güncelleyin; WAF'ı ikinci katman sayın.
Zefily ile
Zefily'de bu bir düğme ve bir ayardır. Sunucunun web yığınındaki WAF kur, ModSecurity'yi ve sağlama toplamı doğrulanmış, sabitlenmiş CRS sürümünü kurar. Sonra her site Kapalı, Yalnız tespit ya da Engelle seçer. Zefily yeni CRS sürümlerini izler ve ajan güncellemeleriyle gönderir. Erişim, önbellek ve koruma belgesine bakın.
OpenLiteSpeed mi kullanıyorsunuz? OpenLiteSpeed'de ModSecurity ve OWASP CRS yazısına bakın.
Sık sorulan sorular
nginx ile hangi CRS sürümünü kullanmalıyım?
CRS projesinin güncel 4.x sürümünü; 12 Kasım 2026'da bu 4.30.0'dı. Ubuntu 26.04, eski bir dal olan CRS 3.3.8'i paketler.
ModSecurity 3, Ubuntu 26.04'te nginx ile çalışıyor mu?
Evet. libnginx-mod-http-modsecurity paketi, nginx 1.28 için 1.0.3 bağlayıcısını ve ModSecurity 3.0.14 motorunu kurar.
949110 kuralı nedir?
Anomali puanı eşiğe (varsayılan 5) ulaştığında isteği engelleyen CRS kuralıdır. Puanı ekleyen kurallar denetim günlüğünde ondan önce listelenir.
SecRuleEngine DetectionOnly ne yapar?
ModSecurity her isteği denetler ve eşleşmeleri denetim günlüğüne yazar, ama hiçbir şeyi engellemez. On yapmadan önce yanlış alarmları bulmak için kullanın.
ModSecurity yanlış alarmını nasıl gideririm?
Denetim günlüğünde kural numarasını bulun ve yalnızca gerekeni hariç tutun: tek yolda, tek kuraldan, tek parametre. Bunu CRS kurallarından önce yüklenen bir dosyada ctl:ruleRemoveTargetById ile yapın.
Zefily ile WAF kurulumu için Web yığını belgesine bakın.