Fortinet Document Library

Version:


Table of Contents

Trend Micro Control Manager

1.0.0
Copy Link

About the connector

Trend Micro Control Manager provides a central threat and DLP policy management across layers of your IT infrastructure.

This document provides information about the Trend Micro Control Manager connector, which facilitates automated interactions, with your Trend Micro Control Manager server using FortiSOAR™ playbooks. Add the Trend Micro Control Manager connector, as a step in FortiSOAR™ playbooks and perform automated operations such as isolating a specified endpoint from the network and restoring an isolated endpoint to the network.

Version information

Connector Version: 1.0.0

FortiSOAR™ versions Tested on: 4.12.1-243

Authored By: CyberSponse

Certified: Yes

Installing the connector

All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:

yum install cyops-connector-trendmicro-control-manager

For the detailed procedure to install a connector, click here

Prerequisites to configuring the connector

  • You must have the IP address of the Trend Micro Control Manager server to which you will connect and perform automated operations and credentials (App ID and API key) to access that server.
  • To access the FortiSOAR™ UI, ensure that port 443 is open through the firewall for the CyOPsTM instance.

Configuring the connector

For the procedure to configure a connector, click here

Configuration parameters

In FortiSOAR™, on the Connectors page, select the Trend Micro Control Manager connector row, and in the Configure tab enter the required configuration details.

Parameter Description
Server IP IP address of the Trend Micro Control Manager server to which you will connect and perform the automated operations.
App ID App ID to access the Trend Micro Control Manager server to which you will connect and perform the automated operations.
API Key API Key to access the Trend Micro Control Manager server to which you will connect and perform the automated operations.
Verify SSL Specifies whether the SSL certificate for the server is to be verified or not.
By default, this option is set as True.

Actions supported by the connector

The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 onwards:

Function Description Annotation and Category
Isolate Endpoint Isolates a specified endpoint from the network based on the IP address you have specified. isolate_endpoint
Containment
Restore Isolated Endpoint Restores an isolated endpoint to the network based on the IP address you have specified. restore_isolated_endpoint
Remediation

operation: Isolate Endpoint

Input parameters

Parameter Description
IP Address IP address of the endpoint that you want to isolate from the network.

Output

The output contains the following populated JSON schema:

     "result_description": "", 
     "result_code": "", 
     "result_content": [ 
         { 
             "managing_server_id": "", 
             "product": "", 
             "host_name": "", 
             "ip_address_list": "", 
             "entity_id": "", 
             "folder_path": "", 
             "isolation_status": "", 
             "ad_domain": "", 
             "capabilities": [], 
             "mac_address_list": "" 
         } 
     ] 
}

operation: Restore Isolated Endpoint

Input parameters

Parameter Description
IP Address IP address of the endpoint that you want to restore to the network.

Output

The output contains the following populated JSON schema:

     "result_description": "", 
     "result_code": "", 
     "result_content": [ 
         { 
             "managing_server_id": "", 
             "product": "", 
             "host_name": "", 
             "ip_address_list": "", 
             "entity_id": "", 
             "folder_path": "", 
             "isolation_status": "", 
             "ad_domain": "", 
             "capabilities": [], 
             "mac_address_list": "" 
         } 
     ] 
}

Included playbooks

The Sample - Trend Micro Control Manager - 1.0.0 playbook collection comes bundled with the Trend Micro Control Manager connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Trend Micro Control Manager connector.

  • Isolate Endpoint
  • Restore Isolated Endpoint

Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.

About the connector

Trend Micro Control Manager provides a central threat and DLP policy management across layers of your IT infrastructure.

This document provides information about the Trend Micro Control Manager connector, which facilitates automated interactions, with your Trend Micro Control Manager server using FortiSOAR™ playbooks. Add the Trend Micro Control Manager connector, as a step in FortiSOAR™ playbooks and perform automated operations such as isolating a specified endpoint from the network and restoring an isolated endpoint to the network.

Version information

Connector Version: 1.0.0

FortiSOAR™ versions Tested on: 4.12.1-243

Authored By: CyberSponse

Certified: Yes

Installing the connector

All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:

yum install cyops-connector-trendmicro-control-manager

For the detailed procedure to install a connector, click here

Prerequisites to configuring the connector

Configuring the connector

For the procedure to configure a connector, click here

Configuration parameters

In FortiSOAR™, on the Connectors page, select the Trend Micro Control Manager connector row, and in the Configure tab enter the required configuration details.

Parameter Description
Server IP IP address of the Trend Micro Control Manager server to which you will connect and perform the automated operations.
App ID App ID to access the Trend Micro Control Manager server to which you will connect and perform the automated operations.
API Key API Key to access the Trend Micro Control Manager server to which you will connect and perform the automated operations.
Verify SSL Specifies whether the SSL certificate for the server is to be verified or not.
By default, this option is set as True.

Actions supported by the connector

The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 onwards:

Function Description Annotation and Category
Isolate Endpoint Isolates a specified endpoint from the network based on the IP address you have specified. isolate_endpoint
Containment
Restore Isolated Endpoint Restores an isolated endpoint to the network based on the IP address you have specified. restore_isolated_endpoint
Remediation

operation: Isolate Endpoint

Input parameters

Parameter Description
IP Address IP address of the endpoint that you want to isolate from the network.

Output

The output contains the following populated JSON schema:

     "result_description": "", 
     "result_code": "", 
     "result_content": [ 
         { 
             "managing_server_id": "", 
             "product": "", 
             "host_name": "", 
             "ip_address_list": "", 
             "entity_id": "", 
             "folder_path": "", 
             "isolation_status": "", 
             "ad_domain": "", 
             "capabilities": [], 
             "mac_address_list": "" 
         } 
     ] 
}

operation: Restore Isolated Endpoint

Input parameters

Parameter Description
IP Address IP address of the endpoint that you want to restore to the network.

Output

The output contains the following populated JSON schema:

     "result_description": "", 
     "result_code": "", 
     "result_content": [ 
         { 
             "managing_server_id": "", 
             "product": "", 
             "host_name": "", 
             "ip_address_list": "", 
             "entity_id": "", 
             "folder_path": "", 
             "isolation_status": "", 
             "ad_domain": "", 
             "capabilities": [], 
             "mac_address_list": "" 
         } 
     ] 
}

Included playbooks

The Sample - Trend Micro Control Manager - 1.0.0 playbook collection comes bundled with the Trend Micro Control Manager connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the Trend Micro Control Manager connector.

Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.