{
    "id": "Forescout",
    "title": "Forescout",
    "publisher": "Forescout",
    "descriptionMarkdown": "The [Forescout](https://www.forescout.com/) data connector provides the capability to ingest [Forescout events](https://docs.forescout.com/bundle/syslog-3-6-1-h/page/syslog-3-6-1-h.How-to-Work-with-the-Syslog-Plugin.html) into Microsoft Sentinel. Refer to [Forescout documentation](https://docs.forescout.com/bundle/syslog-msg-3-6-tn/page/syslog-msg-3-6-tn.About-Syslog-Messages-in-Forescout.html) for more information.",
    "additionalRequirementBanner": "This data connector depends on a parser based on a Kusto Function to work as expected [**ForescoutEvent**](https://aka.ms/sentinel-forescout-parser) which is deployed with the Microsoft Sentinel Solution.",
    "graphQueries": [{
        "metricName": "Total data received",
        "legend": "Forescout",
        "baseQuery": "ForescoutEvent"
    }],
    "sampleQueries": [{
        "description": "Top 10 Sources",
        "query": "ForescoutEvent\n | summarize count() by tostring(SrcIpAddr)\n | top 10 by count_"
    }],
    "dataTypes": [{
        "name": "Syslog(ForescoutEvent)",
        "lastDataReceivedQuery": "ForescoutEvent\n            | summarize Time = max(TimeGenerated)\n            | where isnotempty(Time)"
    }],
    "connectivityCriterias": [{
        "type": "IsConnectedQuery",
        "value": [
            "ForescoutEvent\n            | summarize LastLogReceived = max(TimeGenerated)\n            | project IsConnected = LastLogReceived > ago(30d)"
        ]
    }],
    "availability": {
        "status": 1,
        "isPreview": false
    },
    "permissions": {
        "resourceProvider": [{
                "provider": "Microsoft.OperationalInsights/workspaces",
                "permissionsDisplayText": "read and write permissions are required.",
                "providerDisplayName": "Workspace",
                "scope": "Workspace",
                "requiredPermissions": {
                    "write": true,
                    "delete": true
                }
            }
        ]
    },
    "instructionSteps": [{
            "title": "",
            "description": ">**NOTE:** This data connector depends on a parser based on a Kusto Function to work as expected [**ForescoutEvent**](https://aka.ms/sentinel-forescout-parser) which is deployed with the Microsoft Sentinel Solution.",
            "instructions": []
        },
        {
            "title": "",
            "description": ">**NOTE:** This data connector has been developed using Forescout Syslog Plugin version: v3.6",
            "instructions": []
        },
        {
            "title": "1. Install and onboard the agent for Linux or Windows",
            "description": "Install the agent on the Server where the Forescout logs are forwarded.\n\n> Logs from Forescout Server deployed on Linux or Windows servers are collected by **Linux** or **Windows** agents.",
            "instructions": [{
                "parameters": {
                    "title": "Choose where to install the Linux agent:",
                    "instructionSteps": [{
                            "title": "Install agent on Azure Linux Virtual Machine",
                            "description": "Select the machine to install the agent on and then click **Connect**.",
                            "instructions": [{
                                "parameters": {
                                    "linkType": "InstallAgentOnLinuxVirtualMachine"
                                },
                                "type": "InstallAgent"
                            }]
                        },
                        {
                            "title": "Install agent on a non-Azure Linux Machine",
                            "description": "Download the agent on the relevant machine and follow the instructions.",
                            "instructions": [{
                                "parameters": {
                                    "linkType": "InstallAgentOnLinuxNonAzure"
                                },
                                "type": "InstallAgent"
                            }]
                        }
                    ]
                },
                "type": "InstructionStepsGroup"
            }]
        },
        {
            "instructions": [{
                "parameters": {
                    "title": "Choose where to install the Windows agent:",
                    "instructionSteps": [{
                            "title": "Install agent on Azure Windows Virtual Machine",
                            "description": "Select the machine to install the agent on and then click **Connect**.",
                            "instructions": [{
                                "parameters": {
                                    "linkType": "InstallAgentOnVirtualMachine"
                                },
                                "type": "InstallAgent"
                            }]
                        },
                        {
                            "title": "Install agent on a non-Azure Windows Machine",
                            "description": "Download the agent on the relevant machine and follow the instructions.",
                            "instructions": [{
                                "parameters": {
                                    "linkType": "InstallAgentOnNonAzure"
                                },
                                "type": "InstallAgent"
                            }]
                        }
                    ]
                },
                "type": "InstructionStepsGroup"
            }]
        },
		 { 
             "title": "2. Configure the logs to be collected", 
             "description": "Configure the facilities you want to collect and their severities.\n 1. Under workspace advanced settings **Configuration**, select **Data** and then **Syslog**.\n 2. Select **Apply below configuration to my machines** and select the facilities and severities.\n 3.  Click **Save**.",
             "instructions": [
                 {
                     "parameters": { 
                          "linkType": "OpenSyslogSettings"
					},
                    "type": "InstallAgent"
                 }
                    ]
                },
        {
            "title": "3. Configure Forescout event forwarding",
            "description": "Follow the configuration steps below to get Forescout logs into Microsoft Sentinel.\n1. [Select an Appliance to Configure.](https://docs.forescout.com/bundle/syslog-3-6-1-h/page/syslog-3-6-1-h.Select-an-Appliance-to-Configure.html)\n2. [Follow these instructions](https://docs.forescout.com/bundle/syslog-3-6-1-h/page/syslog-3-6-1-h.Send-Events-To-Tab.html#pID0E0CE0HA) to forward alerts from the Forescout platform to a syslog server.\n3. [Configure](https://docs.forescout.com/bundle/syslog-3-6-1-h/page/syslog-3-6-1-h.Syslog-Triggers.html) the settings in the Syslog Triggers tab."
        }
    ]
}