網頁防篡改防護配置新增
更新時間 2025-01-16 10:31:39
最近更新時間: 2025-01-16 10:31:39
分享文章
接口功能介紹
防護配置新增
接口約束
此功能為收費功能。確認已經購買網頁防篡改配額，并且開啟防篡改掃描配置。如果沒有購買配額，可按照頁面提示進行購買。如果沒有開啟防護，請在服務器列表頁開啟機器防護
URI
POST /v1/tamperproof/config/add
路徑參數
無
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 資源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 請求地址類型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| custName | 是 | String | 防護服務器名稱 | 測試配置 | |
| serverIp | 是 | String | 防護服務器IP | 166.0.0.2 | |
| agentGuid | 是 | String | 服務器對應guid | 121212121212 | |
| os | 否 | String | 操作系統 linux /window,不區分大小寫。不傳則默認為linux，傳非window的任意字符串會當作linux處理，校驗目錄的合法性 | linux | |
| tamperproofDirectoryConfigList | 是 | Array of Objects | tamperproofDirectoryConfigList | list | |
| quotaId | 是 | String | 網頁防篡改配額id | b720a8b8781a4ae38b8fd9c35adc3297 |
表 list
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| agentGuid | 是 | String | 服務器對應guid | 121212121212 | |
| serverIp | 是 | String | 服務器ip | 166.0.0.2 | |
| fileType | 是 | String | 文件類型，黑名單防護或白名單排除文件類型，各類型通過"$"和"|"分割，以"$"結尾 | ||
| secureType | 是 | Byte | 防護類型 0：白名單 1：黑名單 |
1 | |
| secureDirectory | 是 | String | 防護目錄，不能為null | 目錄進行字符串反轉，然后用base64編碼如/opt/secure反轉eruces/tpo/ ,將eruces/tpo/ 進行base64編碼 | |
| backupDirectory | 是 | String | 本地備份目錄，不能為null | 目錄進行字符串反轉，然后用base64編碼如/opt/secure反轉eruces/tpo/ ,將eruces/tpo/ 進行base64編碼 | |
| excludeDirectory | 否 | String | 排除目錄，可以為空可以為null | /opt/exclude | |
| excludeFile | 否 | String | 排除指定文件，可為null | x.jsp$\ |
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | String | 狀態碼 200-成功 | ||
| error | String | 返回碼 CTCSSCN_000000：成功 CTCSSCN_000001：失敗 CTCSSCN_000003：用戶未簽署協議，安全衛士系統無法正常使用 CTCSSCN_000004：鑒權錯誤 CTCSSCN_000005：用戶沒有付費版配額，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回對象 |
枚舉參數
無
請求示例
請求url
無
請求頭header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
請求體body
{"ctyunUserId": "1","autoRepair": 0,"os": "linux","secureStatus": 1,"serverIp": "166.0.0.2","custName": "測試配置","agentGuid":"121212121212","quotaId":"2","tamperproofDirectoryConfigList": [{"backupDirectory": "/opt/backup","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/backup1","excludeDirectory": "/opt/exclude1|/opt/exclude2","excludeFile": "xxx.jsp$","fileType": ".jpeg$|.jsp$|.png$|.gif$","secureDirectory": "/opt/project1","secureType": 1,"agentGuid":"121212121212","serverIp": "166.0.0.2"}]}
響應示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查詢成功!","returnObj": 1}
狀態碼
請參考
錯誤碼
請參考
