Tüm Ürünler
Search
Belge Merkezi

Web Application Firewall:Savunma kuralı parametreleri

Son Güncelleme:Oct 05, 2026

WAF'ta savunma kurallarını (DefenseRule) yapılandırmak için kullanılan yaygın OpenAPI parametreleri.

conditions parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

key

String

Gerekli

IP

Eşleşme alanı. Geçerli değerler: URL, URLPath, IP, Referer, User-Agent, Params, Cookie, Content-Type, Content-Length, X-Forwarded-For, Post-Body, Http-Method, Header, Extension, Filename, Server-Port, Host, Cookie-Exact, Query-Arg ve Post-Arg.

Bot gelişmiş özel kuralları ayrıca şunları destekler: Client-ID, Ja3-Fingerprint, Ja4-Fingerprint, Http2-Fingerprint, Isp-ID, WebSdk ve AppSdk.

Önemli

Kullanılabilir eşleşme alanları WAF sürümüne göre değişir. Her kural türü için desteklenen alanları WAF konsolunda kontrol edin.

subKey

String

İsteğe bağlı

abc

Özel alt alan.

Not

Tüm eşleşme alanları (key) özel bir alt alanı (subKey) desteklemez. Desteklenen kombinasyonları WAF konsolunda kontrol edin.

opValue

String

Gerekli

contain

Mantıksal işleç. Geçerli değerler:

  • not-contain: İçermez. eşleşme alanı (key) IP ise bu, IP adresinin belirtilen listede olmadığı anlamına gelir.

  • contain: İçerir. Eşleşme alanı (key) IP ise bu, IP adresinin belirtilen listede olduğu anlamına gelir.

  • none: Yok.

  • ne: Eşit değil.

  • eq: Eşittir.

  • lt: Küçüktür.

  • gt: Büyüktür.

  • len-lt: Uzunluk küçüktür.

  • len-eq: Uzunluk eşittir.

  • len-gt: Uzunluk büyüktür.

  • not-match: Eşleşmiyor.

  • match-one: Birden fazla değerden birine eşittir.

  • all-not-match: Birden fazla değerin hiçbirine eşit değil.

  • all-not-contain: Birden fazla değerin hiçbirini içermiyor.

  • contain-one: Birden fazla değerden birini içeriyor.

  • not-regex: Düzenli ifadeyle eşleşmiyor.

  • regex: Düzenli ifadeyle eşleşiyor.

  • all-not-regex: Düzenli ifadelerin hiçbirine eşleşmiyor.

  • regex-one: Düzenli ifadelerden birine eşleşiyor.

  • prefix-match: Önekle eşleşiyor.

  • suffix-match: Son ek ile eşleşiyor.

  • empty: Boş.

  • exists: Var.

  • inl: Listedeki.

  • in-list: Adres defterindeki.

  • not-in-list: Adres defterinde olmayan.

Not

Tüm mantıksal işleçler (opValue) her eşleşme alanı (key) için kullanılamaz. Her kural türü için geçerli kombinasyonları WAF konsolunda kontrol edin.

values

String

Gerekli

abc

Eşleşme içeriği. Birden fazla değeri virgülle (,) ayırın.

Not

opValue ve values için geçerli değerler, belirtilen eşleşme alanına (key) bağlıdır.

ratelimit parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

target

String

Gerekli

remote_addr

İstatistiksel nesne. Geçerli değerler:

  • remote_addr (Varsayılan): Bir IP adresi.

  • cookie.acw_tc: Bir oturum.

  • header: Özel bir üst bilgi. Üst bilgi adını subKey içinde belirtin.

  • queryarg: Özel bir parametre. Parametre adını subKey içinde belirtin.

  • cookie: Özel bir çerez. Çerez adını subKey içinde belirtin.

  • account: Bir hesap.

Aşağıdaki değerler yalnızca Bot gelişmiş özel kuralları tarafından desteklenir:

  • postarg: Özel bir gövde parametresi. Parametre adını subKey içinde belirtin.

  • websdk.umid: Web UMID'si.

  • appsdk.eeid_umid: Uygulama UMID'si.

subKey

String

İsteğe bağlı

abc

İstatistiksel nesnenin anahtar adı. target değeri cookie, header, queryarg veya postarg olduğunda gereklidir.

interval

Integer

Gerekli

60

Saniye cinsinden istatistiksel dönem. WAF, bu dönem içindeki istekleri threshold değerine göre sayar.
Geçerli aralık: 1 ila 1.800.







threshold

Integer

Gerekli

200

İstatistiksel dönemde tek bir istatistiksel nesneden korunan kaynağa yönelik maksimum istek sayısı.

ttl

Integer

Gerekli

1800

Saniye cinsinden eylem süresi.
Geçerli aralık: 60 ila 86.400.







status

JSON

İsteğe bağlı

{"code":404,"count":200}

Yanıt kodlarına dayalı hız sınırlama. Aşağıdaki alanlara sahip JSON dizesi:

  • code: Integer, gerekli. İzlenecek yanıt kodu.

  • count: Integer, isteğe bağlı. Oluşma eşiği — yanıt kodu sayısı bu değeri aştığında kural tetiklenir. Geçerli aralık: 2 ila 50.000. count veya ratio belirtin, ikisini birden değil.

  • ratio: Integer, isteğe bağlı. Yüzde eşiği — yanıt kodu yüzdesi bu değeri aştığında kural tetiklenir. Geçerli aralık: 1 ila 100. count veya ratio belirtin, ikisini birden değil.

distinctStat

Array

İsteğe bağlı

[{"key":"URL","opValue":"gt","values":"1"}]

Ayrık istatistikler için koşullar.

Not

Yalnızca Bot gelişmiş özel kuralları için desteklenir. Aşağıda açıklanan distinctStat parametrelerini kullanır.

distinctStat parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

key

String

Gerekli

IP

Eşleşme alanı. Geçerli değerler: URL, URLPath, IP, Cookie-Exact, Post-Arg, Header, Query-Arg, Ja3-Fingerprint, Ja4-Fingerprint, Http2-Fingerprint, WebSdk ve AppSdk.

Önemli

Kullanılabilir eşleşme alanları Bot Management aboneliğinize bağlıdır. Desteklenen alanları WAF konsolunda kontrol edin.

subKey

String

İsteğe bağlı

abc

Ayrık istatistik koşulu için özel alt alan.

Not

Ayrık istatistikler için tüm eşleşme alanları (key) özel bir alt alanı (subKey) desteklemez. Desteklenen kombinasyonları WAF konsolunda kontrol edin.

opValue

String

Gerekli

Equal

Mantıksal işleç. Geçerli değerler:

  • eq: Benzersiz değerlerin sayısı belirtilen değere eşittir.

  • lt: Benzersiz değerlerin sayısı belirtilen değerden küçüktür.

  • gt: Benzersiz değerlerin sayısı belirtilen değerden büyüktür.

value

String

Gerekli

abc

Benzersiz değerlerin sayısıyla karşılaştırılacak değer.

grayConfig parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

grayTarget

String

Gerekli

remote_addr

Grayscale hedefi. Kuralın hangi trafiği etkileyeceğini grayscale yüzdesine göre belirler. Geçerli değerler:

  • remote_addr (Varsayılan): Bir IP adresi.

  • cookie.acw_tc: Bir oturum.

  • header: Özel bir üst bilgi. Üst bilgi adını graySubKey içinde belirtin.

  • queryarg: Özel bir parametre. Parametre adını graySubKey içinde belirtin.

  • cookie: Özel bir çerez. Çerez adını graySubKey içinde belirtin.

Aşağıdaki değerler yalnızca Bot gelişmiş özel kuralları tarafından desteklenir:

  • websdk.umid: Web UMID'si.

  • appsdk.eeid_umid: Uygulama UMID'si.

graySubKey

String

İsteğe bağlı

abc

Grayscale nesnesinin anahtar adı. grayTarget değeri cookie, header veya queryarg olduğunda gereklidir.

grayRate

Integer

Gerekli

20

Kuralın uygulanacağı trafik yüzdesi. Geçerli aralık: 1 ila 100.

timeConfig parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

timeScope

String

Gerekli

period

Kuralın etkin olduğu zaman. Geçerli değerler:

  • permanent (Varsayılan): Kural her zaman etkindir.

  • period: Kural belirli bir zaman aralığında etkindir.

  • cycle: Kural yinelenen bir programa göre etkindir.

timeZone

Integer

Gerekli

8

Saat dilimi ofseti, -12 ila 12 arasında. Varsayılan: 8 (UTC+8). Örnekler: 0 = UTC, -8 = UTC-8.

timePeriods

Array

İsteğe bağlı

[{"start":1758771729787,"end":1758816000000}]

Kural için aktif zaman dönemleri. timeScope değeri period olduğunda gereklidir. Her dönem şunları içerir:

  • start: Long, gerekli. Milisaniye cinsinden Unix zaman damgası olarak başlangıç zamanı.

  • end: Long, gerekli. Milisaniye cinsinden Unix zaman damgası olarak bitiş zamanı.

weekTimePeriods

Array

İsteğe bağlı

[{"day":"1","dayPeriods":[{"start":0,"end":51644084}]},{"day":"1,2,5","dayPeriods":[{"start":0,"end":42928908}]}]

Kural için yinelenen program. timeScope değeri cycle olduğunda gereklidir. Her program şunları içerir:

  • day: String, gerekli. Haftanın günleri (1–7, 1 = Pazartesi). Birden fazla günü virgülle (,) ayırın.

  • dayPeriods: Array, gerekli. Gün içindeki zaman dönemleri. Her dönem start ve end zamanlarını içerir.

    • start: Long, gerekli. Gece yarısından (00:00) itibaren milisaniye cinsinden başlangıç zamanı. Geçerli aralık: [0, 86400000).

    • end: Long, gerekli. Gece yarısından (00:00) itibaren milisaniye cinsinden bitiş zamanı. Geçerli aralık: [0, 86400000).