Tüm Ürünler
Search
Belge Merkezi

:CreateDefenseRule

Son Güncelleme:Sep 29, 2026

Bir Web temel koruma kuralı oluşturur.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-waf:CreateDefenseRule

create

*All Resource

*

  • acs:ResourceGroupId
None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

WAF örneğinin kimliği.

Not

Mevcut WAF örneğinizin kimliğini sorgulamak için DescribeInstance işlemini çağırabilirsiniz.

waf_v2_public_cn-****

TemplateId

integer

No

Oluşturulacak koruma kuralına ait koruma şablonunun kimliği.

Not

Bu parametre yalnızca DefenseType değeri template olarak ayarlandığında gereklidir. Aynı koruma şablonu içinde oluşturulabilecek kural sayısı için bir üst sınır vardır. Belirli sınırlar için Kural sayısı sınırları bölümüne bakın. Kural sayısı üst sınıra ulaştığında, yeni bir koruma şablonu oluşturmak için CreateDefenseTemplate işlemini çağırabilirsiniz. Ayrıca mevcut bir kuralı değiştirmek için ModifyDefenseRule işlemini de çağırabilirsiniz.

1122

DefenseScene

string

Yes

Oluşturulacak WAF koruma senaryosu.

Koruma kuralı türü DefenseType değeri template olarak ayarlandığında geçerli değerler:

  • waf_group: Temel koruma.

  • waf_base: Web Temel Korumasının yeni sürümü.

  • antiscan: Tarama Koruması.

  • ip_blacklist: IP Kara Listesi.

  • custom_acl: Özel Kural.

  • whitelist: Beyaz Liste.

  • region_block: Konum Kara Listesi.

  • custom_response: Eski Özel Yanıt.

  • cc: HTTP Flood Koruması.

  • tamperproof: Web kurcalama koruması.

  • dlp: Bilgi Sızıntısı Önleme.

  • spike_throttle: Ani trafik kısıtlaması.

  • bot_manager: Bot Yönetimi.

Koruma kuralı türü DefenseType değeri resource olarak ayarlandığında geçerli değerler:

  • account_identifier: Hesap Çıkarma.

  • custom_response: Özel Yanıtın yeni sürümü.

  • waf_codec: Kod Çözme.

  • websdk: WebSDK Entegrasyonu.

Koruma kuralı türü DefenseType değeri global olarak ayarlandığında geçerli değerler:

  • regular_custom: Özel Normal İfade.

  • address_book: Adres Defteri.

  • custom_response: Özel Yanıtın yeni sürümü.

Not

Global yapılandırmadaki özel yanıt, korunan nesne veya kural düzeyinde referans alınabilir. Özel yanıt kurallarına farklı boyutlarda referans verildiğinde, geçerli olan öncelik mantığı şöyledir: kural düzeyi > korunan nesne düzeyi > varsayılan sayfa.

waf_group

Rules

string

Yes

Parametrelerin JSON biçimli bir dizisinden dönüştürülen bir dize olan kural yapılandırma içeriği.

Not

Belirli parametreler, belirtilen koruma kuralı türüne (DefenseScene) bağlı olarak değişir. Daha fazla bilgi için Koruma kuralı parametre açıklamaları bölümüne bakın.

waf_group

ResourceManagerResourceGroupId

string

No

Deneme çalıştırması modunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametreyi belirtmezseniz normal bir istek gönderilir. Geçerli değerler:

  • true: Bir deneme çalıştırması isteği gönderilir. Sistem, belirtilen işlemi gerçekleştirmeden yalnızca isteğin yürütme koşullarını karşılayıp karşılamadığını kontrol eder. Deneme çalıştırması başarısız olursa, ilgili hata kodu döndürülür. Deneme çalıştırması başarılı olursa, Defense.Control.DryRunOperation hata kodu döndürülür.

  • false: Normal bir istek gönderilir. İstek kontrolü geçtikten sonra belirtilen işlem gerçekleştirilir.

false

DefenseType

string

No

Alibaba Cloud kaynak grubunun kimliği.

Valid values:

  • template :

    (Default) template protection rule.

  • resource :

    protection object-level rule.

  • global :

    global-level rule.

rg-acfm***q

RegionId

string

No

Koruma kuralının türü.

template

Resource

string

No

WAF örneğinin bulunduğu bölge. Geçerli değerler:

  • cn-hangzhou: Çin anakarası.

  • ap-southeast-1: Çin anakarası dışı.

cn-hangzhou

Koruma kuralı parametre açıklamaları

Kural sayısı sınırları

Aynı koruma şablonu içinde, temel koruma senaryosu (DefenseScene) için oluşturulabilecek kural sayısı için bir üst sınır vardır. Aşağıdaki senaryoların sabit sınırları vardır. Diğer senaryoların sınırları WAF örnek sürümüne bağlıdır. Daha fazla bilgi için Sürümler arası özellik karşılaştırması bölümüne bakın.

Koruma senaryosuDefenseSceneKural sayısı sınırıAçıklama
Temel Web Korumasıwaf_group3Temel koruma kuralı türü (protectionType) için bir kural.
Web Temel Korumasının yeni sürümüwaf_base1
Tarama Korumasıantiscan3Her tarama koruması alt türü (protectionType) için bir kural: yüksek frekanslı tarama engelleme, dizin tarama engelleme ve tarama aracı engelleme.
Konum Kara Listesiregion_block1
Eski Özel Yanıtcustom_response1Bu sınır, DefenseType değeri template olarak ayarlandığında eski özel yanıt için geçerlidir. Özel yanıtın yeni sürümü için Sürümler arası özellik karşılaştırması bölümüne bakın.
HTTP Flood Korumasıcc1
BOT Yönetimibot_manager—Senaryo tabanlı kurallarda her kural etiketi (botRuleDetail.ruleKey) için bir kural.
Kod Çözmewaf_codec1
Hesap Çıkarmaaccount_identifier1
WebSDK Entegrasyonuwebsdk1
Not

Koruma kuralı türü DefenseType değeri template olarak ayarlandığında ve hedef şablondaki hedef senaryo için kural sayısı üst sınıra ulaştığında oluşturma işlemi başarısız olur. Bu durumda, yeni bir koruma şablonu oluşturmak için CreateDefenseTemplate işlemini çağırabilirsiniz. Ayrıca mevcut bir kuralı değiştirmek için ModifyDefenseRule işlemini de çağırabilirsiniz.

Şablon tabanlı koruma kuralları (template)

Koruma kuralı türü DefenseType değeri template olarak ayarlandığında, belirli kural yapılandırma içeriği aşağıdaki gibidir.

Temel koruma kuralları (waf_group)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
statusIntegerEvet1Temel koruma kuralının durumu. Bu parametre yalnızca koruma kuralları oluşturmak için kullanılır. Bir koruma kuralının durumunu değiştirmek için ModifyDefenseRuleStatus işleminin RuleStatus parametresini kullanın. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




actionStringEvetblockTemel koruma kuralının eylemi. Geçerli değerler:
- block: Engelle.
- monitor: İzle.




policyIdLongHayır1012Temel koruma kuralı grubunun kimliği. Varsayılan değer: 1012 (orta kural grubu).
protectionTypeStringHayırsemaTemel koruma kuralının türü. Geçerli değerler:
- regular (varsayılan): Normal ifade tabanlı koruma.
- sema: Anlamsal tabanlı koruma.




configStringHayır{"nonInjectionSql":1}JSON dizesi biçimindeki özel yapılandırma. Daha fazla bilgi için config ayrıntılı yapılandırması bölümüne bakın.

config ayrıntılı yapılandırması

  • protectionType değeri sema olarak ayarlandığında (Anlamsal tabanlı koruma olarak yapılandırılmış Temel Web Koruması kuralı)

AdTürGerekliÖrnekAçıklama
nonInjectionSqlIntegerEvet1Enjeksiyon dışı saldırı algılamanın durumu. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




Örnek

{
    "DefenseScene": "waf_group",
    "TemplateId": 322,
    "InstaneId": "waf_cn****",
    "Rules": "[{\"status\":1,\"policyId\":1012,\"action\":\"block\"},{\"status\":1,\"action\":\"block\",\"protectionType\":\"sema\",\"config\":\"{\\\"nonInjectionSql\\\":1}\"}]"
}

Web Temel Koruması kurallarının yeni sürümü (waf_base)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
autoUpdateBooleanEvettrueOtomatik güncellemelerin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
- true: Otomatik güncellemeleri etkinleştir.
- false: Otomatik güncellemeleri devre dışı bırak.




configArrayEvet[{"ruleType":"system","ruleDetail":[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]}]Değiştirilecek kural yapılandırması. Daha fazla bilgi için config ayrıntılı yapılandırması bölümüne bakın.
Önemli Bu şablonun sistem koruma kuralı yapılandırmasını sorgulamak için DescribeBaseSystemRules işlemini, bu şablonun özel normal ifade kuralı yapılandırmasını sorgulamak için DescribeDefenseRules işlemini çağırabilirsiniz.

config ayrıntılı yapılandırması

AdTürGerekliÖrnekAçıklama
ruleTypeStringEvetsystemKural türü. Geçerli değerler:
- system: Temel korumadaki sistem kuralları.
- custom: Temel korumadaki özel normal ifade kuralları.




ruleBatchOperationConfigStringHayırdefaultToplu kural değiştirme işlemi. Bu alan boş olmadığında, RuleDetail alanı boş olmalıdır. Geçerli değerler:
- default: Varsayılana geri yükle.
- all_on: Tüm kuralları etkinleştir.
- all_off: Tüm kuralları devre dışı bırak.
- all_block: Tüm kural eylemlerini engelle olarak ayarla.
- all_monitor: Tüm kural eylemlerini izle olarak ayarla.













ruleDetailArrayHayır[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]]Değiştirilecek kural yapılandırması. Alanlar:
- ruleId: Kural kimliği.
- ruleStatus: Kural durumu.
- ruleAction: Kural eylemi.







Örnek

{
    "DefenseScene": "waf_base",
    "TemplateId": 322,
    "InstaneId": "waf_cn****",
    "Rules": "[{\"autoUpdate\":true,\"config\":[{\"ruleType\":\"system\",\"ruleDetail\":[{\"ruleId\":13000412,\"ruleStatus\":1,\"ruleAction\":\"block\"}]}]}]"
}

Tarama Koruması kuralları (antiscan)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
protectionTypeStringEvethighfreqTarama koruma kuralının alt türü. Geçerli değerler:
- highfreq: Yüksek frekanslı tarama engelleme.
- dirscan: Dizin tarama engelleme.
- scantools: Tarama aracı engelleme.







statusIntegerEvet1Koruma kuralının durumu. Bu parametre yalnızca koruma kuralları oluşturmak için kullanılır. Bir koruma kuralının durumunu değiştirmek için ModifyDefenseRuleStatus işleminin RuleStatus parametresini kullanın. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




actionStringEvetblockKoruma kuralının eylemi. Geçerli değerler:
- block: Engelle.
- monitor: İzle.




actionExternalJSONHayır{"responseRuleId":123444}Koruma kuralı eyleminin genişletilmiş yapılandırması. Bu yapılandırmayı yalnızca özel yanıtın yeni sürümü destekler. action değeri block olarak ayarlandığında, özel bir engelleme sayfası belirtebilirsiniz.
configStringHayır{"target":"remote_addr","interval":60,"ttl":180,"count":20}JSON dizesi biçimindeki özel yapılandırma. Daha fazla bilgi için config ayrıntılı yapılandırması bölümüne bakın.

config ayrıntılı yapılandırması

  • protectionType değeri highfreq olarak ayarlandığında (yüksek frekanslı tarama engelleme olarak yapılandırılmış tarama koruma kuralı)

AdTürGerekliÖrnekAçıklama
targetStringEvetremote_addrİstatistikler için nesne türü. Geçerli değerler:
- remote_addr (varsayılan): IP adresi.
- cookie.acw_tc: Oturum.
- header: Özel Üst Bilgi. Özel Üst Bilgi'yi seçtiğinizde, subkey parametresinde sayılacak üst bilgi içeriğini belirtmeniz gerekir.
- queryarg: Özel parametre. Özel parametre'yi seçtiğinizde, subkey parametresinde sayılacak özel parametre adını belirtmeniz gerekir.
- cookie: Özel Çerez. Özel Çerez'i seçtiğinizde, subkey parametresinde sayılacak çerez içeriğini belirtmeniz gerekir.













subKeyStringHayırabcİstatistiksel nesnenin alt özelliği. Bu parametre, target parametresi cookie, header veya queryarg olarak ayarlandığında gereklidir.
intervalIntegerHayır60Saniye cinsinden algılama süresi. Varsayılan değer: 60.
Geçerli değerler: 5 ile 1800 arası.

ttlIntegerHayır1800Saniye cinsinden engelleme süresi. Varsayılan değer: 1800.
Geçerli değerler: 60 ile 86400 arası.

countIntegerHayır20Temel koruma kuralının tetiklendiği maksimum sayı. Varsayılan değer: 20.
Geçerli değerler: 3 ile 50000 arası.

ruleIdCountIntegerHayır2Tetiklenen kuralların maksimum sayısı. Varsayılan değer: 2.
Geçerli değerler: 1 ile 50 arası.

  • protectionType değeri dirscan olarak ayarlandığında (dizin tarama engelleme olarak yapılandırılmış tarama koruma kuralı)

AdTürGerekliÖrnekAçıklama
targetStringEvetremote_addrİstatistiksel ve engelleme nesnesi. Geçerli değerler:
- remote_addr (varsayılan): IP adresi.
- cookie.acw_tc: Oturum.
- header: Özel Üst Bilgi.
- queryarg: Özel parametre.
- cookie: Özel Çerez.













subKeyStringHayır1İstatistiksel ve engelleme nesnesinin alt özelliği. Bu parametreyi yalnızca target değeri header, queryarg veya cookie olarak ayarlandığında yapılandırın.
intervalIntegerHayır60Saniye cinsinden algılama süresi. Varsayılan değer: 60.
Geçerli değerler: 5 ile 1800 arası.

ttlIntegerHayır1800Saniye cinsinden engelleme süresi. Varsayılan değer: 1800.
Geçerli değerler: 60 ile 86400 arası.

countIntegerHayır20Temel koruma kuralının tetiklendiği maksimum sayı. Varsayılan değer: 20.
Geçerli değerler: 3 ile 50000 arası.

weightFloatHayır2404 yanıt kodlarının yüzdesi. Varsayılan değer: 0,7.
Geçerli değerler: 0,01 ile 1,0 arası, virgülden sonra iki basamağa kadar kesin.

uriNumIntegerHayır2Mevcut olmayan dizinlerin maksimum sayısı. Varsayılan değer: 50.
Geçerli değerler: 2 ile 50000 arası.

Örnek

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 2222,
    "DefenseScene": "antiscan",
    "Rules": "[{\"protectionType\":\"scantools\",\"action\":\"block\",\"status\":1},{\"protectionType\":\"dirscan\",\"status\":1,\"action\":\"block\",\"config\":\"{\\\"target\\\":\\\"remote_addr\\\",\\\"interval\\\":10,\\\"ttl\\\":1800,\\\"weight\\\":0.7,\\\"uriNum\\\":50,\\\"count\\\":50}\"},{\"protectionType\":\"highfreq\",\"status\":1,\"action\":\"block\",\"config\":\"{\\\"target\\\":\\\"remote_addr\\\",\\\"interval\\\":60,\\\"ttl\\\":1800,\\\"count\\\":20,\\\"ruleIdCount\\\":2}\"}]"
}

IP Kara Listesi kuralları (ip_blacklist)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
nameStringEvetiptestIP kara listesi kuralının adı. Ad 1 ila 255 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, alt çizgiler (_), noktalar (.) veya tireler (-) içerebilir.
statusIntegerEvet1Koruma kuralının durumu. Bu parametre yalnızca koruma kuralları oluşturmak için kullanılır. Bir koruma kuralının durumunu değiştirmek için ModifyDefenseRuleStatus işleminin RuleStatus parametresini kullanın. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




actionStringEvetblockKoruma kuralının eylemi. Geçerli değerler:
- block: Engelle.
- monitor: İzle.




actionExternalJSONHayır{"responseRuleId":123444}Koruma kuralı eyleminin genişletilmiş yapılandırması. Bu yapılandırmayı yalnızca özel yanıtın yeni sürümü destekler. action değeri block olarak ayarlandığında, özel bir engelleme sayfası belirtebilirsiniz.
remoteAddrArrayEvet["1.1.XX.XX", "3.1.XX.XX/24"]Kara listeye eklenecek IP adreslerinin listesi, ["ip1","ip2",...] biçiminde.

Örnek

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 2222,
    "DefenseScene": "ip_blacklist",
    "Rules": "[{\"name\":\"iptest1\",\"remoteAddr\":[\"1.1.1.2\",\"3.3.3.3/24\"],\"action\":\"monitor\",\"status\":1},{\"name\":\"iptest2\",\"remoteAddr\":[\"4.4.4.4\",\"5.5.5.5/32\"],\"action\":\"block\",\"status\":1}]"
}

Özel kurallar (custom_acl)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
nameStringEvetiptestÖzel ACL kuralının adı. Ad 1 ila 255 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, alt çizgiler (_), noktalar (.) veya tireler (-) içerebilir.
statusIntegerEvet1Koruma kuralının durumu. Bu parametre yalnızca koruma kuralları oluşturmak için kullanılır. Bir koruma kuralının durumunu değiştirmek için ModifyDefenseRuleStatus işleminin RuleStatus parametresini kullanın. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




actionStringEvetblockKoruma kuralının eylemi. Geçerli değerler:
- block: Engelle.
- monitor: İzle.
- js: JavaScript sınaması.
- captcha: Kaydırmalı CAPTCHA.
- captcha_strict: Katı kaydırmalı CAPTCHA.
Not Özel ACL kuralları için desteklenen koruma kuralı eylemleri, WAF konsolunda görüntülenen özel kural eylemlerine tabidir.
















actionExternalJSONHayır{"responseRuleId":123444}Koruma kuralı eyleminin genişletilmiş yapılandırması. Bu yapılandırmayı yalnızca özel yanıtın yeni sürümü destekler. action değeri block olarak ayarlandığında, özel bir engelleme sayfası belirtebilirsiniz. action değeri captcha veya captcha_strict olarak ayarlandığında, özel bir kaydırmalı CAPTCHA sayfası belirtebilirsiniz.
conditionsArrayEvet[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]ACL kuralının trafik özellikleri, JSON dizesi biçiminde açıklanmıştır. En fazla beş eşleşme koşulu desteklenir. Daha fazla bilgi için Koruma kuralı parametre ayarları bölümündeki conditions yapılandırma açıklamasına bakın.
ccStatusIntegerEvet1Hız sınırlamanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
- 0: Hız sınırlamayı devre dışı bırak.
- 1: Hız sınırlamayı etkinleştir.




ratelimitJSONHayır{"target":"remote_addr","interval":5,"threshold":2,"ttl":1800,"status":{"code":404,"count":2}}JSON dizesi biçiminde açıklanan ayrıntılı hız sınırlama yapılandırması. Bu parametreyi yalnızca ccStatus değeri 1 olarak ayarlandığında yapılandırın. Daha fazla bilgi için Koruma kuralı parametre ayarları bölümündeki ratelimit ayrıntılı yapılandırmasına bakın.
effectStringHayırruleHız sınırlamanın kapsamı. Bu parametreyi yalnızca ccStatus değeri 1 olarak ayarlandığında yapılandırın. Geçerli değerler:
- service: Hız sınırlama korunan nesne üzerinde etkili olur.
- rule: Hız sınırlama tek bir kural üzerinde etkili olur.




grayStatusIntegerHayır1Kural için kanarya sürümünün etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
- 0 (varsayılan): Kanarya sürümünü devre dışı bırak.
- 1: Kanarya sürümünü etkinleştir.




grayConfigJSONHayır{"grayTarget":"header","grayRate":80,"graySubKey":"test"}Kural için JSON dizesi biçiminde açıklanan kanarya sürümü ortamı yapılandırması. Bu parametreyi yalnızca grayStatus değeri 1 olarak ayarlandığında yapılandırın. Daha fazla bilgi için Koruma kuralı parametre ayarları bölümündeki grayConfig ayrıntılı yapılandırmasına bakın.
timeConfigJSONHayır{"timeScope":"period","timeZone":8,"timePeriods":[{"start":1758771729787,"end":1758816000000}]}Kural için JSON dizesi biçiminde açıklanan zamanlanmış yapılandırma. Daha fazla bilgi için Koruma kuralı parametre ayarları bölümündeki timeConfig ayrıntılı yapılandırmasına bakın.

Örnek

{
    "InstanceId": "waf_v2_public_****",
    "TemplateId": 6242,
    "DefenseScene": "custom_acl",
    "Rules":"[{\"name\":\"acl_test\",\"action\":\"block\",\"conditions\":[{\"key\":\"URL\",\"opValue\":\"contain\",\"values\":\"abc\"}],\"ratelimit\":{\"target\":\"remote_addr\",\"interval\":5,\"threshold\":2,\"ttl\":1800,\"status\":{\"code\":404,\"count\":2}},\"ccStatus\":1,\"effect\":\"rule\",\"status\":1,\"origin\":\"custom\",\"timeConfig\":{\"timeScope\":\"cycle\",\"timeZone\":8,\"weekTimePeriods\":[{\"day\":\"1\",\"dayPeriods\":[{\"start\":0,\"end\":51644084}]},{\"day\":\"1,2,5\",\"dayPeriods\":[{\"start\":0,\"end\":42928908}]}]},\"grayStatus\":1,\"grayConfig\":{\"grayRate\":80,\"graySubKey\":\"test\",\"grayTarget\":\"header\"}}]"
}

Beyaz liste kuralları (whitelist)

Parametre açıklamaları

AdTürGerekliÖrnekAçıklama
nameStringEvetwhitelistTestBeyaz liste kuralının adı. Ad 1 ila 255 karakter uzunluğunda olmalı ve Çince karakterler, harfler, rakamlar, alt çizgiler (_), noktalar (.) veya tireler (-) içerebilir.
statusIntegerEvet1Koruma kuralının durumu. Bu parametre yalnızca koruma kuralları oluşturmak için kullanılır. Bir koruma kuralının durumunu değiştirmek için ModifyDefenseRuleStatus işleminin RuleStatus parametresini kullanın. Geçerli değerler:
- 0: Devre dışı.
- 1 (varsayılan): Etkin.




conditionsArrayEvet[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]Beyaz listenin trafik özellikleri, JSON dizesi biçiminde açıklanmıştır. En fazla beş eşleşme koşulu desteklenir. Daha fazla bilgi için Koruma kuralı parametre ayarları bölümündeki conditions yapılandırma açıklamasına bakın.
tagsArrayEvet["waf", "regular"]Beyaz listenin uygulandığı modüllerin listesi, ["XX1", "XX2",...] biçiminde. Geçerli değerler:
- waf: Tüm modüller.
- customrule_rule: Belirli özel kurallar.
- customrule: Özel kurallar.
- blacklist: IP Kara Listesi.
- blacklist_rule: Belirli IP kara listesi kuralları.
- antiscan: Tarama Koruması.
- regular: Temel koruma kuralları.
- regular_rule: Belirli temel koruma normal ifade kuralları.
- regular_type: Belirli temel koruma normal ifade kuralı türleri.
- regular_field: Belirli temel koruma alanları.
- major_protection: Büyük Olay Koruması.
- cc: HTTP Flood Koruması.
- region_block: Konum Kara Listesi.
- antibot_scene: BOT Senaryo Koruması.
- antibot_scene_rule: Belirli BOT senaryo koruma kuralı kimlikleri.
- antibot_scene_label: Belirli BOT senaryo koruma kuralı türleri.
- dlp: Bilgi Sızıntısı Önleme.
- tamperproof: web kurcalama koruması.
- spike_throttle: ani trafik için kısıtlama koruması.























































regularRulesArrayHayır[ "111111", "222222" ]Atlanacak normal ifade kuralı kimliklerinin listesi, ["XX1", "XX2",...] biçiminde. Bu parametreyi yalnızca beyaz liste modülü belirli temel koruma normal ifade kuralları olarak ayarlandığında (tags parametresi regular_rule olarak ayarlandığında) yapılandırın.
regularTypesArrayHayır[ "xss", "css" ]Atlanacak normal ifade kuralı türlerinin listesi, ["XX1", "XX2",...] biçiminde. Bu parametreyi yalnızca beyaz liste modülü Web uygulaması normal ifade türleri olarak ayarlandığında (tags parametresi regular_type olarak ayarlandığında) yapılandırın. Geçerli değerler:
- sqli: SQL enjeksiyonu.
- xss: Siteler arası komut dosyası.
- code_exec: Kod yürütme.
- crlf: CRLF.
- lfilei: Yerel dosya dahil etme.
- rfilei: Uzak dosya dahil etme.
- webshell: WebShell.
- csrf: CSRF.
- other: Diğer.

























regularFieldsArrayHayır[{"key":"URL
DescribeBotRuleLabels

Response elements

Element

Type

Description

Example

object

Yanıt yapısı.

RequestId

string

İsteğin kimliği.

26E46541-7AAB-5565-801D-F14DBDC5****

RuleIds

string

Oluşturulan koruma kurallarının kimlikleri. Birden fazla koruma kuralı kimliği virgül (,) ile ayrılır.

22215,23354,462165

Examples

Success response

JSON format

{
  "RequestId": "26E46541-7AAB-5565-801D-F14DBDC5****",
  "RuleIds": "22215,23354,462165"
}

Error codes

HTTP status code

Error code

Error message

Description

400 Defense.Control.DefenseWhitelistBypassRuleNotExist The whitelist protection rule does not exist.
400 Defense.Control.DefenseWhitelistConfigInvalid The whitelist rule is misconfigured.
400 Defense.Control.DefenseBookTypeInvalid The address book type is illegal.
400 Defense.Control.DefenseThreatIntelligenceConfigInvalid Threat Intelligence Rule configuration error.
400 Defense.Control.DefenseIpCountOversize The number of IPs exceeds the limit.
400 Defense.Control.InvalidDefenseRuleConfig Invalid protection rule configuration. %s.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.