Skip to content

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

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 the activity_name attribute, 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 the severity attribute, 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: Unknown
    • 600701 - 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.

metadata

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

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.

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.

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

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 - Success
    • 2 - Failure
    • 99 - Other: The event status is not mapped. See the status attribute, 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.