Trust Rules

Describe a Trust Rule

get/applicationcontroltrustrules/{acTrustRuleID}

Describe a trust rule by ID.

Related SDK Methods:

Java

TrustRulesApi.describeTrustRule([param1, param2, ...])

Python

TrustRulesApi.describe_trust_rule([param1, param2, ...])

JavaScript

TrustRulesApi.describeTrustRule([param1, param2, ...])

Request

Security:

DefaultAuthentication

path Parameters

acTrustRuleID

required

integer <int64> \d+

The ID number of the trust rule to describe.

Example: 1

header Parameters

api-version

required

string

The version of the api being called.

Example: YOUR VERSION

Responses

200

successful operation

403

Not authorized to view trust rules.

404

The trust rule does not exist.

Request samples

Java
Python
JavaScript

import com.trendmicro.deepsecurity.ApiClient;
import com.trendmicro.deepsecurity.Configuration;
import com.trendmicro.deepsecurity.auth.ApiKeyAuth;
import com.trendmicro.deepsecurity.ApiException;
import com.trendmicro.deepsecurity.api.TrustRulesApi;
import com.trendmicro.deepsecurity.model.ApplicationControlTrustRule;


public class DescribeTrustRuleExample {
	
	public static void main(String[] args) {
		// Setup
		ApiClient defaultClient = Configuration.getDefaultApiClient();
		defaultClient.setBasePath("YOUR HOST");

		// Authentication
		ApiKeyAuth DefaultAuthentication = (ApiKeyAuth) defaultClient.getAuthentication("DefaultAuthentication");
		DefaultAuthentication.setApiKey("YOUR API KEY");
		try {
			defaultClient.trustAllCertificates(false);
		} catch (Exception e) {
			System.err.println("An exception occurred when calling ApiClient.trustAllCertificates");
			e.printStackTrace();
		}
		
		// Initialization
		// Set Any Required Values
		TrustRulesApi instance = new TrustRulesApi();
		Long acTrustRuleID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			ApplicationControlTrustRule result = instance.describeTrustRule(acTrustRuleID, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesApi.describeTrustRule");
			e.printStackTrace();
		}
	}
}

Response samples

application/json

{"type": "allowFromSourceTarget",
"name": "string",
"description": "string",
"isAssigned": true,
"createdTime": 0,
"lastUpdatedTime": 0,
"rulesetIDs": [0
],
"attributes": [{"name": "string",
"value": "string"
}
],
"ID": 0
}

Modify a Trust Rule

post/applicationcontroltrustrules/{acTrustRuleID}

Modify a trust rule by ID.

Related SDK Methods:

Java

TrustRulesApi.modifyTrustRule([param1, param2, ...])

Python

TrustRulesApi.modify_trust_rule([param1, param2, ...])

JavaScript

TrustRulesApi.modifyTrustRule([param1, param2, ...])

Request

Security:

DefaultAuthentication

path Parameters

acTrustRuleID

required

integer <int64> \d+

The ID of the trust rule to modify.

Example: 1

header Parameters

api-version

required

string

The version of the api being called.

Example: YOUR VERSION

Request Body schema: application/json

The attributes of the trust rule to modify.

	Array of objects (TrustRuleAttribute) List of rule attributes.
description	string Description of the trust rule. Searchable as String.
name	string Name of the trust rule. Searchable as String.

Responses

200

successful operation

403

Not authorized to modify trust ruleset.

404

The trust rule does not exist.

Request samples

Payload
Java
Python
JavaScript

application/json

{"name": "string",
"description": "string",
"attributes": [{"name": "string",
"value": "string"
}
]
}

Response samples

application/json

{"type": "allowFromSourceTarget",
"name": "string",
"description": "string",
"isAssigned": true,
"createdTime": 0,
"lastUpdatedTime": 0,
"rulesetIDs": [0
],
"attributes": [{"name": "string",
"value": "string"
}
],
"ID": 0
}

Delete a Trust Rule.

delete/applicationcontroltrustrules/{acTrustRuleID}

Delete a trust rule by ID.

Related SDK Methods:

Java

TrustRulesApi.deleteTrustRule([param1, param2, ...])

Python

TrustRulesApi.delete_trust_rule([param1, param2, ...])

JavaScript

TrustRulesApi.deleteTrustRule([param1, param2, ...])

Request

Security:

DefaultAuthentication

path Parameters

acTrustRuleID

required

integer <int64> \d+

The ID number of the trust rule to delete.

Example: 1

header Parameters

api-version

required

string

The version of the api being called.

Example: YOUR VERSION

Responses

200

Request is successful.

403

Not authorized to delete a trust rule.

404

The trust rule does not exist.

Request samples

Java
Python
JavaScript

import com.trendmicro.deepsecurity.ApiClient;
import com.trendmicro.deepsecurity.Configuration;
import com.trendmicro.deepsecurity.auth.ApiKeyAuth;
import com.trendmicro.deepsecurity.ApiException;
import com.trendmicro.deepsecurity.api.TrustRulesApi;


public class DeleteTrustRuleExample {
	
	public static void main(String[] args) {
		// Setup
		ApiClient defaultClient = Configuration.getDefaultApiClient();
		defaultClient.setBasePath("YOUR HOST");

		// Authentication
		ApiKeyAuth DefaultAuthentication = (ApiKeyAuth) defaultClient.getAuthentication("DefaultAuthentication");
		DefaultAuthentication.setApiKey("YOUR API KEY");
		try {
			defaultClient.trustAllCertificates(false);
		} catch (Exception e) {
			System.err.println("An exception occurred when calling ApiClient.trustAllCertificates");
			e.printStackTrace();
		}
		
		// Initialization
		// Set Any Required Values
		TrustRulesApi instance = new TrustRulesApi();
		Long acTrustRuleID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			instance.deleteTrustRule(acTrustRuleID, apiVersion);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesApi.deleteTrustRule");
			e.printStackTrace();
		}
	}
}

List all Trust Rules

get/applicationcontroltrustrules

List all trust rules.

Related SDK Methods:

Java

TrustRulesApi.listTrustRules([param1, param2, ...])

Python

TrustRulesApi.list_trust_rules([param1, param2, ...])

JavaScript

TrustRulesApi.listTrustRules([param1, param2, ...])

Request

Security:

DefaultAuthentication

header Parameters

api-version

required

string

The version of the api being called.

Example: YOUR VERSION

Responses

200

successful operation

403

Not authorized to list trust rules.

Request samples

Java
Python
JavaScript

import com.trendmicro.deepsecurity.ApiClient;
import com.trendmicro.deepsecurity.Configuration;
import com.trendmicro.deepsecurity.auth.ApiKeyAuth;
import com.trendmicro.deepsecurity.ApiException;
import com.trendmicro.deepsecurity.api.TrustRulesApi;
import com.trendmicro.deepsecurity.model.TrustRules;


public class ListTrustRulesExample {
	
	public static void main(String[] args) {
		// Setup
		ApiClient defaultClient = Configuration.getDefaultApiClient();
		defaultClient.setBasePath("YOUR HOST");

		// Authentication
		ApiKeyAuth DefaultAuthentication = (ApiKeyAuth) defaultClient.getAuthentication("DefaultAuthentication");
		DefaultAuthentication.setApiKey("YOUR API KEY");
		try {
			defaultClient.trustAllCertificates(false);
		} catch (Exception e) {
			System.err.println("An exception occurred when calling ApiClient.trustAllCertificates");
			e.printStackTrace();
		}
		
		// Initialization
		// Set Any Required Values
		TrustRulesApi instance = new TrustRulesApi();
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			TrustRules result = instance.listTrustRules(apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesApi.listTrustRules");
			e.printStackTrace();
		}
	}
}

Response samples

application/json

{"trustRuleCount": 0,
"applicationControlTrustRules": [{"type": "allowFromSourceTarget",
"name": "string",
"description": "string",
"isAssigned": true,
"createdTime": 0,
"lastUpdatedTime": 0,
"rulesetIDs": [0
],
"attributes": [{"name": "string",
"value": "string"
}
],
"ID": 0
}
]
}

Create a Trust Rule

post/applicationcontroltrustrules

Create a new trust rule.

Related SDK Methods:

Java

TrustRulesApi.createTrustRule([param1, param2, ...])

Python

TrustRulesApi.create_trust_rule([param1, param2, ...])

JavaScript

TrustRulesApi.createTrustRule([param1, param2, ...])

Request

Security:

DefaultAuthentication

header Parameters

api-version

required

string

The version of the api being called.

Example: YOUR VERSION

Request Body schema: application/json

Settings of the new trust rule.

	Array of objects (TrustRuleAttribute) Attributes that define the trust rule.
description	string Description of the trust rule. Searchable as String.
name	string Name of the trust rule. Searchable as String.
type	string Type of the rule. Searchable as Choice. Enum: "allowFromSourceTarget" "allowFromSource" "allowByTarget" "ignoreFromSource" "blockByTarget"

Responses

200

successful operation

403

Not authorized to create trust rules.

Request samples

Payload
Java
Python
JavaScript

application/json

{"type": "allowFromSourceTarget",
"name": "string",
"description": "string",
"attributes": [{"name": "string",
"value": "string"
}
]
}

Response samples

application/json

{"type": "allowFromSourceTarget",
"name": "string",
"description": "string",
"isAssigned": true,
"createdTime": 0,
"lastUpdatedTime": 0,
"rulesetIDs": [0
],
"attributes": [{"name": "string",
"value": "string"
}
],
"ID": 0
}

➔ Next to Trust Rulesets