文档
测试

子域名配置

POST
http://domain/api/v1/subdomain/sets

请求头

参数名
类型
描述
必填
Content-Type
string
application/json
必填
apiKey
string
TkF2MFa9ZAfdOvoQoFIvM9Ch0NTLRzltL5DROGT8xGqCNkzv75qucmM7uxzxi0Nn
必填

请求参数

参数名
类型
描述
必填
func
string
方法名
可选
subDomains
array
子域名(批量)
可选

响应参数

参数名
类型
描述
必填
status
int
状态码
必填
msg
string
说明
必填
data
json
必填

说明 / 示例

### 子域名配置请求方法: --- ==策略== **关闭防火墙** stopWaf = 开关状态,ture=开启,false=关闭 ``` { "func": "stopWaf", "subDomains": [ "www.1.com", "www.2.com" ], "security": { "stopWaf": true } } ``` **User-Agent屏蔽** UserAgentAction 0-仅预警 1-仅拦截 3-IP拉入黑名单 isBanEmptyUA 屏蔽空UA -1=关闭 1=开启 UserAgent 模糊匹配 如:屏蔽非英文ua正則(模糊匹配添加上这个正则会屏蔽掉英文以外其他文字的ua访问):[^a-zA-Z\s0-9\.\/\(\)\,\;]+ matchUserAgnet 精准匹配 ``` { "func":"UserAgent", "subDomains":[ "www.1.com", "www.2.com" ], "security":{ "UserAgentAction":1, "UserAgent":[ "1", "2" ], "matchUserAgnet":[ "2", "3" ], "isBanEmptyUA":1 } } ``` **User-Agent白名单** RegexWhiteUserAgent 正则匹配 如:屏蔽非英文ua正則(模糊匹配添加上这个正则会屏蔽掉英文以外其他文字的ua访问):[^a-zA-Z\s0-9\.\/\(\)\,\;]+ WhiteUserAgent = 模糊匹配 ``` { "subDomains":[ "www.1.com" ], "func": "WhiteUserAgent", "RegexWhiteUserAgent": "abcd", "security": { "WhiteUserAgent": [ "a", "b", "c", "d" ] } } ``` **URL白名单** ``` { "func":"whiteurl", "subDomains":[ "www.1.com" ], "security":{ "whiteurl":[ "/url1", "/url2" ] } } ``` **URL黑名单** ``` { "func":"blackurl", "subDomains":[ "www.1.com" ], "security":{ "whiteurl":[ "/url1", "/url2" ] } } ``` **防御策略** guardlevel = 0 , 0=关闭,2=开启js盾防御,3=开启验证码防御 ``` { "func":"guardlevel", "subDomains":[ "www.1.com" ], "security":{ "guardlevel":2 } } ``` **区域屏蔽** banArea_states 开关状态,ture=开启,false=关闭 banArea 开启有效,屏蔽的地区(GET http://dommain/api/v1/country/lists)获取地区 ``` { "func":"banArea", "subDomains":[ "www.1.com", "www.2.com" ], "security":{ "banArea_states":true, "banArea":[ "美国", "中非共和国" ] } } ``` **触发防御频率** badReqOnSec 普通频率 异常请求数量5~1000 badReqTick 普通频率 每多少秒 STBadReqOnSec 基站频率 每2秒异常请求数量5~1000 STBadReqTick 基站频率 每多少秒 ``` { "func":"badReq", "subDomains":[ "www.1.com" ], "security":{ "badReqOnSec":100, "badReqTick":10, "STBadReqOnSec":100, "STBadReqTick":10 } } ``` **URL访问限制** URLAction = 拦截动作 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 URLLimit = 每多少秒单个IP请求设置都URL次数5~10000 URLLimitTTL = 搭配URLLimit ,多少秒内 UrlPathRegex = URL地址,如:/test/a.html ``` { "func": "UrlLimit", "subDomains":[ "www.1.com", "www.2.com" ], "security": { "UrlLimit": [ { "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string1" }, { "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string2" } ] } } ``` **同IP访问限制** IPLimitAction = 拦截动作 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 ipLimit = 普通IP 异常请求数量5~1000 ipLimitTTL = 每多少秒 STIpLimit = 基站IP 每2秒异常请求数量5~1000 STIpLimitTTL = 每多少秒 ``` { "func": "ipLimit", "subDomains":[ "www.1.com", "www.2.com" ], "security": { "IPLimitAction": 1, "ipLimit": 100, "ipLimitTTL":2, "STIpLimit": 100, "STIpLimitTTL":2 } } ``` **白名单IP访问限制** WhiteIPAction = 拦截动作 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 WhiteIPLimit = 请求不同URL次数 IP过白后访问限制,每秒单个IP同时请求不同URL(资源)次数5~10000,该数值设置太低会导致频繁误封报错,建议大于100 WhiteIPLimitTTL = 每多少秒 WhiteBadReqOnSec = 请求同一URL次数 IP过白后访问限制,每2秒单个IP请求同一URL(资源)或者顺序请求中相同地址包含过多,次数5~10000,该数值设置太低会导致频繁误封报错,建议大于150 WhiteBadReqTick = 每多少秒 ``` { "func": "WhiteIPLimit", "subDomains":[ "www.1.com", "www.2.com" ], "security": { "WhiteIPAction": 0, "WhiteIPLimit": 100, "WhiteIPLimitTTL":2, "WhiteBadReqOnSec": 100, "WhiteBadReqTick":2 } } ``` **白名单IP单个URL访问限制** URLAction = 拦截动作 0-仅预警 1-仅拦截 2-弹出验证码(失败拉黑) 3-IP拉入黑名单 URLLimit = IP过白后访问限制,每多少秒单个IP请求设置都URL次数5~10000 URLLimitTTL = 搭配URLLimit ,多少秒内 UrlPathRegex = URL地址,如:/test/a.html ``` { "func": "WhiteUrlLimit", "subDomains":[ "www.1.com", "www.2.com" ], "security": { "WhiteUrlLimit": [ { "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string1" }, { "URLAction": 1, "URLLimit": 10, "URLLimitTTL": 2, "UrlPathRegex": "string2" } ] } } ``` [更多子域名配置请点击 >>](https://bak.easydoc.net/doc/58754509/PjoBZp5c/E9u6RGym)