Bot模板保存

POST

/v1/waf/botTemplate/save

Bot模板保存

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Body 参数

key string

模板唯一标识。temp-xxxxx，新增传空

可选

name string

模板名称

必选

switch integer

模板开关。可选值: 0(关), 1(开)

必选

web_sdk string

Web SDK集成方式。可选值: manual(手动), auto(自动)

必选

bind_info array

绑定信息。没有勾选域名则传空数组

必选

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

instance_id string

实例ID

可选

sub_domain array

域名数组

可选

显示子属性隐藏子属性

items string

ai_defense_status integer

AI智能防护开关。可选值: 0(关), 1(开)

必选

ai_defense object {3}

AI智能防护

可选

显示子属性隐藏子属性

action string

处置动作。可选值: deny(拦截), log(观察), slider_captcha(滑块), strict_slider_captcha(严格滑块), source_mark(回源标记), husc(人机识别)

必选

header_key string

回源标记headerKey

必选

header_value string

回源标记headerValue

必选

ip_limit_status integer

自定义IP限速开关。可选值: 0(关), 1(开)

必选

ip_limit array

自定义IP限速

可选

显示子属性隐藏子属性

items object {6}

显示子属性隐藏子属性

action string

处置动作。可选值: deny(拦截), log(观察), slider_captcha(滑块), strict_slider_captcha(严格滑块), source_mark(回源标记), husc(人机识别)

必选

period integer

统计时长

必选

limit integer

阈值

必选

ttl integer

限速时间

必选

header_key string

回源标记headerKey

必选

header_value string

回源标记headerValue

必选

custom_limit_status integer

自定义会话限速开关。可选值: 0(关), 1(开)

必选

custom_limit array

自定义会话限速

可选

显示子属性隐藏子属性

items object {8}

显示子属性隐藏子属性

action string

处置动作。可选值: deny(拦截), log(观察), slider_captcha(滑块), strict_slider_captcha(严格滑块), source_mark(回源标记), husc(人机识别)

必选

custom_type string

会话类型。可选值: header(自定义Header), cookie(自定义Cookie), param(自定义Query String参数), session(Session)

必选

value string

对应参数名称。Session 时为空字符串

必选

period integer

统计时长

可选

limit integer

阈值

可选

ttl integer

限速时间

可选

header_key string

回源标记headerKey

必选

header_value string

回源标记headerValue

必选

path array

防护目标特征

必选

显示子属性隐藏子属性

items object {4}

显示子属性隐藏子属性

key string

匹配字段

必选

match string

匹配操作符

必选

field string

字段名称。部分字段需要

必选

value array

匹配内容。字符串数组

必选

显示子属性隐藏子属性

items string

custom_rules_status integer

自定义Bot策略开关。可选值: 0(关), 1(开)

必选

custom_rules object {4}

自定义Bot策略

可选

显示子属性隐藏子属性

action string

处置动作。可选值: deny(拦截), log(观察), slider_captcha(滑块), strict_slider_captcha(严格滑块), source_mark(回源标记), husc(人机识别)

必选

header_key string

回源标记headerKey

可选

header_value string

回源标记headerValue

可选

comp_rules array

自定义策略

可选

显示子属性隐藏子属性

items object {4}

显示子属性隐藏子属性

conditions object {2}

策略配置

可选

显示子属性隐藏子属性

children array

一级策略

必选

显示子属性隐藏子属性

items object {6}

显示子属性隐藏子属性

judge string

判定类型，已废弃

必选

key string

匹配类型。可选值: ip_region(IP 地域情报), ip_dynamic(IP 动态情报), device(设备情报), cookie(Cookie), get_param(Query String), referer(Referer), user_agent(UserAgent), ip(IP)

必选

match string

匹配操作符

必选

value string

匹配内容

必选

children array

二级策略

可选

显示子属性隐藏子属性

items object {4}

显示子属性隐藏子属性

judge string

判定类型，已废弃

必选

key string

匹配类型

必选

match string

匹配操作符

必选

value string

匹配内容

必选

conjunction string

必选

conjunction string

策略关系逻辑符。可选值: and(且), or(或)

必选

id string

全局规则ID

可选

judge string

判定结果。可选值: black(黑), white(白)

可选

name string

策略名称，已废弃

可选

business_status integer

风险识别开关

必选

business object {4}

可选

显示子属性隐藏子属性

action string

处置动作。可选值: deny(拦截), log(观察), slider_captcha(滑块), strict_slider_captcha(严格滑块), source_mark(回源标记), husc(人机识别)

必选

header_key string

回源标记headerKey

必选

header_value string

回源标记headerValue

必选

rules object {3}

必选

显示子属性隐藏子属性

position string

账号位置。可选值: cookie(Cookie名称), query(Query参数), body(Body参数)

必选

account_type string

账号类型。可选值: phone(手机号), sha1(手机号Sha1)

必选

param_name string

参数名称

必选

business_marks array

必选

显示子属性隐藏子属性

items object {2}

显示子属性隐藏子属性

mark_name string

风险标签。可选值: fraud(诈骗风险), machine(机器注册), cheat(营销作弊), risk(风险账号)

必选

mark_level array

风险等级

必选

显示子属性隐藏子属性

items string

可选值: low(低), middle(中), high(高)

sigchl_status integer

高级Bot防御开关

必选

sigchl object {1}

动态令牌挑战

必选

显示子属性隐藏子属性

rules array

必选

显示子属性隐藏子属性

items object {1}

显示子属性隐藏子属性

custom_type string

可选值: sig(签名验证异常), ts(签名时间戳异常), webdriver(WebDriver攻击)

必选

js_status integer

JS脚本过滤开关

可选

示例代码

新增或保存Bot模板

请求示例

curl -X POST "https://example.com/v1/waf/botTemplate/save" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "测试模板",
  "switch": 1,
  "web_sdk": "auto",
  "bind_info": [],
  "ai_defense_status": 1,
  "ip_limit_status": 0,
  "custom_limit_status": 0,
  "path": [],
  "custom_rules_status": 0,
  "business_status": 0,
  "business_marks": [],
  "sigchl_status": 0,
  "sigchl": {"rules": []}
}'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

status integer

状态码

必选

msg string

返回消息

必选

templateKey string

模板Key

必选

保存成功后的返回结果

成功响应

{
  "status": 0,
  "msg": "success",
  "templateKey": "temp-xxxxx"
}

百度智能云

Web 应用防火墙 WAF

Web 应用防火墙 WAF

请求参数

示例代码

返回响应

Web 应用防火墙 WAF

Bot模板 保存

请求参数

示例代码

返回响应

Bot模板保存