Enable Web Tamper Proofing to Protect Server Files - Security Center

Configures and enables web tamper proofing for a specified server.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
Mode	string	Yes	The protection mode of web tamper proofing. Valid values: whitelist: In this mode, web tamper proofing is enabled for the specified directories and file types. blacklist: In this mode, web tamper proofing is enabled for the unspecified subdirectories, file types, and files in the protected directory.	whitelist
LocalBackupDir	string	Yes	The local path to the backup files of the protected directory. The directory format of a Linux server is different from that of a Windows server. You must enter the directory in the required format based on your operating system. Examples: Linux server: /usr/local/aegis/bak Windows server: C:\Program Files (x86)\Alibaba\Aegis\bak	/usr/local/backup
ExclusiveFile	string	No	The file for which you want to disable web tamper proofing. Note If you set Mode to blacklist, you must specify this parameter.	/home/admin/tomcat/localhost.log
Dir	string	Yes	The directory for which you want to enable web tamper proofing. Separate multiple directories with commas (,).	/home/admin/tomcat
InclusiveFileType	string	No	The type of the file for which you want to enable web tamper proofing. Separate multiple types with semicolons (;). Valid values: php jsp asp aspx js cgi html htm xml shtml shtm jpg gif png Note If you set Mode to whitelist, you must specify this parameter.	php
Uuid	string	Yes	The UUID of the server for which you want to enable web tamper proofing.	80d2f7d6-31a9-4d7f-8ff4-7ecc42f89ca****
ExclusiveFileType	string	No	The type of the file for which you want to disable web tamper proofing. Separate multiple types with semicolons (;). Valid values: php jsp asp aspx js cgi html htm xml shtml shtm jpg gif png Note If you set Mode to blacklist, you must specify this parameter.	jpg
ExclusiveDir	string	No	The directory for which you want to disable web tamper proofing. Note If you set Mode to blacklist, you must specify this parameter.	/home/admin/java
DefenceMode	string	Yes	The prevention mode. Valid values: block: Interception Mode audit: Alert Mode	block

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request, which is used to locate and troubleshoot issues.	D9354C1A-D709-4873-9AAE-41513327B247

Examples

Sample success responses

JSONformat

{
  "RequestId": "D9354C1A-D709-4873-9AAE-41513327B247"
}

Error codes

HTTP status code	Error code	Error message	Description
400	IllegalParam	Illegal param	-
400	DuplicatedDirectory	Duplicated directory	-
400	NeedBuy	This service shoule be purchased first.	-
400	DefenceEmptyConfig	At least one protection directory is needed.	-
400	DefenceAuthLimit	The number of machines has reached the upper limit.	-
400	BindDataExist	The binding data already exists.	-
403	NoPermission	caller has no permission	You are not authorized to do this operation.
500	InternalError	The request processing has failed due to some unknown error.	-
500	ServerError	ServerError	-

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2024-09-24	The Error code has changed	View Change Details
2022-08-01	The Error code has changed	View Change Details