接口功能介绍
防护配置修改
接口约束
此功能为收费功能。请您确认已经购买网页防篡改配额，并且开启防护。如果没有购买配额，可按照页面提示进行购买。如果没有开启防护，请在服务器列表页开启防护。
URI
POST /v1/tamperproof/config/update
路径参数
无
Query参数
无
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
accessKey | 是 | String | 鉴权公钥(安全卫士系统提供) | 18ee9b6b63e411e8b4a7186590d96509 | |
contentMD5 | 是 | String | 参数MD5值。默认使用空字符（""）计算 | 1B2M2Y8AsgTpgAmY7PhCfg== | |
requestDate | 是 | String | 请求时间 | Mon, 29 Aug 2022 00:59:26 UTC | |
hmac | 是 | String | 使用HMAC算法生成信息摘要。HMAC原始信息中需要的字段：使用HMAC加密是，需要密钥和待加密消息。 1.密钥使用接口方提供的secretKey，作为加密密钥。 2.待加密消息：contentMD5、requestDate 、servicePath；三个部分通过"\n"进行连接。连接顺序contentMD5\nrequestDate\nservicePath： | mTOyK30c+4Poit2857iXCb8N7Qc= | |
urlType | 否 | String | 请求地址类型。EOPAPI（默认），CTAPI，API | EOPAPI |
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
custName | 是 | String | 防护服务器名称 | 测试配置 | |
serverIp | 是 | String | 防护服务器IP | 166.0.0.2 | |
agentGuid | 是 | String | 服务器对应guid | 121212121212 | |
os | 是 | String | 操作系统 | linux | |
secureStatus | 是 | Byte | 服务器防护状态，0：关闭防护、1：开启防护 | 1 | |
tamperproofDirectoryConfigList | 是 | String | list |
表list
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
agentGuid | 是 | String | 服务器对应guid | 121212121212 | |
serverIp | 是 | String | 服务器ip | 166.0.0.2 | |
fileType | 是 | String | 文件类型，黑名单防护/白名单排除文件类型，各类型通过 | 分割，以结尾，例如：.log$ | ||
secureType | 是 | Byte | 防护类型，0：白名单、1：黑名单 | 0 | |
secureDirectory | 是 | String | 防护目录 | /opt/backup | |
backupDirectory | 是 | String | 本地备份目录 | /opt/exclude | |
excludeDirectory | 是 | String | 排除目录 | /opt/exclude | |
excludeFile | 是 | String | 排除指定文件 | x.jsp\|x.png |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
code | 是 | String | 返回码。取值范围： 0：成功。 -1：失败。 -3：用户未签署协议，安全卫士系统无法正常使用。 -4：鉴权错误。 -5：用户没有付费版配额，功能不可用。 | 0 | |
message | 是 | String | 返回信息 | 成功 | |
data | 是 | String | 返回对象 |
请求示例
请求头header
{
"regionid": "100054c0416811e9a6690242ac110002",
"accessKey": "18ee9b6b63e411e8b4a7186590d96509",
"contentMD5": "1B2M2Y8AsgTpgAmY7PhCfg==",
"hmac": "mTOyK30c+4Poit2857iXCb8N7Qc=",
"requestDate": "Mon, 29 Aug 2022 00:59:26 UTC"
}
请求体body
{
"ctyunUserId": "1",
"autoRepair": 0,
"os": "linux",
"secureStatus": 0,
"serverIp": "166.0.0.2",
"serverName": "EOP修改测试--",
"agentGuid":"121212121212",
"quotaId":"w1",
"tamperproofDirectoryConfigList": [
{
"backupDirectory": "/opt/backup33",
"excludeDirectory": "/opt/exclude",
"excludeFile": "x.jsp$|x.png$|x.gif$",
"fileType": ".jpeg$",
"secureDirectory": "/opt/project",
"secureType": 0,
"agentGuid":"121212121212",
"serverIp": "166.0.0.2"
},
{
"backupDirectory": "/opt/backup33",
"excludeDirectory": "/opt/exclude1|/opt/exclude2",
"excludeFile": "xxx.jsp$",
"fileType": ".jpeg$|.jsp$|.png$|.gif$",
"secureDirectory": "/opt/project1",
"secureType": 0,
"agentGuid":"121212121212",
"serverIp": "166.0.0.2"
}
]
}
响应示例
{
"code": "0",
"message": "成功!",
"data": 1
}
状态码
状态码 | 描述 |
200 | 表示请求成功。 |
错误码
请参考错误码说明。
