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:
integer_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.
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.
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_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.
observables
- Type:
observable - Requirement: optional
The observables associated with the event or a finding.
status
- Type:
string_t - Requirement: optional
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: optional
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: optional
The status details contains additional information about the event/finding outcome.