Trust Rulesets

List Trust Rulesets

get/applicationcontroltrustrulesets

List all trust rulesets.

Related SDK Methods:
Java

TrustRulesetsApi.listTrustRulesets([param1, param2, ...])

Python

TrustRulesetsApi.list_trust_rulesets([param1, param2, ...])

JavaScript

TrustRulesetsApi.listTrustRulesets([param1, param2, ...])

Request
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 rulesets.

Request samples
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.TrustRulesetsApi;
import com.trendmicro.deepsecurity.model.TrustRulesets;


public class ListTrustRulesetsExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			TrustRulesets result = instance.listTrustRulesets(apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.listTrustRulesets");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "trustRuleSetCount": 0,
  • "applicationControlTrustRulesets": [
    ]
}

Create a Trust Ruleset

post/applicationcontroltrustrulesets

Create a new trust ruleset.

Related SDK Methods:
Java

TrustRulesetsApi.createTrustRuleset([param1, param2, ...])

Python

TrustRulesetsApi.create_trust_ruleset([param1, param2, ...])

JavaScript

TrustRulesetsApi.createTrustRuleset([param1, param2, ...])

Request
header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

The settings of the new trust ruleset.

description
string

Description of the trust ruleset. Searchable as String.

name
string

Name of the trust ruleset. Searchable as String.

Responses
200

successful operation

403

Not authorized to create trust rulesets.

Request samples
application/json
{
  • "name": "string",
  • "description": "string"
}
Response samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "version": 0,
  • "createdTime": 0,
  • "lastUpdatedTime": 0,
  • "usageCount": 0,
  • "ID": 0
}

Describe a Trust Ruleset

get/applicationcontroltrustrulesets/{acTrustRulesetID}

Describe a trust ruleset by ID.

Related SDK Methods:
Java

TrustRulesetsApi.describeTrustRuleset([param1, param2, ...])

Python

TrustRulesetsApi.describe_trust_ruleset([param1, param2, ...])

JavaScript

TrustRulesetsApi.describeTrustRuleset([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset 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 rulesets.

404

The trust ruleset does not exist.

Request samples
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.TrustRulesetsApi;
import com.trendmicro.deepsecurity.model.TrustRuleset;


public class DescribeTrustRulesetExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		Long acTrustRulesetID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			TrustRuleset result = instance.describeTrustRuleset(acTrustRulesetID, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.describeTrustRuleset");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "version": 0,
  • "createdTime": 0,
  • "lastUpdatedTime": 0,
  • "usageCount": 0,
  • "ID": 0
}

Modify a Trust Ruleset

post/applicationcontroltrustrulesets/{acTrustRulesetID}

Modify a trust ruleset's attributes by trust ruleset ID, including trust rule assignment.

Related SDK Methods:
Java

TrustRulesetsApi.modifyTrustRuleset([param1, param2, ...])

Python

TrustRulesetsApi.modify_trust_ruleset([param1, param2, ...])

JavaScript

TrustRulesetsApi.modifyTrustRuleset([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset 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 ruleset to modify.

description
string

Description of the trust ruleset. Searchable as String.

name
string

Name of the trust ruleset. Searchable as String.

ruleIds
Array of integers <int64>

List of rule Ids.

Responses
200

successful operation

403

Not authorized to modify trust rulesets.

404

The trust ruleset does not exist.

Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "ruleIds": [
    ]
}
Response samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "version": 0,
  • "createdTime": 0,
  • "lastUpdatedTime": 0,
  • "usageCount": 0,
  • "ID": 0
}

Delete a Trust Ruleset

delete/applicationcontroltrustrulesets/{acTrustRulesetID}

Delete a trust ruleset by ID.

Related SDK Methods:
Java

TrustRulesetsApi.deleteTrustRuleset([param1, param2, ...])

Python

TrustRulesetsApi.delete_trust_ruleset([param1, param2, ...])

JavaScript

TrustRulesetsApi.deleteTrustRuleset([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset 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 trust rulesets.

404

The trust ruleset does not exist.

405

Cannot delete a trust ruleset that is in use.

Request samples
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.TrustRulesetsApi;


public class DeleteTrustRulesetExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		Long acTrustRulesetID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			instance.deleteTrustRuleset(acTrustRulesetID, apiVersion);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.deleteTrustRuleset");
			e.printStackTrace();
		}
	}
}

Delete a Trust Rule from a Trust Ruleset

delete/applicationcontroltrustrulesets/{acTrustRulesetID}/rules/{acTrustRuleID}

Delete a single trust rule from a trust ruleset by the trust ruleset ID and the trust rule ID.

Related SDK Methods:
Java

TrustRulesetsApi.deleteTrustRuleFromTrustRuleset([param1, param2, ...])

Python

TrustRulesetsApi.delete_trust_rule_from_trust_ruleset([param1, param2, ...])

JavaScript

TrustRulesetsApi.deleteTrustRuleFromTrustRuleset([param1, param2, ...])

Request
path Parameters
acTrustRuleID
required
integer <int64> \d+

The ID number of the trust rule to delete.

Example: 1
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset.

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 trust rules.

404

The trust ruleset or the trust rule does not exist.

Request samples
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.TrustRulesetsApi;


public class DeleteTrustRuleFromTrustRulesetExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		Long acTrustRulesetID = 1L;
		Long acTrustRuleID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			instance.deleteTrustRuleFromTrustRuleset(acTrustRulesetID, acTrustRuleID, apiVersion);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.deleteTrustRuleFromTrustRuleset");
			e.printStackTrace();
		}
	}
}

List Trust Rules in a Trust Ruleset

get/applicationcontroltrustrulesets/{acTrustRulesetID}/rules

List all trust rules in a trust ruleset by trust ruleset ID.

Related SDK Methods:
Java

TrustRulesetsApi.listTrustRulesetRules([param1, param2, ...])

Python

TrustRulesetsApi.list_trust_ruleset_rules([param1, param2, ...])

JavaScript

TrustRulesetsApi.listTrustRulesetRules([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID of the trust ruleset.

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 list the trust rules in a trust ruleset.

Request samples
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.TrustRulesetsApi;
import com.trendmicro.deepsecurity.model.TrustRules;


public class ListTrustRulesetRulesExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		Long acTrustRulesetID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			TrustRules result = instance.listTrustRulesetRules(acTrustRulesetID, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.listTrustRulesetRules");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "trustRuleCount": 0,
  • "applicationControlTrustRules": [
    ]
}

Add Trust Rule IDs

post/applicationcontroltrustrulesets/{acTrustRulesetID}/rules

Assign additional trust rule IDs to a trust ruleset.

Related SDK Methods:
Java

TrustRulesetsApi.addTrustRules([param1, param2, ...])

Python

TrustRulesetsApi.add_trust_rules([param1, param2, ...])

JavaScript

TrustRulesetsApi.addTrustRules([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset.

Example: 1
header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

The ID numbers of the trust rules to add.

ruleIDs
Array of integers <int64>
Responses
200

successful operation

403

Not authorized to modify trust rulesets.

404

The trust ruleset or rules do not exist.

Request samples
application/json
{
  • "ruleIDs": [
    ]
}
Response samples
application/json
{
  • "ruleIDs": [
    ]
}

Set Trust Rule IDs in a Ruleset

put/applicationcontroltrustrulesets/{acTrustRulesetID}/rules

Set only the specified trust rule IDs to be assigned to the trust ruleset.

Related SDK Methods:
Java

TrustRulesetsApi.setTrustRules([param1, param2, ...])

Python

TrustRulesetsApi.set_trust_rules([param1, param2, ...])

JavaScript

TrustRulesetsApi.setTrustRules([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID number of the trust ruleset 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 ID numbers of the trust rules to set.

ruleIDs
Array of integers <int64>
Responses
200

successful operation

403

Not authorized to modify trust rulesets.

404

The trust ruleset does not exist.

Request samples
application/json
{
  • "ruleIDs": [
    ]
}
Response samples
application/json
{
  • "ruleIDs": [
    ]
}

List a Trust Ruleset Assignment

get/applicationcontroltrustrulesets/{acTrustRulesetID}/assignments

List a trust ruleset's computer and policy assignment by the trust ruleset ID.

Related SDK Methods:
Java

TrustRulesetsApi.listTrustRulesetAssignments([param1, param2, ...])

Python

TrustRulesetsApi.list_trust_ruleset_assignments([param1, param2, ...])

JavaScript

TrustRulesetsApi.listTrustRulesetAssignments([param1, param2, ...])

Request
path Parameters
acTrustRulesetID
required
integer <int64> \d+

The ID of the trust ruleset

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 access trust ruleset.

404

The trust ruleset does not exist.

Request samples
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.TrustRulesetsApi;
import com.trendmicro.deepsecurity.model.TrustRulesetAssignments;


public class ListTrustRulesetAssignmentsExample {
	
	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
		TrustRulesetsApi instance = new TrustRulesetsApi();
		Long acTrustRulesetID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			TrustRulesetAssignments result = instance.listTrustRulesetAssignments(acTrustRulesetID, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling TrustRulesetsApi.listTrustRulesetAssignments");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "computers": [
    ],
  • "policies": [
    ]
}