|
id: 3255ec41-6bd6-4f35-84b1-c032b18bbfcb |
|
name: Fortinet - Beacon pattern detected |
|
description: | |
|
'Identifies patterns in the time deltas of contacts between internal and external IPs in Fortinet network data that are consistent with beaconing. |
|
Accounts for randomness (jitter) and seasonality such as working hours that may have been introduced into the beacon pattern. |
|
The lookback is set to 1d, the minimum granularity in time deltas is set to 60 seconds and the minimum number of beacons required to emit a |
|
detection is set to 4. |
|
Increase the lookback period to capture beacons with larger periodicities. |
|
The jitter tolerance is set to 0.2 - This means we account for an overall 20% deviation from the infered beacon periodicity. Seasonality is dealt with |
|
automatically using series_outliers. |
|
Note: In large environments it may be necessary to reduce the lookback period to get fast query times.' |
|
severity: Low |
|
requiredDataConnectors: |
|
- connectorId: Fortinet |
|
dataTypes: |
|
- CommonSecurityLog |
|
queryFrequency: 1d |
|
queryPeriod: 1d |
|
triggerOperator: gt |
|
triggerThreshold: 0 |
|
tactics: |
|
- CommandAndControl |
|
relevantTechniques: |
|
- T1043 |
|
- T1065 |
|
query: | |
|
|
|
let starttime = 1d; |
|
let TimeDeltaThresholdInSeconds = 60; // we ignore beacons diffs that fall below this threshold |
|
let TotalBeaconsThreshold = 4; // minimum number of beacons required in a session to surface a row |
|
let JitterTolerance = 0.2; // tolerance to jitter, e.g. - 0.2 = 20% jitter is tolerated either side of the periodicity |
|
let PrivateIPregex = @"^127\.|^10\.|^172\.1[6-9]\.|^172\.2[0-9]\.|^172\.3[0-1]\.|^192\.168\."; // exclude destinations that fall into this category |
|
CommonSecurityLog |
|
| where DeviceVendor == "Fortinet" |
|
| where TimeGenerated > ago(starttime) |
|
// eliminate bad data |
|
| where isnotempty(SourceIP) and isnotempty(DestinationIP) and SourceIP != "0.0.0.0" |
|
// filter out deny, close, rst and SNMP to reduce data volume |
|
| where DeviceAction !in ("close", "client-rst", "server-rst", "deny") and DestinationPort != 161 |
|
// map input fields |
|
| project TimeGenerated , SourceIP, DestinationIP, DestinationPort, ReceivedBytes, SentBytes, DeviceAction |
|
// where destination IPs are public |
|
| extend DestinationIPType = iff(DestinationIP matches regex PrivateIPregex,"private" ,"public" ) |
|
| where DestinationIPType == "public" |
|
// sort into source->destination 'sessions' |
|
| sort by SourceIP asc, DestinationIP asc, DestinationPort asc, TimeGenerated asc |
|
| serialize |
|
// time diff the contact times between source and destination to get a list of deltas |
|
| extend nextTimeGenerated = next(TimeGenerated, 1), nextSourceIP = next(SourceIP, 1), nextDestIP = next(DestinationIP, 1), nextDestPort = next(DestinationPort, 1) |
|
| extend TimeDeltainSeconds = datetime_diff("second",nextTimeGenerated,TimeGenerated) |
|
| where SourceIP == nextSourceIP and DestinationIP == nextDestIP and DestinationPort == nextDestPort |
|
// remove small time deltas below the set threshold |
|
| where TimeDeltainSeconds > TimeDeltaThresholdInSeconds |
|
| project TimeGenerated, TimeDeltainSeconds, SourceIP, DestinationIP, DestinationPort, ReceivedBytes, SentBytes, DeviceAction |
|
// summarize the deltas by source->destination |
|
| summarize count(), StartTime=min(TimeGenerated), EndTime=max(TimeGenerated), sum(ReceivedBytes), sum(SentBytes), makelist(TimeDeltainSeconds), makeset(DeviceAction) by SourceIP, DestinationIP, DestinationPort |
|
// get some statistical properties of the delta distribution and smooth any outliers (e.g. laptop shut overnight, working hours) |
|
| extend series_stats(list_TimeDeltainSeconds), outliers=series_outliers(list_TimeDeltainSeconds) |
|
// expand the deltas and the outliers |
|
| mvexpand list_TimeDeltainSeconds to typeof(double), outliers to typeof(double) |
|
// replace outliers with the average of the distribution |
|
| extend list_TimeDeltainSeconds_normalized=iff(outliers > 1.5 or outliers < -1.5, series_stats_list_TimeDeltainSeconds_avg , list_TimeDeltainSeconds) |
|
// summarize with the smoothed distribution |
|
| summarize BeaconCount=count(), makelist(list_TimeDeltainSeconds), list_TimeDeltainSeconds_normalized=makelist(list_TimeDeltainSeconds_normalized), makeset(set_DeviceAction) by StartTime, EndTime, SourceIP, DestinationIP, DestinationPort, sum_ReceivedBytes, sum_SentBytes |
|
// get stats on the smoothed distribution |
|
| extend series_stats(list_TimeDeltainSeconds_normalized) |
|
// match jitter tolerance on smoothed distrib |
|
| extend MaxJitter = (series_stats_list_TimeDeltainSeconds_normalized_avg*JitterTolerance) |
|
| where series_stats_list_TimeDeltainSeconds_normalized_stdev < MaxJitter |
|
// where the minimum beacon threshold is satisfied and there was some data transfer |
|
| where BeaconCount > TotalBeaconsThreshold and (sum_SentBytes > 0 or sum_ReceivedBytes > 0) |
|
// final projection |
|
| project StartTime, EndTime, SourceIP, DestinationIP, DestinationPort, BeaconCount, TimeDeltasInSeconds=list_list_TimeDeltainSeconds, Periodicity=series_stats_list_TimeDeltainSeconds_normalized_avg, ReceivedBytes=sum_ReceivedBytes, SentBytes=sum_SentBytes, Actions=set_set_DeviceAction |
|
// where periodicity is order of magnitude larger than time delta threshold (eliminates FPs whose periodicity is close to the values we ignored) |
|
| where Periodicity >= (10*TimeDeltaThresholdInSeconds) |
|
| extend timestamp = StartTime, IPCustomEntity = DestinationIP |
|
entityMappings: |
|
- entityType: IP |
|
fieldMappings: |
|
- identifier: Address |
|
columnName: IPCustomEntity |