OpenLiteSpeed'de ModSecurity ve OWASP Core Rule Set kurulumu
5 dk okuma
OpenLiteSpeed'in kendi ModSecurity modülü vardır. Güncel OWASP CRS 4 ile nasıl kurulur, günlükler nerededir, yalnızca tek bir sanal sunucu için nasıl açılır ve nginx'ten farkı nedir. Ubuntu 26.04'te denendi.
OpenLiteSpeed, nginx ile aynı web uygulama güvenlik duvarını çalıştırabilir: ModSecurity 3 motoru ve OWASP Core Rule Set (CRS). Kurallar aynıdır. Farklı olan; modülün nasıl kurulduğu, nasıl yapılandırıldığı ve günlüklerin nereye gittiğidir.
Buradaki her komutu 12 Kasım 2026'da, OpenLiteSpeed 1.9.4 kurulu yeni bir Ubuntu 26.04.1 sisteminde çalıştırdık.
Kısaca
- Modül ayrı bir pakettir: LiteSpeed'in deposundaki
ols-modsecurity. - CRS dahil değildir. Güncel sürümü (4.30.0) CRS projesinden indirin.
- Modül
httpd_config.confiçinde birmodule mod_security { … }bloğuyla yapılandırılır. - Engellenen istekler ayrı bir ModSecurity hata günlüğüne değil, OpenLiteSpeed'in kendi
error.logdosyasına yazılır. SecRuleEngine DetectionOnlyile başlayın, günlük temizleninceOnyapın.
1. Modülü kurun
LiteSpeed'in deposu zaten ekliyse (OpenLiteSpeed'i oradan kurduysanız eklidir):
sudo apt-get install ols-modsecurity
ls /usr/local/lsws/modules | grep security
mod_security.so
Bizim sistemimizde iki paket de 1.9.4-3+resolute sürümündeydi. Modül sunucunun sürümünü izler; ikisini birlikte güncelleyin.
2. Kuralları alın
sudo mkdir -p /usr/local/lsws/conf/modsec && cd /usr/local/lsws/conf/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
sudo tar -xzf coreruleset-$V-minimal.tar.gz
sudo cp coreruleset-$V/crs-setup.conf.example crs-setup.conf
Ubuntu'daki nginx paketinden farklı olarak ols-modsecurity size temel bir modsecurity.conf vermez. Önerilen dosyayı ModSecurity projesinden alın:
sudo curl -sLo modsecurity.conf https://raw.githubusercontent.com/owasp-modsecurity/ModSecurity/v3/master/modsecurity.conf-recommended
sudo curl -sLo unicode.mapping https://raw.githubusercontent.com/owasp-modsecurity/ModSecurity/v3/master/unicode.mapping
Denetim günlüğünü OpenLiteSpeed'in günlük dizinine yönlendirin. modsecurity.conf içinde:
SecAuditLog /usr/local/lsws/logs/modsec_audit.log
Sonra aynı dizinde main.conf dosyasını oluşturun:
Include /usr/local/lsws/conf/modsec/modsecurity.conf
Include /usr/local/lsws/conf/modsec/crs-setup.conf
Include /usr/local/lsws/conf/modsec/coreruleset-4.30.0/rules/*.conf
3. Modülü yükleyin
/usr/local/lsws/conf/httpd_config.conf dosyasına ekleyin:
module mod_security {
modsecurity on
modsecurity_rules_file /usr/local/lsws/conf/modsec/main.conf
ls_enabled 1
}
ve yeniden başlatın:
sudo /usr/local/lsws/bin/lswsctrl restart
Sunucu düzeyindeki ls_enabled 1, WAF'ı bütün sanal sunucular için açar.
4. Önce tespit kipi
Önerilen yapılandırma SecRuleEngine DetectionOnly ile başlar: istekler denetlenir ve günlüğe yazılır, hiçbir şey engellenmez.
curl -s -o /dev/null -w '%{http_code}\n' "http://127.0.0.1:8088/?id=1%27%20OR%20%271%27=%271"
200
Eşleşme /usr/local/lsws/logs/modsec_audit.log dosyasındadır. Siteyi gerçek kullanımla yaklaşık bir hafta böyle bırakın ve günlükte görünen her olağan işlemi not edin.
5. Engellemeye geçin
modsecurity.conf içinde:
SecRuleEngine On
yazın ve OpenLiteSpeed'i yeniden başlatın. Bizim sistemimizde:
| İstek | Yanıt |
|---|---|
| Olağan sayfa | 200 |
?id=1' OR '1'='1 (SQL enjeksiyonu) |
403 |
?q=<script>alert(1)</script> (XSS) |
403 |
Engelleme nereye yazılır
nginx'ten en çok ayrılan kısım budur. OpenLiteSpeed, ModSecurity'nin iletilerini kendi error.log dosyasına, INFO düzeyinde ve sanal sunucunun adıyla yazar:
[INFO] [127.0.0.1:56976#Example] [Module:mod_security]Intervention status code triggered: 403
[INFO] [127.0.0.1:56976#Example] [Module:mod_security]Log Message: [client 127.0.0.1] ModSecurity: Access denied with code 403 (phase 2). Matched "Operator `Ge' with parameter `5' against variable `TX:BLOCKING_INBOUND_ANOMALY_SCORE' (Value: `20' ) [file ".../REQUEST-949-BLOCKING-EVALUATION.conf"] [id "949110"]
Bundan iki sonuç çıkar:
- Sunucunun günlük düzeyi
INFO'nun üstündeyse bu satırları görmezsiniz. Denetim günlüğünü açık tutun. - 949110, puanı toplayıp engelleyen kuraldır. Sorunu bulan kurallar, hemen öncesindeki
Warningsatırlarıdır. Puanın nasıl işlediği için nginx'te ModSecurity ve OWASP CRS yazısına bakın.
Yalnızca tek bir sanal sunucu
Bazı siteleri koruyup bazılarını korumamak için kuralları sunucu düzeyinde yükleyin ama kapalı bırakın:
module mod_security {
modsecurity on
modsecurity_rules_file /usr/local/lsws/conf/modsec/main.conf
ls_enabled 0
}
ve modülü sanal sunucunun kendi yapılandırmasında açın:
module mod_security {
ls_enabled 1
}
Sanal sunucu kendi kurallarını da taşıyabilir. Diğerleri engellerken bir siteyi tespit kipinde tutmak için:
module mod_security {
ls_enabled 1
modsecurity_rules `
SecRuleEngine DetectionOnly
`
}
Zefily'nin OpenLiteSpeed sunucularında kullandığı düzen budur: kurallar bir kez yüklenir, her site kendi sanal sunucusunda açılır.
Yanlış alarmlar
Motor aynı olduğu için istisnalar nginx'tekiyle birebir aynı çalışır. Bir dosyaya yazın ve main.conf içinde CRS kurallarından önce ekleyin:
SecRule REQUEST_URI "@beginsWith /admin/editor" \
"id:1000,phase:1,pass,nolog,ctl:ruleRemoveTargetById=942100;ARGS:id"
İstisnaları dar tutun: tek kural, tek parametre, tek yol.
Güncellemeler
ols-modsecurity ve openlitespeed, aynı sürüm numarasını taşıyan ayrı paketlerdir. Tek adımda güncelleyin ki modül her zaman sunucuyla eşleşsin.
Zefily ile
OpenLiteSpeed kurulu bir Zefily sunucusunda, web yığınındaki WAF kur modülü ve sağlama toplamı doğrulanmış, sabitlenmiş CRS sürümünü kurar. Sonra her site kendi sayfasında Kapalı, Yalnız tespit ya da Engelle seçer. Erişim, önbellek ve koruma belgesine bakın.
Hangi web sunucusunu kullanacağınızdan emin değil misiniz? nginx mi OpenLiteSpeed mi yazısına bakın.
Sık sorulan sorular
OpenLiteSpeed ModSecurity'yi destekliyor mu?
Evet. ols-modsecurity paketi mod_security modülünü ekler; bu modül ModSecurity 3 motorunu çalıştırır ve OWASP Core Rule Set'i yükleyebilir.
OpenLiteSpeed'de ModSecurity günlükleri nerede?
Engellemeler OpenLiteSpeed'in error.log dosyasına INFO düzeyinde yazılır. Ayrıntılı denetim günlüğü SecAuditLog'un gösterdiği yerdedir; örneğin /usr/local/lsws/logs/modsec_audit.log.
ModSecurity'yi yalnızca tek bir OpenLiteSpeed sanal sunucusu için açabilir miyim?
Evet. Kuralları sunucu düzeyinde ls_enabled 0 ile yükleyin ve korumak istediğiniz sanal sunucunun modül bloğunda ls_enabled 1 yazın.
OpenLiteSpeed ile hangi OWASP CRS sürümü çalışıyor?
CRS 4.30.0'ı Ubuntu 26.04'te OpenLiteSpeed 1.9.4 ve onun ModSecurity modülüyle denedik. Tespit ve engelleme ikisi de çalıştı.
Yapılandırma nginx'tekiyle aynı mı?
Kurallar ve istisnalar aynıdır. Modül, nginx server bloğu yerine httpd_config.conf içinde yüklenir ve iletiler OpenLiteSpeed'in kendi günlüğüne gider.
Zefily'nin kurduğu web sunucuları için Web yığını belgesine bakın.