Koruma kurallarının sayfalanmış listesini sorgular.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-waf:DescribeDefenseRules |
list |
*All Resource
|
|
None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
Web Application Firewall (WAF) örneğinin kimliği. Not
WAF örneğinin kimliğini sorgulamak için DescribeInstance işlemini çağırın. |
waf_cdnsdf3**** |
| RuleType |
string |
No |
Koruma kuralının türü. Geçerli değerler:
Not
Bu parametre yalnızca DefenseType değeri template olarak ayarlandığında gereklidir. |
whitelist |
| Query |
string |
No |
Sorgu koşulları. Bu parametreyi bir JSON dizesi olarak belirtin. Not
Koruma kurallarına ilişkin sorgu sonuçları sorgu koşullarına göre değişiklik gösterir. Daha fazla bilgi için Sorgu parametresi ayrıntıları bölümüne bakın. |
{\"name\":\"IPblock_20220822_10\",\"scene\":\"custom_acl\",\"templateId\":5327} |
| PageNumber |
integer |
No |
Döndürülecek sayfanın numarası. Varsayılan değer: 1. |
1 |
| PageSize |
integer |
No |
Her sayfada döndürülecek giriş sayısı. Varsayılan değer: 10. |
10 |
| DefenseType |
string |
No |
Koruma kuralının türü. Geçerli değerler:
Valid values:
|
template |
| RegionId |
string |
No |
WAF örneğinin bulunduğu bölge. Geçerli değerler:
|
cn-hangzhou |
| ResourceManagerResourceGroupId |
string |
No |
Alibaba Cloud kaynak grubunun kimliği. |
rg-acfm***q |
Sorgu parametresi ayrıntıları.
Şablon koruma kuralları (template)
DefenseType değerini template olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.
Parametre açıklamaları
| Ad | Tür | Gerekli | Örnek | Açıklama |
| name | String | No | test | Sorgulanacak koruma kuralının adı. Bir koruma kuralı için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. |
| nameId | String | No | test1 | Sorgulanacak koruma kuralının kimliği veya adı. Bir koruma kuralı için bulanık sorgu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. |
| nameLike | String | No | test.aliyundoc.c | Sorgulanacak koruma kuralının adı. Bir koruma kuralı için bulanık sorgu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. |
| scene | String | No | waf_group | Sorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler: - waf_group: temel koruma için normal ifade kuralları. - waf_base: yeni web çekirdek koruma özelliği için kurallar. - waf_base_compliance: temel koruma için protokol uyumluluk kuralları. - waf_base_sema: temel koruma için anlamsal kurallar. - cc: HTTP flood koruması. - antiscan_dirscan: tarama koruması için dizin geçişi engelleme. - antiscan_highfreq: tarama koruması için yüksek frekanslı tarama engelleme. - antiscan_scantools: tarama koruması için tarayıcı engelleme. - ip_blacklist: IP adresi kara listesi. - custom_acl: özel kurallar. - region_block: Coğrafi engelleme. - tamperproof: web sayfası tahrifat koruması. - dlp: veri sızıntısı önleme. - custom_response_block: özel yanıt. |
| ruleId | Long | No | 33444 | Sorgulanacak koruma kuralının kimliği. Bir koruma kuralı için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. |
| ruleIdIn | Array | No | [3334455643,345555] | Sorgulanacak koruma kuralı kimliklerinin aralığı. Birden fazla koruma kuralını sorgulamak için bu parametreyi ayarlayabilirsiniz. Birden fazla kural kimliğini virgül (,) ile ayırın. |
| templateId | Long | No | 24354 | Sorgulanacak koruma şablonunun kimliği. Bir koruma şablonundaki koruma kurallarını sorgulamak için bu parametreyi ayarlayabilirsiniz. |
| orderBy | String | No | name | Koruma kuralları için sıralama yöntemi. Geçerli değerler: - name: kuralları ada göre sıralar. - gmtModified: kuralları değiştirilme zamanına göre sıralar. - id: kuralları kimliğe göre sıralar. - templateId: kuralları şablon kimliğine göre sıralar. |
| desc | Boolean | No | true | Sıralama düzeni. Geçerli değerler: - false: artan düzen. - true: azalan düzen. |
Örnek
{
"name": "test",
"nameId ": "test1,
"nameLike": "test.aliyundoc.c",
"nameIn": "test.aliyundoc.c",
"InstaneId": "test1.aliyundoc.com,test2.aliyundoc.com",
"templateId": 24354
}
Korunan nesneler için kurallar (resource)
DefenseType değerini resource olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.
Parametre açıklamaları
| Ad | Tür | Gerekli | Örnek | Açıklama |
| resource | String | No | sec****-waf | Kuralın uygulandığı korunan nesne. |
| scene | String | No | waf_group | Sorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler: - account_identifier: hesap getirme kuralları. - custom_response: yeni özel yanıt. |
Örnek
{
"resource": "sec****-waf",
"scene ": "account_identifier"
}
Global kurallar (global)
DefenseType değerini global olarak ayarlarsanız aşağıdaki parametreler kullanılabilir.
Parametre açıklamaları
| Ad | Tür | Gerekli | Örnek | Açıklama |
| scene | String | No | regular_custom | Sorgulamak istediğiniz koruma senaryosu. Belirli bir senaryodaki koruma kuralları için terim sorgusu gerçekleştirmek üzere bu parametreyi ayarlayabilirsiniz. Geçerli değerler: - regular_custom: özel normal ifade kuralları. - custom_response: yeni özel yanıt. |
| detectType | String | No | sqli | Sorgulanacak algılama modülü. Geçerli değerler: - sqli: SQL enjeksiyonu. - xss: siteler arası komut dosyası çalıştırma (XSS). - cmdi: işletim sistemi komut enjeksiyonu. - expression_injection: ifade enjeksiyonu. - java_deserialization: Java seriden çıkarma. - dot_net_deserialization: .NET seriden çıkarma. - php_deserialization: PHP seriden çıkarma. - code_exec: kod yürütme. - ssrf: sunucu tarafı istek sahteciliği (SSRF). - path_traversal: yol geçişi. - arbitrary_file_uploading: rastgele dosya yükleme. - webshell: web kabuğu. - rfilei: uzak dosya dahil etme (RFI). - lfilei: yerel dosya dahil etme (LFI). - protocol_violation: protokol ihlali. - scanner_behavior: tarayıcı davranışı. - logic_flaw: iş mantığı hatası. - arbitrary_file_reading: rastgele dosya okuma. - arbitrary_file_download: rastgele dosya indirme. - xxe: harici varlık enjeksiyonu. - csrf: siteler arası istek sahteciliği. - crlf: CRLF. - other: diğer. Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir. |
| riskLevel | String | No | strict | Sorgulanacak tehdit seviyesi. Geçerli değerler: - super_strict: Çok Katı. - strict: Katı. - medium: Orta. - loose: Gevşek. Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir. |
| templateId | Long | No | 24354 | Sorgulanacak koruma şablonunun kimliği. Bir koruma şablonundaki koruma kurallarını sorgulamak için bu parametreyi ayarlayabilirsiniz. Önemli Bu parametre yalnızca scene değeri regular_custom olarak ayarlandığında desteklenir. |
Örnek
{
"detectType": "sqli",
"riskLevel ": "strict",
"templateId": 24354
}
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Yanıt parametreleri. |
||
| TotalCount |
integer |
Döndürülen toplam giriş sayısı. |
2 |
| RequestId |
string |
İstek kimliği. |
80736FA5-FA87-55F6-AA69-C5477C6FE6D0 |
| Rules |
array<object> |
Koruma kurallarının listesi. |
|
|
object |
Koruma kuralı. |
||
| Status |
integer |
Koruma kuralının durumu. Geçerli değerler:
|
1 |
| DefenseOrigin |
string |
Koruma kuralının kaynağı. Geçerli değerler:
|
custom |
| Config |
string |
Koruma kuralının ayrıntıları. Değer bir JSON dizesidir. Daha fazla bilgi için CreateDefenseRule içindeki Rule parametresinin açıklaması bölümüne bakın. |
{\"policyId\":1012,\"action\":\"block\"} |
| RuleId |
integer |
Koruma kuralının kimliği. |
42755 |
| DefenseScene |
string |
Koruma senaryosu. DefenseType istek parametresi template olarak ayarlandığında geçerli değerler şunlardır:
DefenseType istek parametresi resource olarak ayarlandığında geçerli değerler şunlardır:
DefenseType istek parametresi global olarak ayarlandığında geçerli değerler şunlardır:
|
waf_group |
| GmtModified |
integer |
Koruma kuralının en son değiştirildiği zaman. Bu değer bir UNIX zaman damgasıdır. Birim: milisaniye. |
1665460629000 |
| RuleName |
string |
Koruma kuralının adı. |
rules_41 |
| TemplateId |
integer |
Koruma şablonunun kimliği. |
5673 |
| GmtCreate |
integer |
Koruma kuralının oluşturulduğu zaman. Bu değer bir UNIX zaman damgasıdır. Birim: milisaniye. |
1665460629000 |
| Resource |
string |
Kuralın uygulandığı korunan nesne. Not
Bu parametre yalnızca DefenseType istek parametresi resource olarak ayarlandığında döndürülür. |
rencs***-waf |
| DefenseType |
string |
Koruma kuralının türü. Geçerli değerler:
|
template |
Description
deprecated
|
string |
Bu parametre kullanımdan kaldırılmıştır. |
rule description |
RuleType
deprecated
|
string |
Bu parametre kullanımdan kaldırılmıştır. |
custom_cc |
ActionExternal
deprecated
|
string |
Bu parametre kullanımdan kaldırılmıştır. |
42755 |
DetailRuleIds
deprecated
|
string |
Bu parametre kullanımdan kaldırılmıştır. |
42755 |
ExternalInfo
deprecated
|
string |
Bu parametre kullanımdan kaldırılmıştır. |
{\"DetectType\":\"sqli\"} |
Examples
Success response
JSON format
{
"TotalCount": 2,
"RequestId": "80736FA5-FA87-55F6-AA69-C5477C6FE6D0",
"Rules": [
{
"Status": 1,
"DefenseOrigin": "custom",
"Config": "{\\\"policyId\\\":1012,\\\"action\\\":\\\"block\\\"}",
"RuleId": 42755,
"DefenseScene": "waf_group",
"GmtModified": 1665460629000,
"RuleName": "rules_41",
"TemplateId": 5673,
"GmtCreate": 1665460629000,
"Resource": "rencs***-waf",
"DefenseType": "template",
"Description": "rule description",
"RuleType": "custom_cc",
"ActionExternal": "42755",
"DetailRuleIds": "42755",
"ExternalInfo": "{\\\"DetectType\\\":\\\"sqli\\\"}"
}
]
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.