Centre de documentation

Tous les produits

Centre de documentation

Web Application Firewall:Paramètres des règles de défense

Dernière mise à jour :Aug 06, 2026

Paramètres OpenAPI courants pour la configuration des règles de défense (DefenseRule) dans WAF.

Paramètres `conditions`

Paramètre	Type	Obligatoire	Exemple	Description
key	String	Obligatoire	IP	Le champ de correspondance. Valeurs valides : `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` et `Post-Arg`. Les règles personnalisées avancées Bot prennent également en charge : `Client-ID`, `Ja3-Fingerprint`, `Ja4-Fingerprint`, `Http2-Fingerprint`, `Isp-ID`, `WebSdk` et `AppSdk`. Important Les champs de correspondance disponibles varient selon l'édition WAF. Vérifiez les champs pris en charge pour chaque type de règle dans la console WAF.
subKey	String	Facultatif	abc	Le sous-champ personnalisé. Remarque Tous les champs de correspondance (`key`) ne prennent pas en charge un sous-champ personnalisé (`subKey`). Consultez les combinaisons prises en charge dans la console WAF.
opValue	String	Obligatoire	contain	L'opérateur logique. Valeurs valides : `not-contain` : Ne contient pas. Si le `champ de correspondance` (`key`) est `IP`, cela signifie que l'adresse IP ne figure pas dans la liste spécifiée. `contain` : Contient. Si le champ de correspondance (`key`) est `IP`, cela signifie que l'adresse IP figure dans la liste spécifiée. `none` : N'existe pas. `ne` : Différent de. `eq` : Égal à. `lt` : Inférieur à. `gt` : Supérieur à. `len-lt` : Longueur inférieure à. `len-eq` : Longueur égale à. `len-gt` : Longueur supérieure à. `not-match` : Ne correspond pas. `match-one` : Égal à l'une des valeurs parmi plusieurs. `all-not-match` : Différent de toutes les valeurs parmi plusieurs. `all-not-contain` : Ne contient aucune des valeurs parmi plusieurs. `contain-one` : Contient l'une des valeurs parmi plusieurs. `not-regex` : Ne correspond pas à l'expression régulière. `regex` : Correspond à l'expression régulière. `all-not-regex` : Ne correspond à aucune des expressions régulières. `regex-one` : Correspond à l'une des expressions régulières. `prefix-match` : Correspond au préfixe. `suffix-match` : Correspond au suffixe. `empty` : Est vide. `exists` : Existe. `inl` : Figure dans la liste. `in-list` : Figure dans le carnet d'adresses. `not-in-list` : Ne figure pas dans le carnet d'adresses. Remarque Tous les opérateurs logiques (`opValue`) ne sont pas disponibles pour chaque champ de correspondance (`key`). Vérifiez les combinaisons disponibles pour chaque type de règle dans la console WAF.
values	String	Obligatoire	abc	Le contenu de correspondance. Séparez plusieurs valeurs par des virgules (,). Remarque Les valeurs valides pour `opValue` et `values` dépendent du champ de correspondance spécifié (`key`).

Paramètres `ratelimit`

Paramètre	Type	Obligatoire	Exemple	Description
target	String	Obligatoire	remote_addr	L'objet statistique. Valeurs valides : `remote_addr` (par défaut) : une adresse IP. `cookie.acw_tc` : une session. `header` : un en-tête personnalisé. Spécifiez le nom de l'en-tête dans `subKey`. `queryarg` : un paramètre personnalisé. Spécifiez le nom du paramètre dans `subKey`. `cookie` : un cookie personnalisé. Spécifiez le nom du cookie dans `subKey`. `account` : un compte. Les valeurs suivantes sont prises en charge uniquement par les règles personnalisées avancées Bot : `postarg` : un paramètre de corps personnalisé. Spécifiez le nom du paramètre dans `subKey`. `websdk.umid` : un UMID web. `appsdk.eeid_umid` : un UMID d'application.
subKey	String	Facultatif	abc	Le nom de clé de l'objet statistique. Obligatoire lorsque `target` est `cookie`, `header`, `queryarg` ou `postarg`.
interval	Integer	Obligatoire	60	La période statistique, en secondes. WAF comptabilise les requêtes durant cette période par rapport au `threshold`. Plage valide : 1 à 1 800.
threshold	Integer	Obligatoire	200	Nombre maximal de requêtes provenant d'un même objet statistique vers la ressource protégée durant la période statistique.
ttl	Integer	Obligatoire	1800	La durée de l'action, en secondes. Plage valide : 60 à 86 400.
status	JSON	Facultatif	{"code":404,"count":200}	Limitation du débit basée sur les codes de réponse. Chaîne JSON contenant les champs suivants : `code` : Integer, obligatoire. Le code de réponse à surveiller. `count` : Integer, facultatif. Seuil d'occurrences — la règle se déclenche lorsque le nombre d'occurrences du code de réponse dépasse cette valeur. Plage valide : 2 à 50 000. Spécifiez soit `count`, soit `ratio`, mais pas les deux. `ratio` : Integer, facultatif. Seuil en pourcentage — la règle se déclenche lorsque le pourcentage du code de réponse dépasse cette valeur. Plage valide : 1 à 100. Spécifiez soit `count`, soit `ratio`, mais pas les deux.
distinctStat	Array	Facultatif	[{"key":"URL","opValue":"gt","values":"1"}]	Les conditions pour les statistiques distinctes. Remarque Pris en charge uniquement pour les règles personnalisées avancées Bot. Utilise les paramètres `distinctStat` décrits ci-dessous.

Paramètres `distinctStat`

Paramètre	Type	Obligatoire	Exemple	Description
key	String	Obligatoire	IP	Le champ de correspondance. Valeurs valides : `URL`, `URLPath`, `IP`, `Cookie-Exact`, `Post-Arg`, `Header`, `Query-Arg`, `Ja3-Fingerprint`, `Ja4-Fingerprint`, `Http2-Fingerprint`, `WebSdk` et `AppSdk`. Important Les champs de correspondance disponibles dépendent de votre abonnement Bot Management. Consultez les champs pris en charge dans la console WAF.
subKey	String	Facultatif	abc	Le sous-champ personnalisé pour la condition de statistiques distinctes. Remarque Tous les champs de correspondance (`key`) pour les statistiques distinctes ne prennent pas en charge un sous-champ personnalisé (`subKey`). Vérifiez les combinaisons prises en charge dans la console WAF.
opValue	String	Obligatoire	Equal	L'opérateur logique. Valeurs valides : `eq` : le nombre de valeurs uniques est égal à la valeur spécifiée. `lt` : le nombre de valeurs uniques est inférieur à la valeur spécifiée. `gt` : le nombre de valeurs uniques est supérieur à la valeur spécifiée.
value	String	Obligatoire	abc	La valeur à comparer avec le nombre de valeurs uniques.

Paramètres `grayConfig`

Paramètre	Type	Obligatoire	Exemple	Description
grayTarget	String	Obligatoire	remote_addr	La cible de déploiement progressif. Détermine le trafic auquel la règle s'applique en fonction du pourcentage de déploiement. Valeurs valides : `remote_addr` (par défaut) : une adresse IP. `cookie.acw_tc` : une session. `header` : un en-tête personnalisé. Spécifiez le nom de l'en-tête dans `graySubKey`. `queryarg` : un paramètre personnalisé. Spécifiez le nom du paramètre dans `graySubKey`. `cookie` : un cookie personnalisé. Spécifiez le nom du cookie dans `graySubKey`. Seules les règles personnalisées avancées Bot prennent en charge les valeurs suivantes : `websdk.umid` : un UMID web. `appsdk.eeid_umid` : un UMID d'application.
graySubKey	String	Facultatif	abc	Le nom de clé de l'objet de déploiement progressif. Obligatoire lorsque `grayTarget` est `cookie`, `header` ou `queryarg`.
grayRate	Integer	Obligatoire	20	Le pourcentage de trafic auquel la règle s'applique. Plage valide : 1 à 100.

Paramètres `timeConfig`

Paramètre	Type	Obligatoire	Exemple	Description
timeScope	String	Obligatoire	period	La période d'application de la règle. Valeurs valides : `permanent` (par défaut) : la règle est toujours active. `period` : la règle est active pendant une plage horaire spécifique. `cycle` : la règle est active selon une planification récurrente.
timeZone	Integer	Obligatoire	8	Le décalage du fuseau horaire, de -12 à 12. Par défaut : `8` (UTC+8). Exemples : `0` = UTC, `-8` = UTC-8.
timePeriods	Array	Facultatif	[{"start":1758771729787,"end":1758816000000}]	Les périodes d'activité de la règle. Obligatoire lorsque `timeScope` est `period`. Chaque période comprend : `start` : Long, obligatoire. Heure de début sous forme de timestamp Unix en millisecondes. `end` : Long, obligatoire. Heure de fin sous forme de timestamp Unix en millisecondes.
weekTimePeriods	Array	Facultatif	[{"day":"1","dayPeriods":[{"start":0,"end":51644084}]},{"day":"1,2,5","dayPeriods":[{"start":0,"end":42928908}]}]	La planification récurrente de la règle. Obligatoire lorsque `timeScope` est `cycle`. Chaque planification comprend : `day` : String, obligatoire. Jours de la semaine (1 à 7, où 1 = lundi). Séparez plusieurs jours par des virgules (,). `dayPeriods` : Array, obligatoire. Plages horaires dans une journée. Chaque plage comprend les heures `start` et `end`. `start` : Long, obligatoire. Heure de début en millisecondes depuis minuit (00:00). Plage valide : [0, 86400000). `end` : Long, obligatoire. Heure de fin en millisecondes depuis minuit (00:00). Plage valide : [0, 86400000).