AddWebDefCcRule-添加 CC 防护规则--DDoS防护-火山引擎

文档中心

立即注册

导航

AddWebDefCcRule-添加 CC 防护规则

最近更新时间：2024.07.19 19:17:48首次发布时间：2024.07.19 19:17:48

为防护网站配置 CC 规则后，DDoS 高防服务会限制对网站特定路径的访问频率，精准识别 CC 攻击，缓解 CC 攻击对服务器的影响。

注意事项

每个域名最多支持配置 20 条 CC 防护规则。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=AddWebDefCcRule&Version=2023-03-08

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`AddWebDefCcRule`	接口名称。当前 API 的名称为 `AddWebDefCcRule`。
Version	String	是	`2023-03-08`	接口版本。当前 API 的版本为 `2023-03-08`。

Body

参数	类型	是否必选	示例值	描述
AccurateGroup	Object of WafV3Accurate	否	`--`	更多请求特征配置。
CCType	Integer	是	`7`	规则执行动作。 0：仅告警，放行满足条件的请求，但会将对应请求行为计入攻击日志。 1：限速，拦截超出阈值的请求，被拦截的请求将不会转发回源站。 2：拦截，拦截满足条件的请求，被拦截的请求将不会转发回源站。 7：人机验证，对满足条件的请求执行人机验证，验证通过则放行，否则拦截。
CountTime	Integer	是	`60`	统计时长，单位：秒。
EffectTime	Integer	否	`60`	生效时长，即限制时长，单位：秒。执行动作为"仅告警"时无需填写。
Enable	Integer	是	`1`	是否启用规则。 0：关闭 1：启用
Field	String	是	`HEADER:User-Agent`	统计对象，多个对象用逗号分隔。格式为`类型:对应值`。自定义 Header。格式为`HEADER:具体参数`，例如`HEADER:Authorization` 自定义 Cookie。格式为`COOKIE:具体参数`，例如`COOKIE:PHPSESSId`。自定义参数。格式为`ARGS:具体参数`，例如`ARGS:device_Id`。源 IP。直接配置为`CLIENTIP`。统计对象，多个对象用逗号分隔。格式为类型:对应值
Host	String	是	`www.test.com`	防护域名。
Name	String	是	`test`	规则名称。支持英文、汉字和数字，不支持特殊字符。最多不超过 20 个字符。
PathThreshold	Integer	否	`100`	请求路径访问的总次数阈值。
PrefixSwitch	Integer	是	`0`	前缀匹配开关。启用前缀匹配后，可提供包含某个前缀的路径匹配模式。如设置路径为`/test*`，则匹配`/test.html`，`/test123.html`，`/test/page.html`等 0：关闭 1：开启
RulePriority	Integer	是	`0`	规则匹配的优先级，P0 优先级最高，P9 优先级最低。说明同一请求特征下的 CC 防护规则优先级不可重复。
SingleThreshold	Integer	是	`10`	每个统计对象访问的次数阈值。
Url	String	否	`/cctest`	需要进行 CC 防护规则匹配的网站路径，可以填写具体的某个页面 URL，也可以填写整个网站。默认填写：支持某个具体的 URL 地址，例如针对`test.com/abc.html`页面生效，则填写`/abc.html`即可。支持含通配符的路径，如`/test/`。通配符仅可使用一次。针对整个网站，则填写`/`即可。前缀匹配：勾选前缀匹配后，可提供包含某个前缀的路径匹配模式。如设置`/test`，则匹配`/test.html`，`/test123.html`，`/test/page.html`等。说明默认模式下（即未勾选前缀匹配时）配置的`/`路径规则优先级高于前缀匹配模式下配置`/*`路径的规则。

WafV3Accurate

参数类型是否必选示例值描述

参数	类型	是否必选	示例值	描述
Logic	Integer	否	`1`	规则组中高级条件运算关系。 1：与 2：或
AccurateRules	Array of WafAccurateRuleItem	否	`--`	规则组的请求特征信息。

Logic

Integer

否

1

规则组中高级条件运算关系。

1：与
2：或

AccurateRules Array of WafAccurateRuleItem 否 -- 规则组的请求特征信息。

WafAccurateRuleItem

参数	类型	是否必选	示例值	描述
HttpObj	String	否	`request.method`	自定义对象，与`ObjType`存在映射关系。请求协议：`request.schema` 请求 uri：`request.uri` 请求方法：`request.method` 请求路径：`request.path` 请求参数：`request.queryargs` 请求头：`request.header` 请求 User-Agent：`request.header.ua` 请求 refer：`request.header.refer` 请求 Cookies：`request.header.cookies` 请求体长度：`request.header.content-length` 请求体格式：`request.header.content-type` X-forwarded-for：`request.header.x-forwarded-for` 客户端 IP：`request.header.clientip` 自定义 Args：`request.queryargs.自定义参数名称`。例如`request.queryargs.abc`。自定义 header：`request.header.自定义Header 名称`。例如`request.header.abc`。自定义 cookie：`request.cookie.自定义 cookie 名称`。例如`request.cookie.abc`。
ObjType	Integer	否	`2`	匹配字段。 0：请求协议 1：请求 uri 2：请求方法 3：请求路径 4：请求参数 5：请求头 6：请求 User-Agent 7：请求 refer 8：请求 Cookies 9：请求体长度 10：请求体格式 11：X-forwarded-for 12：客户端 IP 13：自定义 Args 14：自定义 header 15：自定义 cookie
Opretar	Integer	否	`2`	逻辑运算符。 0：大于 1：大于等于 2：等于 3：小于 4：小于等于 5：不等于 6：包含子串 7：不包含子串 8：包含前缀 9：不包含前缀 10：包含后缀 11：不包含后缀 12：包含所有匹配集合 13：不包含所有匹配集合 14：属于匹配集合 15：不属于匹配集合 16：正则 17：判断为 IP 18：判断为 IPv4 19：判断为 IPv6 20：判断为私网 IP 21：判断为公网 IP
Property	Integer	否	`0`	固定取值为 0，取 HttpObj 的值用于匹配对应详情。
ValueString	String	否	`GET`	匹配内容。说明逻辑关系判断为 IP、 IPv4、 IPv6、私网 IP 或公网 IP 时不需要填写。

返回参数

无。

请求示例

POST https://open.volcengineapi.com/?Action=AddWebDefCcRule&Version=2023-03-08
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240610T082509Z
X-content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240610/cn-beijing/AdvDefence/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
    "AccurateGroup": {
        "Id": 56697,
        "Logic": 1,
        "AccurateRules": [
            {
                "HttpObj": "request.method",
                "ObjType": 2,
                "Opretar": 2,
                "Property": 0,
                "ValueString": "GET"
            }
        ],
        "AccurateGroupPriority": 1073741824
    },
    "CCType": 7,
    "CountTime": 60,
    "EffectTime": 60,
    "Enable": 1,
    "Field": "HEADER:User-Agent",
    "Host": "www.test.com",
    "Name": "test",
    "PathThreshold": 100,
    "PrefixSwitch": 0,
    "RulePriority": 0,
    "SingleThreshold": 10,
    "Url": "/cctest"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "AddWebDefCcRule",
        "Version": "2023-03-08",
        "Service": "AdvDefence",
        "Region": "cn-beijing"
    }
}