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.
