Web Application Firewall:CreateDefenseRule

Descriptions des paramètres de règle de protection

Limites de quantité de règles

Dans le même modèle de protection, il existe une limite supérieure au nombre de règles pouvant être créées pour le scénario de protection de base (DefenseScene). Les scénarios suivants ont des limites fixes. Les limites pour les autres scénarios dépendent de l'édition de l'instance WAF. Pour plus d'informations, reportez-vous à Comparaison des fonctionnalités entre les éditions.

Scénario de protection	DefenseScene	Limite de quantité de règles	Description
Protection de base Web	waf_group	3	Une règle pour le type de règle de protection de base (protectionType).
Nouvelle version de la protection de base Web	waf_base	1
Protection contre les analyses	antiscan	3	Une règle pour chaque sous-type de protection contre les analyses (protectionType) : blocage des analyses à haute fréquence, blocage de l'exploration de répertoires et blocage des outils d'analyse.
Liste noire géographique	region_block	1
Ancienne Réponse personnalisée	custom_response	1	Cette limite s'applique à l'ancienne réponse personnalisée lorsque DefenseType est défini sur template. Pour la nouvelle version de la réponse personnalisée, reportez-vous à Comparaison des fonctionnalités entre les éditions.
Protection contre les attaques HTTP Flood	cc	1
Gestion des bots	bot_manager	—	Une règle pour chaque balise de règle (botRuleDetail.ruleKey) dans les règles basées sur des scénarios.
Décodage	waf_codec	1
Extraction de compte	account_identifier	1
Intégration WebSDK	websdk	1

Règles de protection basées sur un modèle (template)

Lorsque le type de règle de protection DefenseType est défini sur template, le contenu de configuration de règle spécifique est le suivant.

Règles de protection de base (waf_group)

Descriptions des paramètres

Nom	Type	Requis	Exemple	Description
status	Integer	Oui	1	L'état de la règle de protection de base. Ce paramètre est utilisé uniquement pour la création de règles de protection. Pour modifier l'état d'une règle de protection, utilisez le paramètre RuleStatus de l'opération ModifyDefenseRuleStatus. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.
action	String	Oui	block	L'action de la règle de protection de base. Valeurs valides : - block : Bloquer. - monitor : Surveiller.
policyId	Long	Non	1012	L'identifiant du groupe de règles de protection de base. Valeur par défaut : 1012 (groupe de règles moyen).
protectionType	String	Non	sema	Le type de règle de protection de base. Valeurs valides : - regular (par défaut) : Protection basée sur des expressions régulières. - sema : Protection basée sur la sémantique.
config	String	Non	{"nonInjectionSql":1}	La configuration personnalisée au format de chaîne JSON. Pour plus d'informations, reportez-vous à la configuration détaillée de config.

Configuration détaillée de config

• Lorsque protectionType est défini sur sema (règle de protection de base Web configurée comme protection basée sur la sémantique)

Nom	Type	Requis	Exemple	Description
nonInjectionSql	Integer	Oui	1	L'état de la détection des attaques sans injection. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.

Exemple

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

Nouvelle version des règles de protection de base Web (waf_base)

Descriptions des paramètres

Nom	Type	Requis	Exemple	Description
autoUpdate	Boolean	Oui	true	Indique si les mises à jour automatiques doivent être activées. Valeurs valides : - true : Activer les mises à jour automatiques. - false : Désactiver les mises à jour automatiques.
config	Array	Oui	[{"ruleType":"system","ruleDetail":[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]}]	La configuration de la règle à modifier. Pour plus d'informations, reportez-vous à la configuration détaillée de config. Important Vous pouvez appeler l'opération DescribeBaseSystemRules pour obtenir la configuration des règles de protection système de ce modèle, et appeler l'opération DescribeDefenseRules pour obtenir la configuration des règles d'expression régulière personnalisée de ce modèle.

Configuration détaillée de config

Nom	Type	Requis	Exemple	Description
ruleType	String	Oui	system	Le type de règle. Valeurs valides : - system : Règles système dans la protection de base. - custom : Règles d'expression régulière personnalisée dans la protection de base.
ruleBatchOperationConfig	String	Non	default	L'opération de modification de règle par lot. Lorsque ce champ n'est pas vide, le champ RuleDetail doit être vide. Valeurs valides : - default : Restaurer les valeurs par défaut. - all_on : Activer toutes les règles. - all_off : Désactiver toutes les règles. - all_block : Définir toutes les actions de règle sur bloquer. - all_monitor : Définir toutes les actions de règle sur surveiller.
ruleDetail	Array	Non	[{"ruleId":13000412,"ruleStatus":1,"ruleAction":"block"}]]	La configuration de la règle à modifier. Champs : - ruleId : L'identifiant de la règle. - ruleStatus : L'état de la règle. - ruleAction : L'action de la règle.

Exemple

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

Règles de protection contre les analyses (antiscan)

Descriptions des paramètres

Nom	Type	Requis	Exemple	Description
protectionType	String	Oui	highfreq	Le sous-type de la règle de protection contre les analyses. Valeurs valides : - highfreq : Blocage des analyses à haute fréquence. - dirscan : Blocage de l'exploration de répertoires. - scantools : Blocage des outils d'analyse.
status	Integer	Oui	1	L'état de la règle de protection. Ce paramètre est utilisé uniquement pour la création de règles de protection. Pour modifier l'état d'une règle de protection, utilisez le paramètre RuleStatus de l'opération ModifyDefenseRuleStatus. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.
action	String	Oui	block	L'action de la règle de protection. Valeurs valides : - block : Bloquer. - monitor : Surveiller.
actionExternal	JSON	Non	{"responseRuleId":123444}	La configuration étendue de l'action de la règle de protection. Seule la nouvelle version de la réponse personnalisée prend en charge cette configuration. Lorsque action est défini sur block, vous pouvez spécifier une page de blocage personnalisée.
config	String	Non	{"target":"remote_addr","interval":60,"ttl":180,"count":20}	La configuration personnalisée au format de chaîne JSON. Pour plus d'informations, reportez-vous à la configuration détaillée de config.

Configuration détaillée de config

• Lorsque protectionType est défini sur highfreq (règle de protection contre les analyses configurée comme blocage des analyses à haute fréquence)

Nom	Type	Requis	Exemple	Description
target	String	Oui	remote_addr	Le type d'objet pour les statistiques. Valeurs valides : - remote_addr (par défaut) : Adresse IP. - cookie.acw_tc : Session. - header : En-tête personnalisé. Lorsque vous sélectionnez En-tête personnalisé, vous devez spécifier le contenu de l'en-tête à compter dans le paramètre subkey. - queryarg : Paramètre personnalisé. Lorsque vous sélectionnez Paramètre personnalisé, vous devez spécifier le nom du paramètre personnalisé à compter dans le paramètre subkey. - cookie : Cookie personnalisé. Lorsque vous sélectionnez Cookie personnalisé, vous devez spécifier le contenu du cookie à compter dans le paramètre subkey.
subKey	String	Non	abc	La sous-fonctionnalité de l'objet statistique. Ce paramètre est requis lorsque le paramètre target est défini sur cookie, header ou queryarg.
interval	Integer	Non	60	La période de détection, en secondes. Valeur par défaut : 60. Valeurs valides : de 5 à 1800.
ttl	Integer	Non	1800	La durée de blocage, en secondes. Valeur par défaut : 1800. Valeurs valides : de 60 à 86400.
count	Integer	Non	20	Le nombre maximum de fois où la règle de protection de base est déclenchée. Valeur par défaut : 20. Valeurs valides : de 3 à 50000.
ruleIdCount	Integer	Non	2	Le nombre maximum de règles déclenchées. Valeur par défaut : 2. Valeurs valides : de 1 à 50.

• Lorsque protectionType est défini sur dirscan (règle de protection contre les analyses configurée comme blocage de l'exploration de répertoires)

Nom	Type	Requis	Exemple	Description
target	String	Oui	remote_addr	L'objet statistique et de blocage. Valeurs valides : - remote_addr (par défaut) : Adresse IP. - cookie.acw_tc : Session. - header : En-tête personnalisé. - queryarg : Paramètre personnalisé. - cookie : Cookie personnalisé.
subKey	String	Non	1	La sous-fonctionnalité de l'objet statistique et de blocage. Configurez ce paramètre uniquement lorsque target est défini sur header, queryarg ou cookie.
interval	Integer	Non	60	La période de détection, en secondes. Valeur par défaut : 60. Valeurs valides : de 5 à 1800.
ttl	Integer	Non	1800	La durée de blocage, en secondes. Valeur par défaut : 1800. Valeurs valides : de 60 à 86400.
count	Integer	Non	20	Le nombre maximum de fois où la règle de protection de base est déclenchée. Valeur par défaut : 20. Valeurs valides : de 3 à 50000.
weight	Float	Non	2	Le pourcentage de codes de réponse 404. Valeur par défaut : 0,7. Valeurs valides : de 0,01 à 1,0, précis à deux décimales près.
uriNum	Integer	Non	2	Le nombre maximum de répertoires inexistants. Valeur par défaut : 50. Valeurs valides : de 2 à 50000.

Exemple

{
    "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}\"}]"
}

Règles de liste noire d'adresses IP (ip_blacklist)

Descriptions des paramètres

Nom	Type	Requis	Exemple	Description
name	String	Oui	iptest	Le nom de la règle de liste noire d'adresses IP. Le nom doit comporter de 1 à 255 caractères et peut contenir des caractères chinois, des lettres, des chiffres, des traits de soulignement (_), des points (.) ou des traits d'union (-).
status	Integer	Oui	1	L'état de la règle de protection. Ce paramètre est utilisé uniquement pour la création de règles de protection. Pour modifier l'état d'une règle de protection, utilisez le paramètre RuleStatus de l'opération ModifyDefenseRuleStatus. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.
action	String	Oui	block	L'action de la règle de protection. Valeurs valides : - block : Bloquer. - monitor : Surveiller.
actionExternal	JSON	Non	{"responseRuleId":123444}	La configuration étendue de l'action de la règle de protection. Seule la nouvelle version de la réponse personnalisée prend en charge cette configuration. Lorsque action est défini sur block, vous pouvez spécifier une page de blocage personnalisée.
remoteAddr	Array	Oui	["1.1.XX.XX", "3.1.XX.XX/24"]	La liste des adresses IP à ajouter à la liste noire, au format ["ip1","ip2",...].

Exemple

{
    "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}]"
}

Règles personnalisées (custom_acl)

Descriptions des paramètres

Nom	Type	Requis	Exemple	Description
name	String	Oui	iptest	Le nom de la règle ACL personnalisée. Le nom doit comporter de 1 à 255 caractères et peut contenir des caractères chinois, des lettres, des chiffres, des traits de soulignement (_), des points (.) ou des traits d'union (-).
status	Integer	Oui	1	L'état de la règle de protection. Ce paramètre est utilisé uniquement pour la création de règles de protection. Pour modifier l'état d'une règle de protection, utilisez le paramètre RuleStatus de l'opération ModifyDefenseRuleStatus. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.
action	String	Oui	block	L'action de la règle de protection. Valeurs valides : - block : Bloquer. - monitor : Surveiller. - js : Défi JavaScript. - captcha : CAPTCHA à curseur. - captcha_strict : CAPTCHA à curseur strict. Remarque Les actions de règle de protection prises en charge pour les règles ACL personnalisées sont soumises aux actions de règle personnalisée affichées dans la console WAF.
actionExternal	JSON	Non	{"responseRuleId":123444}	La configuration étendue de l'action de la règle de protection. Seule la nouvelle version de la réponse personnalisée prend en charge cette configuration. Lorsque action est défini sur block, vous pouvez spécifier une page de blocage personnalisée. Lorsque action est défini sur captcha ou captcha_strict, vous pouvez spécifier une page de CAPTCHA à curseur personnalisée.
conditions	Array	Oui	[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]	Les caractéristiques de trafic de la règle ACL, décrites au format de chaîne JSON. Un maximum de cinq conditions de correspondance sont prises en charge. Pour plus d'informations, reportez-vous à la description de la configuration des conditions dans Paramètres des paramètres de règle de protection.
ccStatus	Integer	Oui	1	Indique si la limitation de débit doit être activée. Valeurs valides : - 0 : Désactiver la limitation de débit. - 1 : Activer la limitation de débit.
ratelimit	JSON	Non	{"target":"remote_addr","interval":5,"threshold":2,"ttl":1800,"status":{"code":404,"count":2}}	La configuration détaillée de la limitation de débit, décrite au format de chaîne JSON. Configurez ce paramètre uniquement lorsque ccStatus est défini sur 1. Pour plus d'informations, reportez-vous à la configuration détaillée de ratelimit dans Paramètres des paramètres de règle de protection.
effect	String	Non	rule	La portée de la limitation de débit. Configurez ce paramètre uniquement lorsque ccStatus est défini sur 1. Valeurs valides : - service : La limitation de débit prend effet sur l'objet protégé. - rule : La limitation de débit prend effet sur une seule règle.
grayStatus	Integer	Non	1	Indique si le déploiement canari doit être activé pour la règle. Valeurs valides : - 0 (par défaut) : Désactiver le déploiement canari. - 1 : Activer le déploiement canari.
grayConfig	JSON	Non	{"grayTarget":"header","grayRate":80,"graySubKey":"test"}	La configuration de l'environnement de déploiement canari pour la règle, décrite au format de chaîne JSON. Configurez ce paramètre uniquement lorsque grayStatus est défini sur 1. Pour plus d'informations, reportez-vous à la configuration détaillée de grayConfig dans Paramètres des paramètres de règle de protection.
timeConfig	JSON	Non	{"timeScope":"period","timeZone":8,"timePeriods":[{"start":1758771729787,"end":1758816000000}]}	La configuration planifiée pour la règle, décrite au format de chaîne JSON. Pour plus d'informations, reportez-vous à la configuration détaillée de timeConfig dans Paramètres des paramètres de règle de protection.

Exemple

{
    "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\"}}]"
}

Règles de liste blanche (whitelist)

Description des paramètres

Nom	Type	Obligatoire	Exemple	Description
name	String	Yes	whitelistTest	Le nom de la règle de liste blanche. Le nom doit comporter entre 1 et 255 caractères et peut contenir des caractères chinois, des lettres, des chiffres, des traits de soulignement (_), des points (.) ou des traits d'union (-).
status	Integer	Yes	1	L'état de la règle de protection. Ce paramètre est utilisé uniquement pour la création de règles de protection. Pour modifier l'état d'une règle de protection, utilisez le paramètre RuleStatus de l'opération ModifyDefenseRuleStatus. Valeurs valides : - 0 : Désactivé. - 1 (par défaut) : Activé.
conditions	Array	Yes	[{"key":"IP","opValue":"eq","values":"11.XX.XX.1"},{"key":"Header","subKey":"abc","opValue":"contains","values":"test"}]	Les caractéristiques du trafic de la liste blanche, décrites au format de chaîne JSON. Un maximum de cinq conditions de correspondance sont prises en charge. Pour plus d'informations, reportez-vous à la description de la configuration des conditions dans Paramètres des règles de protection.
tags	Array	Yes	["waf", "regular"]	La liste des modules auxquels la liste blanche s'applique, au format ["XX1", "XX2",...]. Valeurs valides : - waf : Tous les modules. - customrule_rule : Règles personnalisées spécifiques. - customrule : Règles personnalisées. - blacklist : Liste noire d'adresses IP. - blacklist_rule : Règles spécifiques de la liste noire d'adresses IP. - antiscan : Protection contre les analyses. - regular : Règles de protection de base. - regular_rule : Règles d'expressions régulières de protection de base spécifiques. - regular_type : Types de règles d'expressions régulières de protection de base spécifiques. - regular_field : Champs de protection de base spécifiques. - major_protection : Protection pour les événements majeurs. - cc : Protection contre les inondations HTTP. - region_block : Liste noire de localisations. - antibot_scene : Protection des scénarios de bots. - antibot_scene_rule : Identifiants de règles de protection de scénarios de bots spécifiques. - antibot_scene_label : Types de règles de protection de scénarios de bots spécifiques. - dlp : Prévention des fuites d'informations. - tamperproof : Protection contre la falsification de pages Web. - spike_throttle : Protection par limitation pour le trafic de pointe.
regularRules	Array	No	[ "111111", "222222" ]	La liste des identifiants de règles d'expressions régulières à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des règles d'expressions régulières de protection de base spécifiques (le paramètre tags est défini sur regular_rule).
regularTypes	Array	No	[ "xss", "css" ]	La liste des types de règles d'expressions régulières à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur les types d'expressions régulières d'applications Web (le paramètre tags est défini sur regular_type). Valeurs valides : - sqli : Injection SQL. - xss : Cross-site scripting. - code_exec : Exécution de code. - crlf : CRLF. - lfilei : Inclusion de fichier local. - rfilei : Inclusion de fichier distant. - webshell : WebShell. - csrf : CSRF. - other : Autre.
regularFields	Array	No	[{"key":"URL"},{"key":"Header","subKey":"abc"}]	La liste des champs de protection de base à ignorer, décrite au format de chaîne JSON. Un maximum de cinq conditions de correspondance sont prises en charge. Pour plus d'informations, reportez-vous à la configuration détaillée de regularFields. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des champs de protection de base spécifiques (le paramètre tags est défini sur regular_field).
customRules	Array	No	[ "111111", "222222" ]	La liste des identifiants de règles personnalisées à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des règles personnalisées spécifiques (le paramètre tags est défini sur customrule_rule).
blacklistRules	Array	No	[ "111111", "222222" ]	La liste des identifiants de règles de liste noire d'adresses IP à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des règles spécifiques de liste noire d'adresses IP (le paramètre tags est défini sur blacklist_rule).
botRules	Array	No	[ "111111", "222222" ]	La liste des identifiants de règles de protection de scénarios de bots à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des identifiants de règles de protection de scénarios de bots spécifiques (le paramètre tags est défini sur antibot_scene_rule).
botLables	Array	No	[ "abc", "cdcc" ]	La liste des types de règles de protection de scénarios de bots à ignorer, au format ["XX1", "XX2",...]. Configurez ce paramètre uniquement lorsque le module de liste blanche est défini sur des types de règles de protection de scénarios de bots spécifiques (le paramètre tags est défini sur antibot_scene_label). Vous pouvez appeler l'opération DescribeBotRuleLabels pour interroger les informations sur le type de règle de bot.

Configuration détaillée de regularFields

Nom	Type	Obligatoire	Exemple	Description
key	String	Yes	URL	Le champ à ignorer. Valeurs valides : - URL-All : Tous les champs liés à l'URI. - URL : Champ URI spécifié. - URLPath : Chemin d'URI. - Query-All : Tous les champs liés aux requêtes. - Query-Arg : Paramètre de requête spécifié. - Cookie-All : Tous les champs liés aux cookies. - Cookie-Exact : Nom de cookie spécifié. - Header-All : Tous les champs liés aux en-têtes. - Header : Champ d'en-tête spécifié. - Body-All : Tous les paramètres du corps.
subKey	String	No	abc	Le champ spécifié. Configurez ce paramètre lorsque le champ à ignorer (key) est défini sur URLPath, Query-Arg, Cookie-Exact ou Header.