Max. Allowed Arguments ne işe yarar; bir sayfanın öğrenilmiş argüman listesi bu sayıyı aşarsa ne olur?
Kısa cevap
Max. Allowed Arguments, bir sayfa tipinin izinli ad listelerinde (Allowed query parameters, Allowed headers, Allowed form fields, Allowed JSON keys, Allowed XML keys) tutulabilecek en fazla ad sayısıdır; Checks penceresinde Argument Checks açıkken görünür ve WAF açıldığında 25'tir. Bir sayfanın izinli ad listesi bu sayıyı aşarsa o liste uygulanmaz ve sayfa o bölümde bütün adlara izin verir. Öğrenme sırasında sınırı aşan izinli ve zorunlu listeler boşaltılır ve boşalan liste sonraki öğrenmelerde yeniden doldurulmaz; elle girilmiş uzun bir izinli liste ise silinmez, yalnızca uygulanmaz. Checks kartı bunu If a page's learned argument list grows past N entries, the list check is dropped for that page cümlesiyle gösterir. Amaç, çok sayıda farklı ad kullanan sayfalarda pozitif listenin false positive üretmesini önlemektir. Değer Checks penceresinden değiştirilir ve Edit ile kaydedilir.
Sınır Aşılınca
| Yer | Sonuç |
|---|---|
| Öğrenme ve önerilerin kurala eklenmesi | Sınırı aşan izinli (Allowed) ve zorunlu (Required) listeler boşaltılır; boş liste sonraki öğrenmelerde boş kalır |
| Kuralın uygulanması | Sınırı aşan izinli ad listesi uygulanmaz (elle girilen dahil); kayıttaki liste silinmez, sınır yükseltilince yeniden uygulanır |
| Event Logs | O sayfanın o bölümünde Allowed … ihlali oluşmaz |
| Diğer denetimler | Değer uzunluğu, değer deseni, anahtar sayısı ve OWASP imza taraması sürer |
- Öğrenme sırasında Allowed Upload Mime Types ve Allowed Raw Body Mime Types listeleri de aynı sınırla birleştirilir.
- Sınır, istekte gelebilecek parametre sayısı değildir; parametre sayısı Query key count gibi yapısal denetimlerle sınırlanır.
- Max. OWASP Exclusions imza istisna listesi için benzer şekilde çalışır ("Max. Owasp Exclusions" ayarı ne işe yarar; sınır aşılırsa ne olur?).
- İzinli parametre listesinin kullanımı: Bir sayfada yalnızca izin verdiğim query parametrelerinin gelmesini nasıl sağlarım (Allowed Query Parameters)?
TR7'de Sınırı Değiştirme
Left Monitor Panel → WAF-Protected vServices → vService → WAF Management sekmesinde Inspection & Blocking bölümündeki Checks kartının sağ üstündeki kalem ikonuna tıklanır.
Max. Allowed Arguments alanına 1 ya da daha büyük bir tam sayı yazılır (ör. geniş bir API için 50). Alan yalnızca Argument Checks açıkken görünür.
Edit tıklanır; değişiklik ayrı bir dağıtım adımı olmadan uygulanır. Cluster kurulumunda varsayılan auto-sync ile eş cihaza da gönderilir; Manual Sync Mode açıksa eş cihaza elle gönderilir.
- WEB-CLI:
waf options update poolId <vService> --syncWithDefaultFwRules false --maxAllowedArguments 50(temel denetimler). - Daha önce boşalmış listeler: Sınır yükseltildikten sonra öğrenme boşalmış listeyi yeniden doldurmaz; gereken adlar sayfa tipinin kuralına elle girilir.
Sık Karıştırılan Noktalar
- "Sınır aşılınca istek engellenir." Tersine, o sayfanın o bölümünde ad listesi denetimi kalkar.
- "Sınır, bir istekte gelebilecek parametre sayısıdır." Sınır kayıtlı ad listesinin büyüklüğünü belirler; istekteki parametre sayısı yapısal denetimlerle sınırlanır.
- "Sınırı yükseltmek kaybolan listeyi geri getirir." Elle girilmiş ve yalnızca uygulanmayan liste geri gelir; öğrenmede boşaltılmış liste geri gelmez.
Dokümantasyonda nasıl yapılır
