Scan events report the start, completion, and results of a scan job. The scan event includes the number of items that were scanned and the number of detections that were resolved.
- Category: Application Activity
- Extends:
base_event - UID:
6007
Attributes
Section titled “Attributes”Classification
Section titled “Classification”activity_id
- Type:
integer_t - Requirement: required
- Values:
0-Unknown: The event activity is unknown.1-Started: The scan was started.2-Completed: The scan was completed.3-Cancelled: The scan was cancelled.4-Duration Violation: The allocated scan time was insufficient to complete the requested scan.5-Pause Violation: The scan was paused, either by the user or by program constraints (e.g. scans that are suspended during certain time intervals), and not resumed within the allotted time.6-Error: The scan could not be completed due to an internal error.7-Paused: The scan was paused.8-Resumed: The scan was resumed from the pause point.9-Restarted: The scan restarted from the beginning of the file enumeration.10-Delayed: The user delayed the scan.99-Other: The event activity is not mapped. See theactivity_nameattribute, which contains a data source specific value.
The normalized identifier of the activity that triggered the event.
category_uid
- Type:
integer_t - Requirement: required
- Values:
6-Application Activity: Application Activity events report detailed information about the behavior of applications and services.
The category unique identifier of the event.
class_uid
- Type:
integer_t - Requirement: required
- Values:
6007-Scan Activity: Scan events report the start, completion, and results of a scan job. The scan event includes the number of items that were scanned and the number of detections that were resolved.
The unique identifier of a class. A class describes the attributes available in an event.
severity_id
- Type:
integer_t - Requirement: required
- Values:
0-Unknown: The event/finding severity is unknown.1-Informational: Informational message. No action required.2-Low: The user decides if action is needed.3-Medium: Action is required but the situation is not serious at this time.4-High: Action is required immediately.5-Critical: Action is required immediately and the scope is broad.6-Fatal: An error occurred but it is too late to take remedial action.99-Other: The event/finding severity is not mapped. See theseverityattribute, which contains a data source specific value.
The normalized identifier of the event/finding severity.The normalized severity is a measurement the effort and expense required to manage and resolve an event or incident. Smaller numerical values represent lower impact events, and larger numerical values represent higher impact events.
type_uid
- Type:
long_t - Requirement: required
- Values:
600700-Scan Activity: Unknown600701-Scan Activity: Started: The scan was started.600702-Scan Activity: Completed: The scan was completed.600703-Scan Activity: Cancelled: The scan was cancelled.600704-Scan Activity: Duration Violation: The allocated scan time was insufficient to complete the requested scan.600705-Scan Activity: Pause Violation: The scan was paused, either by the user or by program constraints (e.g. scans that are suspended during certain time intervals), and not resumed within the allotted time.600706-Scan Activity: Error: The scan could not be completed due to an internal error.600707-Scan Activity: Paused: The scan was paused.600708-Scan Activity: Resumed: The scan was resumed from the pause point.600709-Scan Activity: Restarted: The scan restarted from the beginning of the file enumeration.600710-Scan Activity: Delayed: The user delayed the scan.600799-Scan Activity: Other
The event/finding type ID. It identifies the event’s semantics and structure. The value is calculated by the logging system as: class_uid * 100 + activity_id.
activity_name
- Type:
string_t - Requirement: optional
The event activity name, as defined by the activity_id.
category_name
- Type:
string_t - Requirement: optional
The event category name, as defined by category_uid value: Application Activity.
class_name
- Type:
string_t - Requirement: optional
The event class name, as defined by class_uid value: Scan Activity.
severity
- Type:
string_t - Requirement: optional
The event/finding severity, normalized to the caption of the severity_id value. In the case of ‘Other’, it is defined by the source.
type_name
- Type:
string_t - Requirement: optional
The event/finding type name, as defined by the type_uid.
Context
Section titled “Context”metadata
- Type:
metadata - Requirement: required
The metadata associated with the event or a finding.
api cloud
- Type:
api - Requirement: optional
Describes details about a typical API (Application Programming Interface) call.
enrichments
- Type:
enrichment - Requirement: optional
The additional information from an external data source, which is associated with the event or a finding. For example add location information for the IP address in the DNS answers:[{"name": "answers.ip", "value": "92.24.47.250", "type": "location", "data": {"city": "Socotra", "continent": "Asia", "coordinates": [-25.4153, 17.0743], "country": "YE", "desc": "Yemen"}}]
raw_data
- Type:
string_t - Requirement: optional
The raw event/finding data as received from the source.
unmapped
- Type:
object - Requirement: optional
The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
Occurrence
Section titled “Occurrence”time
- Type:
timestamp_t - Requirement: required
The normalized event occurrence time or the finding creation time.
duration
- Type:
long_t - Requirement: recommended
The duration of the scan
end_time
- Type:
timestamp_t - Requirement: recommended
The end time of the scan job.
start_time
- Type:
timestamp_t - Requirement: recommended
The start time of the scan job.
timezone_offset
- Type:
integer_t - Requirement: recommended
The number of minutes that the reported event time is ahead or behind UTC, in the range -1,080 to +1,080.
count
- Type:
integer_t - Requirement: optional
The number of times that events in the same logical group occurred during the event Start Time to End Time period.
end_time_dt datetime
- Type:
datetime_t - Requirement: optional
The end time of the scan job.
start_time_dt datetime
- Type:
datetime_t - Requirement: optional
The start time of the scan job.
time_dt datetime
- Type:
datetime_t - Requirement: optional
The normalized event occurrence time or the finding creation time.
Primary
Section titled “Primary”cloud cloud
- Type:
cloud - Requirement: required
Describes details about the Cloud environment where the event was originally created or logged.
osint osint
- Type:
osint - Requirement: required
The OSINT (Open Source Intelligence) object contains details related to an indicator such as the indicator itself, related indicators, geolocation, registrar information, subdomains, analyst commentary, and other contextual information. This information can be used to further enrich a detection or finding by providing decisioning support to other analysts and engineers.
scan
- Type:
scan - Requirement: required
The Scan object describes characteristics of the scan job.
command_uid
- Type:
string_t - Requirement: recommended
The command identifier that is associated with this scan event. This ID uniquely identifies the proactive scan command, e.g., if remotely initiated.
device host
- Type:
device - Requirement: recommended
An addressable device, computer system or host.
message
- Type:
string_t - Requirement: recommended
The description of the event/finding, as defined by the source.
num_detections
- Type:
integer_t - Requirement: recommended
The number of detections.
num_files
- Type:
integer_t - Requirement: recommended
The number of files scanned.
num_folders
- Type:
integer_t - Requirement: recommended
The number of folders scanned.
num_network_items
- Type:
integer_t - Requirement: recommended
The number of network items scanned.
num_processes
- Type:
integer_t - Requirement: recommended
The number of processes scanned.
num_registry_items
- Type:
integer_t - Requirement: recommended
The number of registry items scanned.
num_resolutions
- Type:
integer_t - Requirement: recommended
The number of items that were resolved.
num_skipped_items
- Type:
integer_t - Requirement: recommended
The number of skipped items.
num_trusted_items
- Type:
integer_t - Requirement: recommended
The number of trusted items.
observables
- Type:
observable - Requirement: recommended
The observables associated with the event or a finding.
policy
- Type:
policy - Requirement: recommended
The policy associated with this Scan event; required if the scan was initiated by a policy.
schedule_uid
- Type:
string_t - Requirement: recommended
The unique identifier of the schedule associated with a scan job.
status
- Type:
string_t - Requirement: recommended
The event status, normalized to the caption of the status_id value. In the case of ‘Other’, it is defined by the event source.
status_code
- Type:
string_t - Requirement: recommended
The event status code, as reported by the event source.
For example, in a Windows Failed Authentication event, this would be the value of ‘Failure Code’, e.g. 0x18.
status_detail
- Type:
string_t - Requirement: recommended
The status detail contains additional information about the event/finding outcome.
status_id
- Type:
integer_t - Requirement: recommended
- Values:
0-Unknown: The status is unknown.1-Success2-Failure99-Other: The event status is not mapped. See thestatusattribute, which contains a data source specific value.
The normalized identifier of the event status.
total
- Type:
integer_t - Requirement: recommended
The total number of items that were scanned; zero if no items were scanned.
actor host
- Type:
actor - Requirement: optional
The actor object describes details about the user/role/process that was the source of the activity.