ForescoutEyeInspect

Delivers flexible and scalable OT/ICS asset visibility.

Network Security · Forescout EyeInspect

Details

IDForescoutEyeInspect
ProviderAdvent International
CategoryNetwork Security
From Version6.0.1
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Forescout EyeInspect

Delivers flexible and scalable OT/ICS asset visibility.
This integration was integrated and tested with version 4.2.20 of Forescout EyeInspect.

Configure Forescout EyeInspect in Cortex

Parameter Description Required
Server URL   True
Username   True
Password   True
Trust any certificate (not secure)   False
Use system proxy settings   False
Maximum incidents per fetch Default is 50. Maximum is 200. False
First fetch timestamp (<number> <time unit>, like 12 hours, 7 days)   False
Incident type   False
Fetch incidents   False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

forescout-ei-host-list


Retrieves information about the hosts in the eyeInspect CC database.

Base Command

forescout-ei-host-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional
last_seen List only records with the last seen timestamp greater than or equal to the provided parameter. Optional
id_min Retrieve hosts that are equal to or greater than the specified ID. Optional
ip A comma-separated list of IP addresses. The command will filter the results from the returned page according to the provided values. Optional
vlan_id A comma-separated list of VLAN IDs. The command will filter the results from the returned page according to the provided values. Optional
mac_address A comma-separated list of MAC addresses. The command will filter the results from the returned page according to the provided values. Optional
sensor_id A comma-separated list of sensor IDs. The command will filter the results from the returned page according to the provided values. Optional
sort_field List records and sort them based on the specified field, as well as on the ID. Also, the command will filter the results from the returned page. Possible values are: ip_reuse_domain_id, ip_reuse_domain, address, ip, vlan, nested_address, mac_addresses, sorted_mac_addresses, real_mac_addresses, sorted_real_mac_addresses, observed_mac_addresses, sorted_observed_mac_addresses, mac_vendors, vendor_with_real_macs, vendor_with_observed_macs, sensor_ids, is_broadcast_ip, is_multicast_ip, is_public_ip, is_learnt_host, name, all_names, description, role, all_roles, vendor_model, all_vendors_models, os_version, client_proto_port_info, server_proto_port_info, first_seen, last_seen, labels, sorted_labels, purdue_level, criticality, firmware_version, hardware_version, serial_number, project, ip_type, monitored_networks, open_ports, complex_cves, sorted_client_protocols, sorted_server_protocols, module_count, sorted_module_details, security_risk, operational_risk, alert_count. Optional
sort_ascending Indicates whether the result list should be sorted in ascending or descending order. Possible values are: true, false. Optional

Context Output

Path Type Description
ForescoutEyeInspect.Host.id Number The unique ID of the host in the eyeInspect CC.
ForescoutEyeInspect.Host.ip_reuse_domain_id Number The unique ID of the IP Reuse Domain the host is in.
ForescoutEyeInspect.Host.ip String The IP address of the host.
ForescoutEyeInspect.Host.nested_address String In case of a nested device host, the nested address of the host.
ForescoutEyeInspect.Host.vlan String The VLAN ID of the host.
ForescoutEyeInspect.Host.mac_addresses String The MAC addresses associated to the host.
ForescoutEyeInspect.Host.sensor_ids String The unique IDs of the sensors that have “seen” this host.
ForescoutEyeInspect.Host.main_name String The main name of the host.
ForescoutEyeInspect.Host.description String Description of the host.
ForescoutEyeInspect.Host.os_version String The operating system version of the host.
ForescoutEyeInspect.Host.first_seen String The ISO-formatted timestamp of when the host was first seen.
ForescoutEyeInspect.Host.last_seen String The ISO-formatted timestamp of when the host was last seen.
ForescoutEyeInspect.Host.open_ports String The open TCP and UDP ports of the host.

Command example

!forescout-ei-host-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "Host": {
            "first_seen": "2022-03-18T00:58:27.000+01:00",
            "host_mac_addresses": [],
            "id": 34558,
            "ip": "20.190.159.71",
            "ip_reuse_domain_id": 1,
            "last_seen": "2022-03-18T00:58:27.000+01:00",
            "mac_addresses": [
                "C4:24:56:A4:86:11"
            ],
            "nested_address": "",
            "sensor_ids": [
                9
            ],
            "vlan": ""
        }
    }
}

Human Readable Output

Hosts List

Current page size: 1
Showing page 1 out of others that may exist.

ID IP MAC Addresses
34558 20.190.159.71 C4:24:56:A4:86:11

forescout-ei-link-list


Retrieves information about the links in the eyeInspect CC database.

Base Command

forescout-ei-link-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional
src_host_id List only records with the src_host_id property set to the specified value. Optional
dst_host_id List only records with the dst_host_id property set to the specified value. Optional
proto List only records with the proto field containing the specified value. Optional
port List only records with one of the values of the port property equal to the specified parameter. Optional
last_seen List only records with the last_seen timestamp greater than or equal to the provided parameter. Optional
id_min Retrieve links that are greater than or equal to the specified ID. Optional
sort_field List records and sort them based on the specified field, as well as on the ID. Possible values are: src_host_id, dst_host_id, proto, ports, tx_bytes, rx_bytes, first_seen, last_seen. Optional
sort_ascending Indicates whether the result list should be sorted in ascending or descending order. Possible values are: true, false. Optional

Context Output

Path Type Description
ForescoutEyeInspect.Link.id Number The unique ID of the link in the eyeInspect CC.
ForescoutEyeInspect.Link.src_host_id Number The unique ID of the source host in the eyeInspect CC.
ForescoutEyeInspect.Link.dst_host_id Number The unique ID of the destination host in the eyeInspect CC.
ForescoutEyeInspect.Link.proto String The name of the protocol (application layer (L7) and transport or datalink layer (L4 or L3/L2) detected for the link.
ForescoutEyeInspect.Link.tx_bytes Number The total number of bytes sent upstream (i.
ForescoutEyeInspect.Link.rx_bytes Number The total number of bytes sent downstream (i.
ForescoutEyeInspect.Link.first_seen String Timestamp in ISO format of when the link was first seen.
ForescoutEyeInspect.Link.last_seen String Timestamp in ISO format of when the link was last seen.
ForescoutEyeInspect.Link.ports String TCP or UDP ports used in the link.

Command example

!forescout-ei-link-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "Link": {
            "dst_host_id": 34555,
            "first_seen": "2022-03-18T10:28:47.000+01:00",
            "id": 203725,
            "last_seen": "2022-03-18T10:28:56.000+01:00",
            "proto": "FailedConnection (TCP)",
            "src_host_id": 8
        }
    }
}

Human Readable Output

Host Links List

Current page size: 1
Showing page 1 out of others that may exist.

ID Source Host ID Destination Host ID Protocol
203725 8 34555 FailedConnection (TCP)

forescout-ei-vulnerability-info-get


Retrieves information about a specific vulnerability stored in the eyeInspect CC database.

Base Command

forescout-ei-vulnerability-info-get

Input

Argument Name Description Required
cve_id The unique ID of the vulnerability information record to be retrieved. The CVE ID can be retrieved from public vulnerability databases, such as NVD, or from the “CVEs and IoCs” page inside Forescout EyeInspect. Required

Context Output

Path Type Description
ForescoutEyeInspect.CVE.id String The vulnerability ID.
ForescoutEyeInspect.CVE.cve_id String The CVE ID from the NVD.
ForescoutEyeInspect.CVE.icsa_id String The ICS Cert Security Advisory ID related to the vulnerability.
ForescoutEyeInspect.CVE.vendor_specific_id String The vendor-specific advisory ID related to the vulnerability.
ForescoutEyeInspect.CVE.published_date String The timestamp in ISO format when the vulnerability information was published.
ForescoutEyeInspect.CVE.last_modified_date String The timestamp in ISO format when the vulnerability information was last modified.
ForescoutEyeInspect.CVE.cvss_score Number The CVSS score of the vulnerability.
ForescoutEyeInspect.CVE.cvss_temporal_score Number The CVSS temporal score of the vulnerability.
ForescoutEyeInspect.CVE.cvss_access_vector String The CVSS access vector scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_access_complexity String The CVSS access complexity scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_authentication String The CVSS authentication scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_confidentiality_impact String The CVSS confidentiality impact scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_integrity_impact String The CVSS integrity impact scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_availability_impact String The CVSS availability impact scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_exploitability String The CVSS exploitability scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_remediation_level String The CVSS remediation level scoring of the vulnerability.
ForescoutEyeInspect.CVE.cvss_reporting_confidence String The CVSS reporting confidence scoring of the vulnerability.
ForescoutEyeInspect.CVE.references String The list of references (URLs) related to the vulnerability.
ForescoutEyeInspect.CVE.vendor String The vendor of the product affected by the vulnerability.
ForescoutEyeInspect.CVE.title String A short summary of the vulnerability.
ForescoutEyeInspect.CVE.description String Description of the vulnerability (including list of vulnerable devices and versions).
ForescoutEyeInspect.CVE.solution String Description of the proposed vulnerability solution (including to what version to update the software/firmware).

Command example

!forescout-ei-vulnerability-info-get cve_id=CVE-2019-20218

Context Example

{
    "ForescoutEyeInspect": {
        "CVE": {
            "cve_id": "CVE-2019-20218",
            "cvss_access_complexity": "LOW",
            "cvss_access_vector": "NETWORK",
            "cvss_authentication": "NONE",
            "cvss_availability_impact": "PARTIAL",
            "cvss_confidentiality_impact": "NONE",
            "cvss_exploitability": "UNDEFINED",
            "cvss_integrity_impact": "NONE",
            "cvss_remediation_level": "UNAVAILABLE",
            "cvss_reporting_confidence": "CONFIRMED",
            "cvss_score": 5,
            "cvss_temporal_score": 0,
            "cvss_version": "VERSION_2",
            "icsa_id": "",
            "id": "CVE-2019-20218",
            "last_modified_date": "2020-04-14T02:00:00.000+02:00",
            "published_date": "2018-11-27T01:00:00.000+01:00",
            "references": [
                {
                    "label": "Siemens CERT",
                    "url": "https://cert-portal.siemens.com/productcert/pdf/ssb-439005.pdf"
                }
            ],
            "solution": "Siemens is working on an update for the firmware, and recommends the following mitigations until an update is available:\n - Apply Defense-in-Depth: https://www.siemens.com/cert/operational-guidelines-industrial-security\n - Only build and run applications from trusted sources",
            "summary": "selectExpander in select.c in SQLite 3.30.1 proceeds with WITH stack unwinding even after a parsing error.\n VULNERABLE PRODUCT\n - SIMATIC S7-1500 CPU 1518(F)-4 PN/DP MFP (incl. SIPLUS variant): firmware version V2.6.1, and might also affect previous versions of the firmware",
            "title": "Improper handling of exceptional conditions vulnerability in SQLite database in the SIMATIC S7-1500 CPU 1518(F)-4 PN/DP MFP",
            "vendor": "Siemens",
            "vendor_specific_id": "SSB-439005"
        }
    }
}

Human Readable Output

CVE CVE-2019-20218 Information

ID Title Published Date Cvss Score
CVE-2019-20218 Improper handling of exceptional conditions vulnerability in SQLite database in the SIMATIC S7-1500 CPU 1518(F)-4 PN/DP MFP 2018-11-27T01:00:00.000+01:00 5.0

forescout-ei-alert-list


Retrieves information about the alerts inside eyeInspect CC.

Base Command

forescout-ei-alert-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional
start_timestamp List only records with the timestamp property greater than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00. Optional
end_timestamp List only records with the timestamp property less than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00. Optional
event_type_id List records that have the event_type_id property containing the specified parameter. Optional
l4_proto List records that have the l4_proto property equal to the specified parameter. Possible values are: TCP, UDP, ICMP, UNDEFINED. Optional
l7_proto List records that have the l7_proto property equal to the specified parameter. Optional
src_ip List records that have the src_ip property equal to the specified parameter, or contained in the given CIDR-defined network. Optional
dst_ip List records that have the dst_ip property equal to the specified parameter, or contained in the given CIDR-defined network. Optional
ip List records that have either the src_ip or the dst_ip property equal to the specified parameter, or contained in the given CIDR-defined network. Optional
severity A comma-separated list of severities. The command will filter the results from the returned page according to the provided values. Optional
vlan_id A comma-separated list of vLAN IDs. The command will filter the results from the returned page according to the provided values. Optional
status A comma-separated list of statuses. The command will filter the results from the returned page according to the provided values. Possible values are: Not analysed, In progress, Analyzed, False alert, Relevant, Not relevant, Unknown, Trimmed. Optional
sensor_name A comma-separated list of sensor names. The command will filter the results from the returned page according to the provided values. Optional
dst_port Fetch records that have the dst_port property equal to the specified parameter. Optional
src_host_id List records that have the src_ip or src_mac property equal to the IP address or MAC address of the host with ID equal to the specified parameter. Optional
dst_host_id List records that have the dst_ip or dst_mac property equal to the IP address or MAC address of the host with ID equal to the specified parameter. Optional
host_id List records that have either the src_ip, src_mac or dst_ip, dst_mac equal to the IP address or MAC address of the host with ID equal to the specified parameter. Optional

Context Output

Path Type Description
ForescoutEyeInspect.Alert.alert_id Number The ID of the alert in the eyeInspect database.
ForescoutEyeInspect.Alert.timestamp String Timestamp of the alert in ISO format.
ForescoutEyeInspect.Alert.event_type_ids String The list of unique IDs identifying the type of events reported in the alert.
ForescoutEyeInspect.Alert.event_type_names String The list of names of the type of events reported in the alert.
ForescoutEyeInspect.Alert.description String A description of the event types reported in the alert, as well as other details regarding the specific alert instance coming from the sensor.
ForescoutEyeInspect.Alert.notes String Notes that a eyeInspect user may have attached to the alert.
ForescoutEyeInspect.Alert.sensor_id Number The unique ID of the sensor firing the Alert.
ForescoutEyeInspect.Alert.sensor_name String The name of the sensor firing the alert.
ForescoutEyeInspect.Alert.engine String The detection engine that raised the Alert.
ForescoutEyeInspect.Alert.profile_module_name String The name of the profile or module that raised the Alert.
ForescoutEyeInspect.Alert.profile_id Number The unique ID of the profile that raised the alert.
ForescoutEyeInspect.Alert.l2_proto String The layer 2 (datalink) protocol.
ForescoutEyeInspect.Alert.l3_proto String The layer 3 (network) protocol.
ForescoutEyeInspect.Alert.l4_proto String The layer 4 (transport) protocol.
ForescoutEyeInspect.Alert.l7_proto String The layer 7 (application) protocol.
ForescoutEyeInspect.Alert.vlan String The VLAN ID used in the network communication reported in the alert.
ForescoutEyeInspect.Alert.src_mac String The MAC address of the host initiating the connection reported in the alert.
ForescoutEyeInspect.Alert.dst_mac String The MAC address of the host receiving the connection reported in the alert.
ForescoutEyeInspect.Alert.src_ip String The IP address of the host initiating the connection reported in the alert.
ForescoutEyeInspect.Alert.dst_ip String The IP address of the host receiving the connection reported in the alert.
ForescoutEyeInspect.Alert.src_port Number The source TCP or UDP port used in the connection reported in the alert.
ForescoutEyeInspect.Alert.dst_port Number The destination TCP or UDP port used in the connection reported in the alert.
ForescoutEyeInspect.Alert.severity Number The severity level of the alert.
ForescoutEyeInspect.Alert.status String The status of the alert.

Command example

!forescout-ei-alert-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "Alert": {
            "alert_id": 1,
            "case_id": 0,
            "case_name": "",
            "description": "TCP portscan: the attacker sends multiple out-of-state ACK packets to scan the victim's hosts and determine the open ports. This might be intelligence gathering or (the first phase of) an attack (e.g., DoS, exploit)\n\nFailed connections:\n - (scanner) 213.8.143.143  \n    - 192.168.92.12  \n        * 54009 (    1 failed connection(s) [ ACK: 1 ] )\n        * 54010 (    1 failed connection(s) [ ACK: 1 ] )\n        * 54011 (    1 failed connection(s) [ ACK: 1 ] )\n        * 54013 (    1 failed connection(s) [ ACK: 1 ] )\n        * 54017 (    1 failed connection(s) [ ACK: 1 ] )\n",
            "direction_certain": false,
            "dst_ip": "192.168.92.12",
            "dst_mac": "",
            "dst_port": 0,
            "engine": "PORTSCAN",
            "event_type_ids": [
                "ps_tcp_ack"
            ],
            "event_type_names": [
                "TCP ACK portscan"
            ],
            "fea_alert_count": 0,
            "fea_duration_sec": 0,
            "fea_start": "1970-01-01T01:00:00.000+01:00",
            "fea_state": "None",
            "hotstart": false,
            "l2_proto": "ETHERNET",
            "l3_proto": "IP",
            "l4_proto": "TCP",
            "l7_proto": "UNDEFINED",
            "labels": "",
            "link": "https://192.168.30.115/evt?id=1",
            "normalized": false,
            "notes": "",
            "profile_id": 0,
            "profile_module_name": "Portscan",
            "sensor_id": 9,
            "sensor_name": "Test1",
            "severity": 2,
            "src_ip": "213.8.143.143",
            "src_mac": "",
            "src_port": 0,
            "status": "Not analyzed",
            "timestamp": "2022-02-03T07:49:50.092+01:00",
            "vlan": "",
            "xsoar_severity": 1
        }
    }
}

Human Readable Output

Alerts List

Current page size: 1
Showing page 1 out of others that may exist.

Alert ID Description Timestamp Source IP Destination IP
1 TCP portscan: the attacker sends multiple out-of-state ACK packets to scan the victim’s hosts and determine the open ports. This might be intelligence gathering or (the first phase of) an attack (e.g., DoS, exploit)

Failed connections:
- (scanner) 213.8.143.143
- 192.168.92.12
54009 ( 1 failed connection(s) [ ACK: 1 ] )
54010 ( 1 failed connection(s) [ ACK: 1 ] )
54011 ( 1 failed connection(s) [ ACK: 1 ] )
54013 ( 1 failed connection(s) [ ACK: 1 ] )
* 54017 ( 1 failed connection(s) [ ACK: 1 ] )
2022-02-03T07:49:50.092+01:00 213.8.143.143 192.168.92.12

forescout-ei-alert-pcap-get


Retrieves the PCAP file associated to a given alert.

Base Command

forescout-ei-alert-pcap-get

Input

Argument Name Description Required
alert_id The unique ID of the alert to get the PCAP of. Required

Context Output

Path Type Description
InfoFile.Size Number The size of the file.
InfoFile.Name String The name of the file.
InfoFile.EntryID String The entry ID of the file.
InfoFile.Info String File information.
InfoFile.Type String The file type.
InfoFile.Extension String The file extension.

Command example

!forescout-ei-alert-pcap-get alert_id=1

Context Example

{
    "InfoFile": {
        "EntryID": "3111@8479e914-8493-4968-8f32-78852375d17b",
        "Extension": "pcap",
        "Info": "application/vnd.tcpdump.pcap",
        "Name": "alert_1_sniff.pcap",
        "Size": 424,
        "Type": "tcpdump capture file (little-endian) - version 2.4 (Ethernet, capture length 65535)"
    }
}

Human Readable Output

forescout-ei-sensor-list


Retrieves information about the sensors associated to the eyeInspect CC.

Base Command

forescout-ei-sensor-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional
all_sensors Whether to retrieve all the sensors (ICS Patrol and passive) or only the passive ones. Possible values are: true, false. Optional
name A comma-separated list of sensor names. The command will filter the results from the returned page according to the provided values. Optional
address A comma-separated list of IP addresses or domain names. The command will filter the results from the returned page according to the provided values. Optional
port A comma-separated list of listening ports. The command will filter the results from the returned page according to the provided values. Optional
type A comma-separated list of sensor types. The command will filter the results according to the provided values. Possible values are: PASSIVE, PATROL. Optional
state A comma-separated list of sensor states. The command will filter the results from the returned page according to the provided values. Possible values are: OPERATIVE_ON, OPERATIVE_OFF, DISCONNECTED, LICENSE_EXPIRED, LICENSE_INVALID, UNKNOWN. Optional

Context Output

Path Type Description
ForescoutEyeInspect.Sensor.id Number Unique ID of the sensor in the eyeInspect CC.
ForescoutEyeInspect.Sensor.name String Name of the sensor.
ForescoutEyeInspect.Sensor.address String IP address or domain name of the sensor’s management interface.
ForescoutEyeInspect.Sensor.port Number TCP port number on which the sensor is listening for incoming CC connections.
ForescoutEyeInspect.Sensor.type String Type of the sensor (PASSIVE / PATROL).
ForescoutEyeInspect.Sensor.sensor_version String Version of the eyeInspect sensor software.
ForescoutEyeInspect.Sensor.state String Current status of the sensor.
ForescoutEyeInspect.Sensor.health_status String Current health status of the sensor.

Command example

!forescout-ei-sensor-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "Sensor": {
            "address": "127.0.0.1",
            "health_status": {
                "cpu_load_avg_1_min": {
                    "current_value": "8.5%",
                    "level": "NORMAL",
                    "name": ""
                },
                "disk_usage": [
                    {
                        "current_value": "8%",
                        "level": "NORMAL",
                        "name": "/"
                    }
                ],
                "dropped_packets": {
                    "current_value": "0%",
                    "level": "NORMAL",
                    "name": ""
                },
                "license_status": {
                    "current_value": "VALID",
                    "level": "NORMAL",
                    "name": ""
                },
                "memory_usage": {
                    "current_value": "84.62%",
                    "level": "WARNING",
                    "name": ""
                },
                "net_if_status": [
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "br-1b1f2d7e6a87"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "ens160"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "ens192"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "veth24fab08"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "vethf0fd758"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "vethfb6c608"
                    }
                ],
                "services": [],
                "throughput": {
                    "current_value": "0.0 bps",
                    "level": "CRITICAL",
                    "name": ""
                }
            },
            "id": 2,
            "name": "sensor1",
            "port": 9999,
            "sensor_version": "4.3.21",
            "state": "OPERATIVE_ON",
            "type": "PASSIVE"
        }
    }
}

Human Readable Output

Sensors List

Current page size: 1
Showing page 1 out of others that may exist.

ID Name Address Port Type
2 sensor1 127.0.0.1 9999 PASSIVE

forescout-ei-sensor-module-list


Retrieves information about the modules of the specified sensor.

Base Command

forescout-ei-sensor-module-list

Input

Argument Name Description Required
sensor_id The unique ID of the sensor to query for modules. Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.SensorModule.id Number Unique ID of the module in the eyeInspect CC.
ForescoutEyeInspect.SensorModule.sensor_id Number Unique ID of the sensor the module is deployed in, in the eyeInspect CC.
ForescoutEyeInspect.SensorModule.engine String Name of the engine powering the module in the sensor.
ForescoutEyeInspect.SensorModule.singleton Boolean Whether the module can only have one single instance or can have multiple instances in the sensor.
ForescoutEyeInspect.SensorModule.name String The name of the module.
ForescoutEyeInspect.SensorModule.description String The description of the module.
ForescoutEyeInspect.SensorModule.started Boolean Whether the module is started or paused in the sensor.
ForescoutEyeInspect.SensorModule.operational_mode String Operational mode of the module in the sensor.
ForescoutEyeInspect.SensorModule.date_last_update String Timestamp in ISO format of when the module was last updated.

Command example

!forescout-ei-sensor-module-list sensor_id=2 page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "SensorModule": {
            "date_last_update": "2022-03-18T11:13:09.898+01:00",
            "description": "",
            "engine": "THREAT_LIBRARY",
            "id": 1,
            "name": "Industrial threat library (ITL)",
            "operational_mode": "",
            "sensor_id": 2,
            "singleton": true,
            "started": true
        }
    }
}

Human Readable Output

Sensor 2 Modules List

Current page size: 1
Showing page 1 out of others that may exist.

ID Name Engine Started
1 Industrial threat library (ITL) THREAT_LIBRARY true

forescout-ei-sensor-module-update


Changes the specified properties of the specified module.

Base Command

forescout-ei-sensor-module-update

Input

Argument Name Description Required
sensor_id The unique ID of the sensor that has the module to update. Required
module_id The unique ID of the module to update. Required
name Name of the module. Optional
description Description of the module. Optional
started If set to true, the module will be started. If set to false, the module will be paused. Possible values are: true, false. Optional
operational_mode Changes the operational mode of the module to the specified value. Possible values are: Learning, Detecting. Optional

Context Output

Path Type Description
ForescoutEyeInspect.SensorModule.id Number Unique ID of the module in the eyeInspect CC.
ForescoutEyeInspect.SensorModule.sensor_id Number Unique ID of the sensor the module is deployed in, in the eyeInspect CC.
ForescoutEyeInspect.SensorModule.engine String Name of the engine powering the module in the sensor.
ForescoutEyeInspect.SensorModule.singleton Boolean Whether the module can only have one single instance or can have multiple instances in the sensor.
ForescoutEyeInspect.SensorModule.name String The name of the module.
ForescoutEyeInspect.SensorModule.description String The description of the module.
ForescoutEyeInspect.SensorModule.started Boolean Whether the module is started or paused in the sensor.
ForescoutEyeInspect.SensorModule.operational_mode String Operational mode of the module in the sensor.
ForescoutEyeInspect.SensorModule.date_last_update String Timestamp in ISO format of when the module was last updated.

Command example

!forescout-ei-sensor-module-update sensor_id=2 module_id=5 started=true

Context Example

{
    "ForescoutEyeInspect": {
        "SensorModule": {
            "date_last_update": "1970-01-01T01:00:00.000+01:00",
            "description": "",
            "engine": "PORTSCAN",
            "id": 5,
            "name": "Portscan",
            "operational_mode": "",
            "sensor_id": 2,
            "singleton": true,
            "started": true
        }
    }
}

Human Readable Output

Updated Module 5 of Sensor 2

Name Engine Started
Portscan PORTSCAN true

forescout-ei-sensor-module-delete


Deletes the specified module from the specified sensor and from the eyeInspect CC database.

Base Command

forescout-ei-sensor-module-delete

Input

Argument Name Description Required
sensor_id The unique ID of the sensor of the module to delete. Required
module_id The unique ID of the module to delete. Required

Context Output

There is no context output for this command.

Command example

!forescout-ei-sensor-module-delete sensor_id=2 module_id=8

Human Readable Output

The module 8 of sensor 2 was successfully deleted

forescout-ei-ip-blacklist-get


Retrieves the IP blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-ip-blacklist-get

Input

Argument Name Description Required
sensor_id The unique ID of the sensor for which to retrieve the IP blacklist. Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.IPBlacklist.address String A blacklisted IP address.
ForescoutEyeInspect.IPBlacklist.comment String A comment provided by the user. The comment might be empty.

Command example

!forescout-ei-ip-blacklist-get sensor_id=2 page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "IPBlacklist": {
            "address": "1.1.1.5",
            "comment": "demo test",
            "sensor_id": 2
        }
    }
}

Human Readable Output

IP Blacklist of Sensor 2

Current page size: 1
Showing page 1 out of others that may exist.

Address Comment
1.1.1.5 demo test

forescout-ei-ip-blacklist-add


Adds a new entry to the IP blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-ip-blacklist-add

Input

Argument Name Description Required
sensor_id The unique ID of the sensor for which to update the IP blacklist. Required
address The IP address to add to the blacklist. Required
comment A comment about the blacklisted IP address. Optional

Context Output

There is no context output for this command.

Command example

!forescout-ei-ip-blacklist-add sensor_id=2 address=3.4.5.6 comment=Malicious

Human Readable Output

New IP Blacklist Entry of Sensor 2

Address Comment
3.4.5.6 Malicious

forescout-ei-domain-blacklist-get


Retrieves the domain name blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-domain-blacklist-get

Input

Argument Name Description Required
sensor_id The unique ID of the sensor that contains the domain blacklist. Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.DomainBlacklist.domain_name String A blacklisted domain name.
ForescoutEyeInspect.DomainBlacklist.comment String A comment provided by the user. The comment might be empty.

Command example

!forescout-ei-domain-blacklist-get sensor_id=2 page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "DomainBlacklist": {
            "comment": "demo command",
            "domain_name": "028xmz.com",
            "sensor_id": 2
        }
    }
}

Human Readable Output

Domain Blacklist of Sensor 2

Current page size: 1
Showing page 1 out of others that may exist.

Domain Name Comment
028xmz.com demo command

forescout-ei-domain-blacklist-add


Adds a new entry to the domain name blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-domain-blacklist-add

Input

Argument Name Description Required
sensor_id The unique ID of the sensor of which the domain to be updated. Required
domain_name The domain name to add to the blacklist. Required
comment A comment about the domain name. Default is Command and Control server. Optional

Context Output

There is no context output for this command.

Command example

!forescout-ei-domain-blacklist-add sensor_id=2 domain_name=malicious.xyz comment=Maleware

Human Readable Output

New Domain Blacklist Entry of Sensor 2

Domain Name Comment
malicious.xyz Maleware

forescout-ei-ssl-client-blacklist-get


Retrieves the SSL client application blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-ssl-client-blacklist-get

Input

Argument Name Description Required
sensor_id The unique ID of the sensor for which to retrieve the SSL client blacklist. Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.SSLClientBlacklist.sensor_id Number The unique ID of the sensor for which to retrieve the SSL client.
ForescoutEyeInspect.SSLClientBlacklist.application_name String The application name related to the entry.
ForescoutEyeInspect.SSLClientBlacklist.ja3_hash String The JA3 hash of a blacklisted client application.
ForescoutEyeInspect.SSLClientBlacklist.comment String A comment provided by the user. The comment might be empty.

Command example

!forescout-ei-ssl-client-blacklist-get sensor_id=2 page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "SSLClientBlacklist": {
            "application_name": "Potential malware: eitest-hoeflertext-chrome-popup-traffic-4-of-6",
            "comment": "Generated from all PCAPs on https://www.malware-traffic-analysis.net",
            "ja3_hash": "098f55e27d8c4b0a590102cbdb3a5f3a",
            "sensor_id": 2
        }
    }
}

Human Readable Output

SSL Client Applications Blacklist of Sensor 2

Current page size: 1
Showing page 1 out of others that may exist.

Application Name Ja3 Hash Comment
Potential malware: eitest-hoeflertext-chrome-popup-traffic-4-of-6 098f55e27d8c4b0a590102cbdb3a5f3a Generated from all PCAPs on https://www.malware-traffic-analysis.net

forescout-ei-ssl-client-blacklist-add


Adds a new entry to the SSL client application blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-ssl-client-blacklist-add

Input

Argument Name Description Required
sensor_id The unique ID of the sensor of which the SSL client. Required
application_name The related application name to add to the blacklist. Required
ja3_hash The JA3 hash of a blacklisted client application. Required
comment Comment about the SSL client application. Optional

Context Output

There is no context output for this command.

Command example

!forescout-ei-ssl-client-blacklist-add sensor_id=2 application_name=Shodan ja3_hash=0ad94fcb7d3a2c56679fbd004f6b12cd comment=Malicious

Human Readable Output

New SSL Client Blacklist Entry of Sensor 2

Application Name Ja3 Hash Comment
Shodan 0ad94fcb7d3a2c56679fbd004f6b12cd Malicious

forescout-ei-file-operation-blacklist-get


Retrieves the file operation blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-file-operation-blacklist-get

Input

Argument Name Description Required
sensor_id The unique ID of the sensor for which to retrieve the file operation blacklist. Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.FileOperationBlacklist.matching_type String The way file or folder should be matched.
ForescoutEyeInspect.FileOperationBlacklist.file_or_folder String The name of the file or folder the entry applies to.
ForescoutEyeInspect.FileOperationBlacklist.operation String The name of the file operation.
ForescoutEyeInspect.FileOperationBlacklist.comment String A comment provided by the user. The comment might be empty.

Command example

!forescout-ei-file-operation-blacklist-get sensor_id=2 page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "FileOperationBlacklist": {
            "comment": "Access 2007 Database File. A database file created with Microsoft Access 2007 or later. It typically contains data organized into tables and fields. (default blacklist entry).",
            "file_or_folder": "\\.accdb$",
            "matching_type": "REGEX",
            "operation": "WRITE",
            "sensor_id": 2
        }
    }
}

Human Readable Output

File Operation Blacklist of Sensor 2

Current page size: 1
Showing page 1 out of others that may exist.

Matching Type File Or Folder Operation Comment
REGEX .accdb$ WRITE Access 2007 Database File. A database file created with Microsoft Access 2007 or later. It typically contains data organized into tables and fields. (default blacklist entry).

forescout-ei-file-operation-blacklist-add


Adds entries to the file operation blacklist from the Industrial Threat Library of the specified sensor.

Base Command

forescout-ei-file-operation-blacklist-add

Input

Argument Name Description Required
sensor_id The unique ID of the sensor for which to update the file operation blacklist. Required
matching_type The way file or folder should be matched. Possible values are: CONTAINS, STARTS_WITH, ENDS_WITH, MATCHES, REGEX. Required
file_or_folder The name of the file or folder the entry applies to. Required
operation The name of the file operation. Possible values are: WRITE, READWRITE. Required
comment A comment provided by the user. Optional

Context Output

There is no context output for this command.

Command example

!forescout-ei-file-operation-blacklist-add sensor_id=2 matching_type=REGEX file_or_folder=\\.mal$ operation=WRITE comment=Virus

Human Readable Output

New File Operation Blacklist Entry of Sensor 2

Matching Type File Or Folder Operation Comment
REGEX .mal$ WRITE Virus

forescout-ei-diagnostics-information-get


Retrieves information about all monitored Command Center resources and their health status excluding the logs.

Base Command

forescout-ei-diagnostics-information-get

Input

| Argument Name | Description | Required |
| — | — | — |

Context Output

Path Type Description
ForescoutEyeInspect.CCInfo.ip_address String IP address of the Command Center.
ForescoutEyeInspect.CCInfo.hostname String Hostname of the Command Center.
ForescoutEyeInspect.CCInfo.open_ports String TCP open port number of the Command Center.
ForescoutEyeInspect.CCInfo.cc_version String Version of the Command Center software.
ForescoutEyeInspect.CCInfo.health_status String Current health status of the Command Center.

Command example


#### Context Example

```json
{
    "ForescoutEyeInspect": {
        "CCInfo": {
            "cc_version": "4.3.21",
            "health_status": {
                "analytics_db_used_mem": {
                    "current_value": "4.3 GiB",
                    "name": ""
                },
                "cpu_load_avg_1_min": {
                    "current_value": "5.5%",
                    "level": "NORMAL",
                    "name": ""
                },
                "disk_usage": [
                    {
                        "current_value": "8%",
                        "level": "NORMAL",
                        "name": "/"
                    }
                ],
                "memory_usage": {
                    "current_value": "84.56%",
                    "level": "WARNING",
                    "name": ""
                },
                "message_queue_used_mem": {
                    "current_value": "602.4 MiB",
                    "name": ""
                },
                "net_if_status": [
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "ens160"
                    },
                    {
                        "current_value": "Not running",
                        "level": "NORMAL",
                        "name": "docker0"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "br-1b1f2d7e6a87"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "ens192"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "vethf0fd758"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "veth24fab08"
                    },
                    {
                        "current_value": "Running",
                        "level": "NORMAL",
                        "name": "vethfb6c608"
                    }
                ],
                "relational_db_used_mem": {
                    "current_value": "3.4 GiB",
                    "name": "silentdefense"
                },
                "web_server_used_mem": {
                    "current_value": "4.4 GiB",
                    "name": ""
                }
            },
            "hostname": "4321-bundle-16g",
            "ip_address": "192.168.30.115",
            "open_ports": [
                "443"
            ]
        }
    }
}

Human Readable Output

Command Center Diagnostics Information

IP Address Hostname Open Ports Cc Version
192.168.30.115 4321-bundle-16g 443 4.3.21

forescout-ei-diagnostic-logs-get


Download the ZIP file which contains diagnostic logs of the Command Center.

Base Command

forescout-ei-diagnostic-logs-get

Input

Argument Name Description Required
cc_info Whether to include Command Center diagnostic logs inside the downloaded zip, in addition to sensors logs. If this value is false, the downloaded zip won’t contain the general server logs, but only the logs about the sensors. Possible values are: true, false. Default is True. Optional
sensor_id Include logs from a specific sensor by its ID, or all sensors (by specifying All). Optional

Context Output

Path Type Description
InfoFile.Size Number The size of the file.
InfoFile.Name String The name of the file.
InfoFile.EntryID String The entry ID of the file.
InfoFile.Info String File information.
InfoFile.Type String The file type.
InfoFile.Extension String The file extension.

Command example

!forescout-ei-diagnostic-logs-get sensor_id=2

Context Example

{
    "InfoFile": {
        "EntryID": "3167@8479e914-8493-4968-8f32-78852375d17b",
        "Extension": "zip",
        "Info": "application/zip",
        "Name": "command_center_diagnostic_logs.zip",
        "Size": 26280500,
        "Type": "Zip archive data, at least v2.0 to extract"
    }
}

Human Readable Output

forescout-ei-group-policy-list


Get all group policies.

Base Command

forescout-ei-group-policy-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.GroupPolicy.id Number The ID of the policy.
ForescoutEyeInspect.GroupPolicy.name String The name of the group policy.
ForescoutEyeInspect.GroupPolicy.description String The description of the group policy.
ForescoutEyeInspect.GroupPolicy.constraints Unknown List of constraints of the policy.

Command example

!forescout-ei-group-policy-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "GroupPolicy": {
            "constraints": [
                {
                    "operator": "equals",
                    "os_version": "Windows 10",
                    "type": "os_version"
                }
            ],
            "description": "Test",
            "id": 8,
            "name": "Test Playbook Policy"
        }
    }
}

Human Readable Output

Group Policies List

Current page size: 1
Showing page 1 out of others that may exist.

ID Name Description
8 Test Playbook Policy Test

forescout-ei-group-policy-create


Create a new group policy.

Base Command

forescout-ei-group-policy-create

Input

Argument Name Description Required
name The name of the group policy. Required
description The description of the group policy. Required
constraints List of constraints of the policy.

Each policy constraint is an object that includes the following fields:
type: The type of the constraint. Possible values are os_version, firmware_version, open_ports.
operator: The operator of the constraint. Possible values are equals (all types), allowed (open_ports) and contains (os_version, firmware_version).
os_version: The value of the OS version for the os_version type.
firmware_version: The value of the firmware version for the firmware_version type.
open_ports_tcp: Comma-separated list of ports or range of ports for the open_ports type. Example: “10, 20-30”.
open_ports_udp: Comma-separated list of ports or range of ports for the open_ports type. Example: “10, 20-30”.

Example for list of policy constraints: [{ “type”: “os_version”, “operator”: “contains”, “os_version”: “Windows” }]. .
Required

Context Output

Path Type Description
ForescoutEyeInspect.GroupPolicy.id Number The ID of the policy.
ForescoutEyeInspect.GroupPolicy.name String The name of the group policy.
ForescoutEyeInspect.GroupPolicy.description String The description of the group policy.
ForescoutEyeInspect.GroupPolicy.constraints Unknown List of constraints of the policy.

Command example

!forescout-ei-group-policy-create name="example policy" description="policy" constraints="[{\"type\": \"os_version\", \"operator\": \"equals\", \"os_version\": \"Windows 10\"}]"

Context Example

{
    "ForescoutEyeInspect": {
        "GroupPolicy": {
            "constraints": [
                {
                    "operator": "equals",
                    "os_version": "Windows 10",
                    "type": "os_version"
                }
            ],
            "description": "policy",
            "id": 20,
            "name": "example policy"
        }
    }
}

Human Readable Output

Group Policy Information

ID Name Description
20 example policy policy

Group Policy Constraints

Type Operator Os Version
os_version equals Windows 10

forescout-ei-group-policy-update


Update a group policy. Note: the whole policy will be overridden, therefore all fields are required.

Base Command

forescout-ei-group-policy-update

Input

Argument Name Description Required
policy_id The unique ID of the policy to be updated. Required
name The name of the group policy. Required
description The description of the group policy. Required
constraints List of constraints of the policy.

Each policy constraint is an object that includes the following fields:
type: The type of the constraint. Possible values are os_version, firmware_version, open_ports.
operator: The operator of the constraint. Possible values are equals (all types), allowed (open_ports) and contains (os_version, firmware_version).
os_version: The value of the OS version for the os_version type.
firmware_version: The value of the firmware version for the firmware_version type.
open_ports_tcp: Comma-separated list of ports or range of ports for the open_ports type. Example: “10, 20-30”.
open_ports_udp: Comma-separated list of ports or range of ports for the open_ports type. Example: “10, 20-30”.

Example for list of policy constraints: [{ “type”: “os_version”, “operator”: “contains”, “os_version”: “Windows” }].
Required

Context Output

Path Type Description
ForescoutEyeInspect.GroupPolicy.id Number The ID of the policy.
ForescoutEyeInspect.GroupPolicy.name String The name of the group policy.
ForescoutEyeInspect.GroupPolicy.description String The description of the group policy.
ForescoutEyeInspect.GroupPolicy.constraints Unknown List of constraints of the policy.

Command example

!forescout-ei-group-policy-update policy_id=20 name="example policy" description="policy" constraints="[{\"type\": \"os_version\", \"operator\": \"equals\", \"os_version\": \"Windows 10\"}]"

Context Example

{
    "ForescoutEyeInspect": {
        "GroupPolicy": {
            "constraints": [
                {
                    "operator": "equals",
                    "os_version": "Windows 10",
                    "type": "os_version"
                }
            ],
            "description": "policy",
            "id": 20,
            "name": "example policy"
        }
    }
}

Human Readable Output

Updated Group Policy

ID Name Description
20 example policy policy

Group Policy Constraints

Type Operator Os Version
os_version equals Windows 10

forescout-ei-group-policy-delete


Delete a group policy.

Base Command

forescout-ei-group-policy-delete

Input

Argument Name Description Required
policy_id The unique ID of the policy for which the hosts will be added to. Required

Context Output

There is no context output for this command.

Command example

!forescout-ei-group-policy-delete policy_id=20

Human Readable Output

The group policy 20 was successfully deleted

forescout-ei-group-policy-hosts-assign


Add all hosts not assigned to any policy (individual or group) matching the filter to the group policy.

Base Command

forescout-ei-group-policy-hosts-assign

Input

Argument Name Description Required
policy_id The unique ID of the policy for which the hosts will be added to. Required
filter_type The type of the filter. Possible values are: address, host_mac_address_exact, vendor_model, os_version, firmware_version, ip_reuse_domain. Required
filter_value The value of the filter. Required

Context Output

There is no context output for this command.

Command example

!forescout-ei-group-policy-hosts-assign policy_id=20 filter_type=address filter_value=192.168.1.1

Human Readable Output

1 Additional Hosts Were Assigned to Group Policy 20

forescout-ei-group-policy-hosts-unassign


Unassign all hosts assigned to the group policy matching the filter.

Base Command

forescout-ei-group-policy-hosts-unassign

Input

Argument Name Description Required
policy_id The unique ID of the policy for which the hosts will be removed. Required
filter_type The type of the filter. Possible values are: address, host_mac_address_exact, vendor_model, os_version, firmware_version, ip_reuse_domain. Required
filter_value The value of the filter. Required

Context Output

There is no context output for this command.

Command example

!forescout-ei-group-policy-hosts-unassign policy_id=20 filter_type=address filter_value=192.168.1.1

Human Readable Output

1 Additional Hosts Were Unassigned from Group Policy 20

forescout-ei-ip-reuse-domain-list


Get all IP reuse domains.

Base Command

forescout-ei-ip-reuse-domain-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional

Context Output

Path Type Description
ForescoutEyeInspect.IPReuseDomain.id Number The ID of the IP reuse domain.
ForescoutEyeInspect.IPReuseDomain.name String The name of the IP reuse domain.
ForescoutEyeInspect.IPReuseDomain.description String The description of the IP reuse domain.
ForescoutEyeInspect.IPReuseDomain.address String The address of the IP reuse domain.
ForescoutEyeInspect.IPReuseDomain.mask Number The number of bits in the mask.
ForescoutEyeInspect.IPReuseDomain.vlan_ids String VLAN IDs of the IP reuse domain.

Command example

!forescout-ei-ip-reuse-domain-list page=2 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "IPReuseDomain": {
            "address": "192.168.99.0",
            "description": "Servers IP Reuse",
            "id": 2,
            "mask": 0,
            "name": "servers",
            "vlan_ids": "any"
        }
    }
}

Human Readable Output

IP Reuse Domains List

Current page size: 1
Showing page 2 out of others that may exist.

ID Name Description Address
2 servers Servers IP Reuse 192.168.99.0

forescout-ei-hosts-changelog-list


Retrieves information about the changes of host properties and configuration from the eyeInspect CC database.

Base Command

forescout-ei-hosts-changelog-list

Input

Argument Name Description Required
page The page number of the results to retrieve (minimum is 1). Default is 1. Optional
limit Maximum number of records to retrieve. Default is 50. Optional
host_id List only records with the host_id property equal to the provided parameter. Optional
start_timestamp List only records with the timestamp property greater than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00. Optional
end_timestamp List only records with the timestamp property less than or equal to the specified value. 2020-05-26T15:00:00.000Z+01:00. Optional
event_type_id List only records with the event_type_id property equal to the specified value. Possible values are: hostcl_new_host, hostcl_new_mac, hostcl_new_name, hostcl_new_role, hostcl_new_vendor_model, hostcl_new_os_version, hostcl_changed_os_version, hostcl_new_client_proto, hostcl_new_client_port, hostcl_new_server_proto, hostcl_new_server_port, hostcl_new_label, hostcl_new_fw_version, hostcl_changed_fw_version, hostcl_new_hw_version, hostcl_changed_hw_version, hostcl_changed_serial, hostcl_new_project, hostcl_changed_project, hostcl_new_module, hostcl_changed_module_name, hostcl_changed_module_type, hostcl_changed_module_vendor. Optional
event_category List only records with the event_type_id property equal to the specified value. Possible values are: PROPERTIES, CONFIGURATION, ALL. Optional

Context Output

Path Type Description
ForescoutEyeInspect.HostChangeLog.id Number The unique ID of the HostChangeLog in the eyeInspect CC.
ForescoutEyeInspect.HostChangeLog.timestamp String Timestamp in ISO format of when the host change was detected.
ForescoutEyeInspect.HostChangeLog.event_type_id String An identifier of the type of change detected.
ForescoutEyeInspect.HostChangeLog.event_type_name String A more human readable representation of the type of change detected.
ForescoutEyeInspect.HostChangeLog.event_category String A more general type of the change detected.
ForescoutEyeInspect.HostChangeLog.host_id Number The unique ID of the host in the eyeInspect CC database in which the change was detected.
ForescoutEyeInspect.HostChangeLog.information_source String The source of information for the detected change.
ForescoutEyeInspect.HostChangeLog.sensor_id Number In case the detected change was reported from a sensor, the unique ID in the eyeInspect CC database of the sensor reporting the information.
ForescoutEyeInspect.HostChangeLog.sensor_id Number In case the detected change was reported from a sensor, the unique ID in the eyeInspect CC database of the sensor reporting the information.
ForescoutEyeInspect.HostChangeLog.username String In case the detected change was reported from a eyeInspect user, the username of the user reporting the information.
ForescoutEyeInspect.HostChangeLog.old_value String The old value of the host property.
ForescoutEyeInspect.HostChangeLog.new_value String The new value of the host property.
ForescoutEyeInspect.HostChangeLog.host_address String The IP address, or nested address (in case of a nested device) of the host.
ForescoutEyeInspect.HostChangeLog.host_vlan String The VLAN ID of the host (only present if the process_vlan_tags option is enabled in the sensor).
ForescoutEyeInspect.HostChangeLog.host_name String The main name of the host.
ForescoutEyeInspect.HostChangeLog.host_ip_reuse_domain_id String The unique ID of the IP Reuse Domain the host is in.
ForescoutEyeInspect.HostChangeLog.host_mac_addresses String The MAC addresses associated to the host.

Command example

!forescout-ei-hosts-changelog-list page=1 limit=1

Context Example

{
    "ForescoutEyeInspect": {
        "HostChangeLog": {
            "event_category": "PROPERTIES",
            "event_type_id": "hostcl_new_host",
            "event_type_name": "New host",
            "host_address": "192.168.30.82",
            "host_id": 1,
            "host_ip_reuse_domain_id": 1,
            "host_mac_addresses": [
                "00:50:56:A6:41:89",
                "C4:24:56:A4:86:11"
            ],
            "host_name": "",
            "host_vlan": "",
            "id": 1,
            "information_source": "USER",
            "new_value": "",
            "old_value": "",
            "sensor_id": 0,
            "timestamp": "2022-01-16T17:38:41.505+01:00",
            "username": "admin"
        }
    }
}

Human Readable Output

Hosts Changes List

Current page size: 1
Showing page 1 out of others that may exist.

ID Host ID Event Type Name
1 1 New host

Configuration parameters

  • server_url — Server URL (required)
  • credentials — Username (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • max_fetch — Maximum incidents per fetch
  • first_fetch — First fetch timestamp (<number> <time unit>, like 12 hours, 7 days).
  • incidentType — Incident type
  • incidentFetchInterval — Incidents Fetch Interval
  • isFetch — Fetch incidents

Commands (27)

  • forescout-ei-alert-list

    Retrieves information about the alerts inside eyeInspect CC.

  • forescout-ei-alert-pcap-get

    Retrieves the PCAP file associated to a given alert.

  • forescout-ei-diagnostic-logs-get

    Download the ZIP file that contains diagnostic logs of the Command Center.

  • forescout-ei-diagnostics-information-get

    Retrieves information about all monitored Command Center resources and their health status excluding the logs.

  • forescout-ei-domain-blacklist-add

    Adds a new entry to the domain name blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-domain-blacklist-get

    Retrieves the domain name blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-file-operation-blacklist-add

    Adds entries to the file operation blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-file-operation-blacklist-get

    Retrieves the file operation blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-group-policy-create

    Create a new group policy.

  • forescout-ei-group-policy-delete

    Delete a group policy.

  • forescout-ei-group-policy-hosts-assign

    Add all hosts not assigned to any policy (individual or group) matching the filter to the group policy.

  • forescout-ei-group-policy-hosts-unassign

    Unassign all hosts assigned to the group policy matching the filter.

  • forescout-ei-group-policy-list

    Get all group policies.

  • forescout-ei-group-policy-update

    Update a group policy. Note: Since the entire policy will be overridden, all fields are required.

  • forescout-ei-host-list

    Retrieves information about the hosts in the eyeInspect CC database.

  • forescout-ei-hosts-changelog-list

    Retrieves information about the changes of host properties and configuration from the eyeInspect CC database.

  • forescout-ei-ip-blacklist-add

    Adds a new entry to the IP blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-ip-blacklist-get

    Retrieves the IP blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-ip-reuse-domain-list

    Get all IP reuse domains.

  • forescout-ei-link-list

    Retrieves information about the links in the eyeInspect CC database.

  • forescout-ei-sensor-list

    Retrieves information about the sensors associated to the eyeInspect CC.

  • forescout-ei-sensor-module-delete

    Deletes the specified module from the specified sensor and from the eyeInspect CC database.

  • forescout-ei-sensor-module-list

    Retrieves information about the modules of the specified sensor.

  • forescout-ei-sensor-module-update

    Changes the specified properties of the specified module.

  • forescout-ei-ssl-client-blacklist-add

    Adds a new entry to the SSL client application blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-ssl-client-blacklist-get

    Retrieves the SSL client application blacklist from the Industrial Threat Library of the specified sensor.

  • forescout-ei-vulnerability-info-get

    Retrieves information about a specific vulnerability stored in the eyeInspect CC database.

category: Network Security
provider: Advent International
sectionorder:
- Connect
- Collect
commonfields:
  id: ForescoutEyeInspect
  version: -1
configuration:
- display: Server URL
  name: server_url
  required: true
  type: 0
  section: Connect
- display: Username
  name: credentials
  required: true
  type: 9
  section: Connect
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  section: Connect
  advanced: true
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  section: Connect
  advanced: true
  required: false
- additionalinfo: Default is 50. Maximum is 200.
  defaultvalue: 50
  display: Maximum incidents per fetch
  name: max_fetch
  type: 0
  section: Collect
  required: false
- defaultvalue: 7 days
  display: First fetch timestamp (<number> <time unit>, like 12 hours, 7 days).
  name: first_fetch
  type: 0
  section: Collect
  required: false
- display: Incident type
  name: incidentType
  type: 13
  section: Connect
  required: false
- display: Incidents Fetch Interval
  name: incidentFetchInterval
  defaultvalue: '1'
  required: false
  type: 19
  section: Collect
  advanced: true
- display: Fetch incidents
  name: isFetch
  type: 8
  section: Collect
  required: false
description: Delivers flexible and scalable OT/ICS asset visibility.
display: Forescout EyeInspect
name: ForescoutEyeInspect
script:
  commands:
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    - description: List only records with the last seen timestamp greater than or equal to the provided parameter.
      name: last_seen
    - description: Retrieve hosts that are equal to or greater than the specified ID.
      name: id_min
    - description: A comma-separated list of IP addresses. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: ip
    - description: A comma-separated list of VLAN IDs. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: vlan_id
    - description: A comma-separated list of MAC addresses. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: mac_address
    - description: A comma-separated list of sensor IDs. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: sensor_id
    - auto: PREDEFINED
      description: List records and sort them based on the specified field, as well as by ID. Also, the command will filter the results from the returned page.
      name: sort_field
      predefined:
      - ip_reuse_domain_id
      - ip_reuse_domain
      - address
      - ip
      - vlan
      - nested_address
      - mac_addresses
      - sorted_mac_addresses
      - real_mac_addresses
      - sorted_real_mac_addresses
      - observed_mac_addresses
      - sorted_observed_mac_addresses
      - mac_vendors
      - vendor_with_real_macs
      - vendor_with_observed_macs
      - sensor_ids
      - is_broadcast_ip
      - is_multicast_ip
      - is_public_ip
      - is_learnt_host
      - name
      - all_names
      - description
      - role
      - all_roles
      - vendor_model
      - all_vendors_models
      - os_version
      - client_proto_port_info
      - server_proto_port_info
      - first_seen
      - last_seen
      - labels
      - sorted_labels
      - purdue_level
      - criticality
      - firmware_version
      - hardware_version
      - serial_number
      - project
      - ip_type
      - monitored_networks
      - open_ports
      - complex_cves
      - sorted_client_protocols
      - sorted_server_protocols
      - module_count
      - sorted_module_details
      - security_risk
      - operational_risk
      - alert_count
    - auto: PREDEFINED
      defaultValue: false
      description: Indicates whether the result list should be sorted in ascending or descending order.
      name: sort_ascending
      predefined:
      - "true"
      - "false"
    description: Retrieves information about the hosts in the eyeInspect CC database.
    name: forescout-ei-host-list
    outputs:
    - contextPath: ForescoutEyeInspect.Host.id
      description: The unique ID of the host in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.Host.ip_reuse_domain_id
      description: The unique ID of the IP Reuse Domain the host is in.
      type: Number
    - contextPath: ForescoutEyeInspect.Host.ip
      description: The IP address of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.nested_address
      description: In case of a nested device host, the nested address of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.vlan
      description: The VLAN ID of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.mac_addresses
      description: The MAC addresses associated to the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.sensor_ids
      description: The unique IDs of the sensors that have "seen" this host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.main_name
      description: The main name of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.description
      description: Description of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.os_version
      description: The operating system version of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.open_ports
      description: The open TCP and UDP ports of the host.
      type: String
    - contextPath: ForescoutEyeInspect.Host.first_seen
      description: The ISO-formatted timestamp of when the host was first seen.
      type: String
    - contextPath: ForescoutEyeInspect.Host.last_seen
      description: The ISO-formatted timestamp of when the host was last seen.
      type: String
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    - description: List only records with the src_host_id property set to the specified value.
      name: src_host_id
    - description: List only records with the dst_host_id property set to the specified value.
      name: dst_host_id
    - description: List only records with the proto field containing the specified value.
      name: proto
    - description: List only records with one of the values of the port property equal to the specified parameter.
      name: port
    - description: List only records with the last_seen timestamp greater than or equal to the provided parameter.
      name: last_seen
    - description: Retrieve links that are equal to or greater than the specified ID.
      name: id_min
    - auto: PREDEFINED
      description: List records and sort them based on a specific field, as well as on ID.
      name: sort_field
      predefined:
      - src_host_id
      - dst_host_id
      - proto
      - ports
      - tx_bytes
      - rx_bytes
      - first_seen
      - last_seen
    - auto: PREDEFINED
      defaultValue: false
      description: Indicates whether the result list should be sorted in ascending or descending order.
      name: sort_ascending
      predefined:
      - "true"
      - "false"
    description: Retrieves information about the links in the eyeInspect CC database.
    name: forescout-ei-link-list
    outputs:
    - contextPath: ForescoutEyeInspect.Link.id
      description: The unique ID of the link in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.Link.src_host_id
      description: The unique ID of the source host in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.Link.dst_host_id
      description: The unique ID of the destination host in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.Link.proto
      description: The name of the protocol (application layer (L7) and transport or datalink layer (L4 or L3/L2) detected for the link.
      type: String
    - contextPath: ForescoutEyeInspect.Link.tx_bytes
      description: The total number of bytes sent upstream.
      type: Number
    - contextPath: ForescoutEyeInspect.Link.rx_bytes
      description: The total number of bytes sent downstream.
      type: Number
    - contextPath: ForescoutEyeInspect.Link.first_seen
      description: Timestamp in ISO format of when the link was first seen.
      type: String
    - contextPath: ForescoutEyeInspect.Link.last_seen
      description: Timestamp in ISO format of when the link was last seen.
      type: String
    - contextPath: ForescoutEyeInspect.Link.ports
      description: TCP or UDP ports used in the link.
      type: String
  - arguments:
    - description: The unique ID of the vulnerability information record to be retrieved. The CVE ID can be retrieved from public vulnerability databases, such as NVD, or from the "CVEs and IoCs" page inside Forescout EyeInspect.
      name: cve_id
      required: true
    description: Retrieves information about a specific vulnerability stored in the eyeInspect CC database.
    name: forescout-ei-vulnerability-info-get
    outputs:
    - contextPath: ForescoutEyeInspect.CVE.id
      description: The vulnerability ID.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cve_id
      description: The CVE ID from the NVD.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.icsa_id
      description: The ICS Cert Security Advisory ID related to the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.vendor_specific_id
      description: The vendor-specific advisory ID related to the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.published_date
      description: The timestamp in ISO format when the vulnerability information was published.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.last_modified_date
      description: The timestamp in ISO format when the vulnerability information was last modified.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_score
      description: The CVSS score of the vulnerability.
      type: Number
    - contextPath: ForescoutEyeInspect.CVE.cvss_temporal_score
      description: The CVSS temporal score of the vulnerability.
      type: Number
    - contextPath: ForescoutEyeInspect.CVE.cvss_access_vector
      description: The CVSS access vector scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_access_complexity
      description: The CVSS access complexity scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_authentication
      description: The CVSS authentication scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_confidentiality_impact
      description: The CVSS confidentiality impact scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_integrity_impact
      description: The CVSS integrity impact scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_availability_impact
      description: The CVSS availability impact scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_exploitability
      description: The CVSS exploitability scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_remediation_level
      description: The CVSS remediation level scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.cvss_reporting_confidence
      description: The CVSS reporting confidence scoring of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.references
      description: The list of references (URLs) related to the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.vendor
      description: The vendor of the product affected by the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.title
      description: A short summary of the vulnerability.
      type: String
    - contextPath: ForescoutEyeInspect.CVE.description
      description: Description of the vulnerability (including list of vulnerable devices and versions).
      type: String
    - contextPath: ForescoutEyeInspect.CVE.solution
      description: Description of the proposed vulnerability solution (including to what version to update the software/firmware).
      type: String
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    - description: List only records with the timestamp property greater than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00.
      name: start_timestamp
    - description: List only records with the timestamp property less than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00.
      name: end_timestamp
    - description: List records that have the event_type_id property containing the specified parameter.
      name: event_type_id
    - auto: PREDEFINED
      description: List records that have the l4_proto property equal to the specified parameter.
      name: l4_proto
      predefined:
      - TCP
      - UDP
      - ICMP
      - UNDEFINED
    - description: List records that have the l7_proto property equal to the specified parameter.
      name: l7_proto
    - description: List records that have the src_ip property equal to the specified parameter, or contained in the given CIDR-defined network.
      name: src_ip
    - description: List records that have the dst_ip property equal to the specified parameter, or contained in the given CIDR-defined network.
      name: dst_ip
    - description: List records that have either the src_ip or the dst_ip property equal to the specified parameter, or contained in the given CIDR-defined network.
      name: ip
    - description: A comma-separated list of severities. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: severity
    - description: A comma-separated list of VLAN IDs. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: vlan_id
    - auto: PREDEFINED
      description: A comma-separated list of statuses. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: status
      predefined:
      - Not analysed
      - In progress
      - Analyzed
      - False alert
      - Relevant
      - Not relevant
      - Unknown
      - Trimmed
    - description: A comma-separated list of sensor names. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: sensor_name
    - description: Fetch records that have the dst_port property equal to the specified parameter.
      name: dst_port
    - description: List records that have the src_ip or src_mac property equal to the IP address or MAC address of the host with the ID equal to the specified parameter.
      name: src_host_id
    - description: List records that have the dst_ip or dst_mac property equal to the IP address or MAC address of the host with the ID equal to the specified parameter.
      name: dst_host_id
    - description: List records that have either the src_ip, src_mac or dst_ip, dst_mac equal to the IP address or MAC address of the host with the ID equal to the specified parameter.
      name: host_id
    description: Retrieves information about the alerts inside eyeInspect CC.
    name: forescout-ei-alert-list
    outputs:
    - contextPath: ForescoutEyeInspect.Alert.alert_id
      description: The ID of the alert in the eyeInspect database.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.timestamp
      description: Timestamp of the alert in ISO format.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.event_type_ids
      description: The list of unique IDs identifying the type of events reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.event_type_names
      description: The list of names of the type of events reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.description
      description: A description of the event types reported in the alert, as well as other details regarding the specific alert instance coming from the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.notes
      description: Notes that a eyeInspect user may have attached to the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.sensor_id
      description: The unique ID of the sensor firing the alert.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.sensor_name
      description: The name of the sensor firing the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.engine
      description: The detection engine that raised the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.profile_module_name
      description: The name of the profile or module that raised the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.profile_id
      description: The unique ID of the profile that raised the alert.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.l2_proto
      description: The layer 2 (datalink) protocol.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.l3_proto
      description: The layer 3 (network) protocol.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.l4_proto
      description: The layer 4 (transport) protocol.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.l7_proto
      description: The layer 7 (application) protocol.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.vlan
      description: The VLAN ID used in the network communication reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.src_mac
      description: The MAC address of the host initiating the connection reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.dst_mac
      description: The MAC address of the host receiving the connection reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.src_ip
      description: The IP address of the host initiating the connection reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.dst_ip
      description: The IP address of the host receiving the connection reported in the alert.
      type: String
    - contextPath: ForescoutEyeInspect.Alert.src_port
      description: The source TCP or UDP port used in the connection reported in the alert.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.dst_port
      description: The destination TCP or UDP port used in the connection reported in the alert.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.severity
      description: The severity level of the alert.
      type: Number
    - contextPath: ForescoutEyeInspect.Alert.status
      description: The status of the alert.
      type: String
  - arguments:
    - description: The unique ID of the alert to get the PCAP of.
      name: alert_id
      required: true
    description: Retrieves the PCAP file associated to a given alert.
    name: forescout-ei-alert-pcap-get
    outputs:
    - contextPath: InfoFile.Size
      description: The size of the file.
      type: Number
    - contextPath: InfoFile.Name
      description: The name of the file.
      type: String
    - contextPath: InfoFile.EntryID
      description: The entry ID of the file.
      type: String
    - contextPath: InfoFile.Info
      description: File information.
      type: String
    - contextPath: InfoFile.Type
      description: The file type.
      type: String
    - contextPath: InfoFile.Extension
      description: The file extension.
      type: String
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    - auto: PREDEFINED
      defaultValue: false
      description: Whether to retrieve all the sensors (ICS Patrol and passive) or only the passive ones.
      name: all_sensors
      predefined:
      - "true"
      - "false"
    - description: A comma-separated list of sensor names. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: name
    - description: A comma-separated list of IP addresses or domain names. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: address
    - description: A comma-separated list of listening ports. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: port
    - auto: PREDEFINED
      description: A comma-separated list of sensor types. The command will filter the results according to the provided values.
      isArray: true
      name: type
      predefined:
      - PASSIVE
      - PATROL
    - auto: PREDEFINED
      description: A comma-separated list of sensor states. The command will filter the results from the returned page according to the provided values.
      isArray: true
      name: state
      predefined:
      - OPERATIVE_ON
      - OPERATIVE_OFF
      - DISCONNECTED
      - LICENSE_EXPIRED
      - LICENSE_INVALID
      - UNKNOWN
    description: Retrieves information about the sensors associated to the eyeInspect CC.
    name: forescout-ei-sensor-list
    outputs:
    - contextPath: ForescoutEyeInspect.Sensor.id
      description: Unique ID of the sensor in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.Sensor.name
      description: Name of the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.Sensor.address
      description: IP address or domain name of the sensor's management interface.
      type: String
    - contextPath: ForescoutEyeInspect.Sensor.port
      description: TCP port number on which the sensor is listening for incoming CC connections.
      type: Number
    - contextPath: ForescoutEyeInspect.Sensor.type
      description: Type of the sensor (PASSIVE / PATROL).
      type: String
    - contextPath: ForescoutEyeInspect.Sensor.sensor_version
      description: Version of the eyeInspect sensor software.
      type: String
    - contextPath: ForescoutEyeInspect.Sensor.state
      description: Current status of the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.Sensor.health_status
      description: Current health status of the sensor.
      type: String
  - arguments:
    - description: The unique ID of the sensor to query for modules.
      name: sensor_id
      required: true
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Retrieves information about the modules of the specified sensor.
    name: forescout-ei-sensor-module-list
    outputs:
    - contextPath: ForescoutEyeInspect.SensorModule.id
      description: Unique ID of the module in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.SensorModule.sensor_id
      description: Unique ID of the sensor the module is deployed in, in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.SensorModule.engine
      description: Name of the engine powering the module in the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.singleton
      description: Whether the module can only have one single instance or can have multiple instances in the sensor.
      type: Boolean
    - contextPath: ForescoutEyeInspect.SensorModule.name
      description: The name of the module.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.description
      description: The description of the module.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.started
      description: Whether the module is started or paused in the sensor.
      type: Boolean
    - contextPath: ForescoutEyeInspect.SensorModule.operational_mode
      description: Operational mode of the module in the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.date_last_update
      description: Timestamp in ISO format of when the module was last updated.
      type: String
  - arguments:
    - description: The unique ID of the sensor that has the module to update.
      name: sensor_id
      required: true
    - description: The unique ID of the module to update.
      name: module_id
      required: true
    - description: Name of the module.
      name: name
    - description: Description of the module.
      name: description
    - auto: PREDEFINED
      description: If set to true, the module will be started. If set to false, the module will be paused.
      name: started
      predefined:
      - "true"
      - "false"
    - auto: PREDEFINED
      description: Changes the operational mode of the module to the specified value.
      name: operational_mode
      predefined:
      - Learning
      - Detecting
    description: Changes the specified properties of the specified module.
    name: forescout-ei-sensor-module-update
    outputs:
    - contextPath: ForescoutEyeInspect.SensorModule.id
      description: Unique ID of the module in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.SensorModule.sensor_id
      description: Unique ID of the sensor the module is deployed in, in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.SensorModule.engine
      description: Name of the engine powering the module in the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.singleton
      description: Whether the module can only have one single instance or can have multiple instances in the sensor.
      type: Boolean
    - contextPath: ForescoutEyeInspect.SensorModule.name
      description: The name of the module.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.description
      description: The description of the module.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.started
      description: Whether the module is started or paused in the sensor.
      type: Boolean
    - contextPath: ForescoutEyeInspect.SensorModule.operational_mode
      description: Operational mode of the module in the sensor.
      type: String
    - contextPath: ForescoutEyeInspect.SensorModule.date_last_update
      description: Timestamp in ISO format of when the module was last updated.
      type: String
  - arguments:
    - description: The unique ID of the sensor of the module to delete.
      name: sensor_id
      required: true
    - description: The unique ID of the module to delete.
      name: module_id
      required: true
    description: Deletes the specified module from the specified sensor and from the eyeInspect CC database.
    name: forescout-ei-sensor-module-delete
    outputs: []
  - arguments:
    - description: The unique ID of the sensor for which to retrieve the IP blacklist.
      name: sensor_id
      required: true
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Retrieves the IP blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-ip-blacklist-get
    outputs:
    - contextPath: ForescoutEyeInspect.IPBlacklist.address
      description: A blacklisted IP address.
      type: String
    - contextPath: ForescoutEyeInspect.IPBlacklist.comment
      description: A comment provided by the user. The comment might be empty.
      type: String
  - arguments:
    - description: The unique ID of the sensor for which to update the IP blacklist.
      name: sensor_id
      required: true
    - description: The IP address to add to the blacklist.
      name: address
      required: true
    - description: A comment about the blacklisted IP address.
      name: comment
    description: Adds a new entry to the IP blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-ip-blacklist-add
    outputs: []
  - arguments:
    - description: The unique ID of the sensor that contains the domain blacklist.
      name: sensor_id
      required: true
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Retrieves the domain name blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-domain-blacklist-get
    outputs:
    - contextPath: ForescoutEyeInspect.DomainBlacklist.domain_name
      description: A blacklisted domain name.
      type: String
    - contextPath: ForescoutEyeInspect.DomainBlacklist.comment
      description: A comment provided by the user. The comment might be empty.
      type: String
  - arguments:
    - description: The unique ID of the sensor of the domain to be updated.
      name: sensor_id
      required: true
    - description: The domain name to add to the blacklist.
      name: domain_name
      required: true
    - defaultValue: Command and Control server
      description: A comment about the domain name.
      name: comment
    description: Adds a new entry to the domain name blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-domain-blacklist-add
    outputs: []
  - arguments:
    - description: The unique ID of the sensor for which to retrieve the SSL client blacklist.
      name: sensor_id
      required: true
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Retrieves the SSL client application blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-ssl-client-blacklist-get
    outputs:
    - contextPath: ForescoutEyeInspect.SSLClientBlacklist.sensor_id
      description: The unique ID of the sensor for which to retrieve the SSL client.
      type: Number
    - contextPath: ForescoutEyeInspect.SSLClientBlacklist.application_name
      description: The application name related to the entry.
      type: String
    - contextPath: ForescoutEyeInspect.SSLClientBlacklist.ja3_hash
      description: The JA3 hash of a blacklisted client application.
      type: String
    - contextPath: ForescoutEyeInspect.SSLClientBlacklist.comment
      description: A comment provided by the user. The comment might be empty.
      type: String
  - arguments:
    - description: The unique ID of the sensor of the SSL client.
      name: sensor_id
      required: true
    - description: The related application name to add to the blacklist.
      name: application_name
      required: true
    - description: The JA3 hash of a blacklisted client application.
      name: ja3_hash
      required: true
    - description: Comment about the SSL client application.
      name: comment
    description: Adds a new entry to the SSL client application blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-ssl-client-blacklist-add
    outputs: []
  - arguments:
    - description: The unique ID of the sensor for which to retrieve the file operation blacklist.
      name: sensor_id
      required: true
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Retrieves the file operation blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-file-operation-blacklist-get
    outputs:
    - contextPath: ForescoutEyeInspect.FileOperationBlacklist.matching_type
      description: The way the file or folder should be matched.
      type: String
    - contextPath: ForescoutEyeInspect.FileOperationBlacklist.file_or_folder
      description: The name of the file or folder the entry applies to.
      type: String
    - contextPath: ForescoutEyeInspect.FileOperationBlacklist.operation
      description: The name of the file operation.
      type: String
    - contextPath: ForescoutEyeInspect.FileOperationBlacklist.comment
      description: A comment provided by the user. The comment might be empty.
      type: String
  - arguments:
    - description: The unique ID of the sensor for which to update the file operation blacklist.
      name: sensor_id
      required: true
    - auto: PREDEFINED
      description: The way the file or folder should be matched.
      name: matching_type
      predefined:
      - CONTAINS
      - STARTS_WITH
      - ENDS_WITH
      - MATCHES
      - REGEX
      required: true
    - description: The name of the file or folder the entry applies to.
      name: file_or_folder
      required: true
    - auto: PREDEFINED
      description: The name of the file operation.
      name: operation
      predefined:
      - WRITE
      - READWRITE
      required: true
    - description: A comment provided by the user.
      name: comment
    description: Adds entries to the file operation blacklist from the Industrial Threat Library of the specified sensor.
    name: forescout-ei-file-operation-blacklist-add
    outputs: []
  - arguments: []
    description: Retrieves information about all monitored Command Center resources and their health status excluding the logs.
    name: forescout-ei-diagnostics-information-get
    outputs:
    - contextPath: ForescoutEyeInspect.CCInfo.ip_address
      description: IP address of the Command Center.
      type: String
    - contextPath: ForescoutEyeInspect.CCInfo.hostname
      description: Hostname of the Command Center.
      type: String
    - contextPath: ForescoutEyeInspect.CCInfo.open_ports
      description: TCP open port number of the Command Center.
      type: String
    - contextPath: ForescoutEyeInspect.CCInfo.cc_version
      description: Version of the Command Center software.
      type: String
    - contextPath: ForescoutEyeInspect.CCInfo.health_status
      description: Current health status of the Command Center.
      type: String
  - arguments:
    - auto: PREDEFINED
      defaultValue: true
      description: Whether to include Command Center diagnostic logs inside the downloaded zip, in addition to sensors logs. If this value is false, the downloaded zip won't contain the general server logs, but only the logs about the sensors.
      name: cc_info
      predefined:
      - "true"
      - "false"
    - description: Include logs from a specific sensor by its ID, or all sensors (by specifying All).
      name: sensor_id
    description: Download the ZIP file that contains diagnostic logs of the Command Center.
    name: forescout-ei-diagnostic-logs-get
    outputs:
    - contextPath: InfoFile.Size
      description: The size of the file.
      type: Number
    - contextPath: InfoFile.Name
      description: The name of the file.
      type: String
    - contextPath: InfoFile.EntryID
      description: The entry ID of the file.
      type: String
    - contextPath: InfoFile.Info
      description: File information.
      type: String
    - contextPath: InfoFile.Type
      description: The file type.
      type: String
    - contextPath: InfoFile.Extension
      description: The file extension.
      type: String
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Get all group policies.
    name: forescout-ei-group-policy-list
    outputs:
    - contextPath: ForescoutEyeInspect.GroupPolicy.id
      description: The ID of the policy.
      type: Number
    - contextPath: ForescoutEyeInspect.GroupPolicy.name
      description: The name of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.description
      description: The description of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.constraints
      description: List of constraints of the policy.
      type: Unknown
  - arguments:
    - description: The name of the group policy.
      name: name
      required: true
    - description: The description of the group policy.
      name: description
      required: true
    - description: "List of constraints of the policy.\n\nEach policy constraint is an object that includes the following fields:\n* type: The type of the constraint. Possible values are os_version, firmware_version, open_ports.\n* operator: The operator of the constraint. Possible values are equals (all types), allowed (open_ports) and contains (os_version, firmware_version).\n* os_version: The value of the OS version for the os_version type.\n* firmware_version: The value of the firmware version for the firmware_version type.\n* open_ports_tcp: Comma-separated list of ports or range of ports for the open_ports type. Example: \"10, 20-30\".\n* open_ports_udp: Comma-separated list of ports or range of ports for the open_ports type. Example: \"10, 20-30\".\n\nExample for list of policy constraints: [{ \"type\": \"os_version\", \"operator\": \"contains\", \"os_version\": \"Windows\" }]."
      isArray: true
      name: constraints
      required: true
    description: Create a new group policy.
    name: forescout-ei-group-policy-create
    outputs:
    - contextPath: ForescoutEyeInspect.GroupPolicy.id
      description: The ID of the policy.
      type: Number
    - contextPath: ForescoutEyeInspect.GroupPolicy.name
      description: The name of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.description
      description: The description of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.constraints
      description: List of constraints of the policy.
      type: Unknown
  - arguments:
    - description: The unique ID of the policy to be updated.
      name: policy_id
      required: true
    - description: The name of the group policy.
      name: name
      required: true
    - description: The description of the group policy.
      name: description
      required: true
    - description: "List of constraints of the policy.\n\nEach policy constraint is an object that includes the following fields:\n* type: The type of the constraint. Possible values are os_version, firmware_version, open_ports.\n* operator: The operator of the constraint. Possible values are equals (all types), allowed (open_ports) and contains (os_version, firmware_version).\n* os_version: The value of the OS version for the os_version type.\n* firmware_version: The value of the firmware version for the firmware_version type.\n* open_ports_tcp: Comma-separated list of ports or range of ports for the open_ports type. Example: \"10, 20-30\".\n* open_ports_udp: Comma-separated list of ports or range of ports for the open_ports type. Example: \"10, 20-30\".\n\nExample for list of policy constraints: [{ \"type\": \"os_version\", \"operator\": \"contains\", \"os_version\": \"Windows\" }]."
      isArray: true
      name: constraints
      required: true
    description: "Update a group policy. Note: Since the entire policy will be overridden, all fields are required."
    name: forescout-ei-group-policy-update
    outputs:
    - contextPath: ForescoutEyeInspect.GroupPolicy.id
      description: The ID of the policy.
      type: Number
    - contextPath: ForescoutEyeInspect.GroupPolicy.name
      description: The name of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.description
      description: The description of the group policy.
      type: String
    - contextPath: ForescoutEyeInspect.GroupPolicy.constraints
      description: List of constraints of the policy.
      type: Unknown
  - arguments:
    - description: The unique ID of the policy for which the hosts will be added to.
      name: policy_id
      required: true
    description: Delete a group policy.
    name: forescout-ei-group-policy-delete
    outputs: []
  - arguments:
    - description: The unique ID of the policy for which the hosts will be added to.
      name: policy_id
      required: true
    - auto: PREDEFINED
      description: The type of the filter.
      name: filter_type
      predefined:
      - address
      - host_mac_address_exact
      - vendor_model
      - os_version
      - firmware_version
      - ip_reuse_domain
      required: true
    - description: The value of the filter.
      name: filter_value
      required: true
    description: Add all hosts not assigned to any policy (individual or group) matching the filter to the group policy.
    name: forescout-ei-group-policy-hosts-assign
    outputs: []
  - arguments:
    - description: The unique ID of the policy for which the hosts will be removed.
      name: policy_id
      required: true
    - auto: PREDEFINED
      description: The type of the filter.
      name: filter_type
      predefined:
      - address
      - host_mac_address_exact
      - vendor_model
      - os_version
      - firmware_version
      - ip_reuse_domain
      required: true
    - description: The value of the filter.
      name: filter_value
      required: true
    description: Unassign all hosts assigned to the group policy matching the filter.
    name: forescout-ei-group-policy-hosts-unassign
    outputs: []
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    description: Get all IP reuse domains.
    name: forescout-ei-ip-reuse-domain-list
    outputs:
    - contextPath: ForescoutEyeInspect.IPReuseDomain.id
      description: The ID of the IP reuse domain.
      type: Number
    - contextPath: ForescoutEyeInspect.IPReuseDomain.name
      description: The name of the IP reuse domain.
      type: String
    - contextPath: ForescoutEyeInspect.IPReuseDomain.description
      description: The description of the IP reuse domain.
      type: String
    - contextPath: ForescoutEyeInspect.IPReuseDomain.address
      description: The address of the IP reuse domain.
      type: String
    - contextPath: ForescoutEyeInspect.IPReuseDomain.mask
      description: The number of bits in the mask.
      type: Number
    - contextPath: ForescoutEyeInspect.IPReuseDomain.vlan_ids
      description: VLAN IDs of the IP reuse domain.
      type: String
  - arguments:
    - defaultValue: 1
      description: The page number of the results to retrieve (minimum is 1).
      name: page
    - defaultValue: 50
      description: Maximum number of records to retrieve.
      name: limit
    - description: List only records with the host_id property equal to the provided parameter.
      name: host_id
    - description: List only records with the timestamp property greater than or equal to the specified value. For example, 2020-05-26T15:00:00.000Z+01:00.
      name: start_timestamp
    - description: List only records with the timestamp property less than or equal to the specified value. 2020-05-26T15:00:00.000Z+01:00.
      name: end_timestamp
    - description: List only records with the event_type_id property equal to the specified value.
      name: event_type_id
      auto: PREDEFINED
      predefined:
      - hostcl_new_host
      - hostcl_new_mac
      - hostcl_new_name
      - hostcl_new_role
      - hostcl_new_vendor_model
      - hostcl_new_os_version
      - hostcl_changed_os_version
      - hostcl_new_client_proto
      - hostcl_new_client_port
      - hostcl_new_server_proto
      - hostcl_new_server_port
      - hostcl_new_label
      - hostcl_new_fw_version
      - hostcl_changed_fw_version
      - hostcl_new_hw_version
      - hostcl_changed_hw_version
      - hostcl_changed_serial
      - hostcl_new_project
      - hostcl_changed_project
      - hostcl_new_module
      - hostcl_changed_module_name
      - hostcl_changed_module_type
      - hostcl_changed_module_vendor
    - description: List only records with the event_type_id property equal to the specified value.
      name: event_category
      auto: PREDEFINED
      predefined:
      - PROPERTIES
      - CONFIGURATION
      - ALL
    description: Retrieves information about the changes of host properties and configuration from the eyeInspect CC database.
    name: forescout-ei-hosts-changelog-list
    outputs:
    - contextPath: ForescoutEyeInspect.HostChangeLog.id
      description: The unique ID of the HostChangeLog in the eyeInspect CC.
      type: Number
    - contextPath: ForescoutEyeInspect.HostChangeLog.timestamp
      description: Timestamp in ISO format of when the host change was detected.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.event_type_id
      description: An identifier of the type of change detected.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.event_type_name
      description: A human readable representation of the type of change detected.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.event_category
      description: A more general type of the change detected.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_id
      description: The unique ID of the host in the eyeInspect CC database in which the change was detected.
      type: Number
    - contextPath: ForescoutEyeInspect.HostChangeLog.information_source
      description: The source of information for the detected change.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.sensor_id
      description: In case the detected change was reported from a sensor, the unique ID in the eyeInspect CC database of the sensor reporting the information.
      type: Number
    - contextPath: ForescoutEyeInspect.HostChangeLog.username
      description: In case the detected change was reported from a eyeInspect user, the username of the user reporting the information.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.old_value
      description: The old value of the host property.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.new_value
      description: The new value of the host property.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_address
      description: The IP address, or nested address (in case of a nested device) of the host.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_vlan
      description: The VLAN ID of the host (only present if the process_vlan_tags option is enabled in the sensor).
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_name
      description: The main name of the host.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_ip_reuse_domain_id
      description: The unique ID of the IP Reuse Domain the host is in.
      type: String
    - contextPath: ForescoutEyeInspect.HostChangeLog.host_mac_addresses
      description: The MAC addresses associated to the host.
      type: String
  dockerimage: demisto/python3:3.12.13.10116658
  isfetch: true
  runonce: false
  script: "-"
  subtype: python3
  type: python
fromversion: 6.0.1
tests:
- No tests (auto formatted)