Fortinet Document Library

Version:


Table of Contents

1.0.0
Copy Link

About the connector

 

ForeScout provides insight into diverse types of devices connected to your heterogeneous network—from campus and data center to cloud and operational technology networks.

 

This document provides information about the ForeScout connector, which facilitates automated interactions with a ForeScout server using FortiSOAR™playbooks. Add the ForeScout connector as a step in FortiSOAR™playbooks and perform automated operations, such as retrieving a list of all active endpoints and retrieving host details based on the IP address, Mac Address, or Host ID that you have specified.

 

Version information

Connector Version: 1.0.0

Authored By: Fortinet.

Certified: No

 

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-forescout

For the detailed procedure to install a connector, click here.

 

Configuring the connector

For the procedure to configure a connector, click here.

 

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
Get Active Hosts Retrieves a list of all active endpoints in CounterACT. get_hosts
Investigation
Get Host Information Retrieves information about a specific host based on the IP address, Mac Address, or Host ID that you have specified. get_endpoint_info
Investigation
Get Host Properties Retrieves a list of host properties. get_host_properties
Investigation
Get Policies Retrieves a list of all policies defined in CounterACT and their subrules. get_policies
Investigation

 

Included playbooks

The Sample - ForeScout - 1.0.0 playbook collection comes bundled with the ForeScout connector. This playbook contains steps using which you can perform all supported actions. You can see the bundled playbooks in the Automation > Playbooks section in FortiSOAR™after importing the ForeScout 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.

 

About the connector

 

ForeScout provides insight into diverse types of devices connected to your heterogeneous network—from campus and data center to cloud and operational technology networks.

 

This document provides information about the ForeScout connector, which facilitates automated interactions with a ForeScout server using FortiSOAR™playbooks. Add the ForeScout connector as a step in FortiSOAR™playbooks and perform automated operations, such as retrieving a list of all active endpoints and retrieving host details based on the IP address, Mac Address, or Host ID that you have specified.

 

Version information

Connector Version: 1.0.0

Authored By: Fortinet.

Certified: No

 

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-forescout

For the detailed procedure to install a connector, click here.

 

Configuring the connector

For the procedure to configure a connector, click here.

 

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
Get Active Hosts Retrieves a list of all active endpoints in CounterACT. get_hosts
Investigation
Get Host Information Retrieves information about a specific host based on the IP address, Mac Address, or Host ID that you have specified. get_endpoint_info
Investigation
Get Host Properties Retrieves a list of host properties. get_host_properties
Investigation
Get Policies Retrieves a list of all policies defined in CounterACT and their subrules. get_policies
Investigation

 

Included playbooks

The Sample - ForeScout - 1.0.0 playbook collection comes bundled with the ForeScout connector. This playbook contains steps using which you can perform all supported actions. You can see the bundled playbooks in the Automation > Playbooks section in FortiSOAR™after importing the ForeScout 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.