Skip to content

Latest commit

 

History

History
3459 lines (2208 loc) · 109 KB

sighting.md

File metadata and controls

3459 lines (2208 loc) · 109 KB

Sighting Object

Sighting A sighting indicates that a particular entity or indicator was observed in an environment and can be an indication of a current or potential threat.

Property Type Description Required?
confidence HighMedLowString
count Integer The number of times an indicator was observed within a certain period of time. For example, if an IP address associated with known malicious activity is observed once within a period of time, it may indicate a low-level threat. However, if the same IP address is observed multiple times within a short time frame, it may indicate a more severe and persistent threat. It can also be used to prioritize security alerts and indicate the urgency of a response. High counts indicate that an indicator is actively being used in a larger campaign, while low counts may indicate isolated incidents.
id String Globally unique URI identifying this object.
observed_time ObservedTime Object
schema_version String CTIM schema version for this entity.
type SightingTypeIdentifierString
context Context Object Context including the event type that best fits the type of the sighting.
data SightingDataTable Object An embedded data table for the Sighting.
description MarkdownString A description of object, which may be detailed.
external_ids String List It is used to store a list of external identifiers that can be linked to the incident, providing a reliable and manageable way to correlate and group related events across multiple data sources. It is especially useful in larger organizations that rely on multiple security information and event management (SIEM) systems to detect security incidents. For instance, it can be used to track events across different network sensors, intrusion detection and prevention systems (IDPS), or log management platforms. The field can also be used to facilitate automation and orchestration workflows, where additional information can be shared among incident management systems. It can be used to cross-reference with other external tools such as threat intelligence feeds and vulnerability scanners.
external_references ExternalReference Object List Specifies a list of external references which refers to non-CTIM information. Similar to external_ids field with major differences: - external_ids field is used to store a list of external identifiers that can be used to link entities across different data sources. These identifiers are typically standardized and well-known, such as CVE IDs, US-CERT advisories, or other industry-standard threat intelligence feeds. The external_ids field can be used to facilitate automation and orchestration workflows, where additional information can be shared among incident management systems. - external_references field, on the other hand, is used to provide a more general mechanism for linking entities to external sources of information. The external_references field can include references to blog posts, articles, external documents, threat intelligence reports, and other sources of information that may not have a standardized format or identifier.
internal Boolean If true, indicates that the sighting was reported from internal sources, such as an organization's own internal security tools or SOC. Internal sightings are often considered more reliable and actionable than external sightings, which are reported from external sources and may have a lower level of trustworthiness. Internal sightings can provide more context and can help identify potential threats that are unique to a particular environment or organization. Internal sightings can also help organizations prioritize their security response efforts by identifying threats that are specific to their environment and may not yet be widely known.
language ShortStringString The language field is used to specify the primary language of the affected system or the target of an attack. It can be used to provide additional context and information about the entity. The primary purpose of this field is to help analysts filter and prioritize entities based on their knowledge and expertise of different languages. For example, if an incident involves an attack on a system in a country where a specific language is predominant, the language field can be used to indicate that language, which can help analysts to quickly identify and respond to incidents that may be geographically or culturally relevant. This information can be used to prioritize incidents based on their potential impact. The language field can also be used to help with correlation of incidents across different systems and regions, as well as to help with data analysis and reporting.
observables Observable Object List The object(s) of interest.
relations ObservedRelation Object List Provide any context we can about where the observable came from.
resolution ResolutionString Represents the disposition or actions taken on the associated threat intelligence.
revision Integer A monotonically increasing revision, incremented each time the object is changed.
sensor SensorString The OpenC2 Actuator name that best fits the device that is creating this sighting (e.g. network.firewall)
sensor_coordinates SensorCoordinates Object
severity SeverityString
short_description MedStringString A single line, short summary of the object.
source MedStringString Represents the source of the intelligence that led to the creation of the entity.
source_uri String URI of the source of the intelligence that led to the creation of the entity.
targets IdentitySpecification Object List May include one or more targets that observed the associated indicator. Targets can include network devices, host devices, or other entities that are capable of detecting indicators of compromise. Can be used to assess the scope of potential threats, helping analysts understand which devices or components of the network may be vulnerable to attack. For example, if a particular malware strain is detected on several different systems within an organization, the targets field may indicate which systems are affected and which may need to be isolated or patched to prevent further spread.
timestamp Inst (Date) The time this object was created at, or last modified.
title ShortStringString A short title for this object, used as primary display and reference value.
tlp TLPString TLP stands for Traffic Light Protocol, which indicates precisely how a resource is intended to be shared, replicated, copied, etc. It is used to indicate the sensitivity of the information contained within the message. This allows recipients to determine the appropriate handling and dissemination of the information based on their clearance level and need-to-know. For example, an entity containing information about a critical vulnerability in a widely-used software might be marked as red, indicating that it should only be shared with a small group of highly trusted individuals who need to know in order to take appropriate action. On the other hand, a message containing more general information about security threats might be marked as amber or green, indicating that it can be shared more broadly within an organization.

Property confidence ∷ HighMedLowString

  • This entry is required

    • Allowed Values:
      • High
      • Info
      • Low
      • Medium
      • None
      • Unknown
    • Reference: HighMedLowVocab

Property context ∷ Context Object

Context including the event type that best fits the type of the sighting.

  • This entry is optional

Property count ∷ Integer

The number of times an indicator was observed within a certain period of time. For example, if an IP address associated with known malicious activity is observed once within a period of time, it may indicate a low-level threat. However, if the same IP address is observed multiple times within a short time frame, it may indicate a more severe and persistent threat. It can also be used to prioritize security alerts and indicate the urgency of a response. High counts indicate that an indicator is actively being used in a larger campaign, while low counts may indicate isolated incidents.

  • This entry is required

    • Zero, or a positive integer.

Property data ∷ SightingDataTable Object

An embedded data table for the Sighting.

  • This entry is optional

Property description ∷ MarkdownString

A description of object, which may be detailed.

  • This entry is optional

    • Markdown Markdown string with at most 5000 characters.

Property external_ids ∷ String List

It is used to store a list of external identifiers that can be linked to the incident, providing a reliable and manageable way to correlate and group related events across multiple data sources. It is especially useful in larger organizations that rely on multiple security information and event management (SIEM) systems to detect security incidents. For instance, it can be used to track events across different network sensors, intrusion detection and prevention systems (IDPS), or log management platforms. The field can also be used to facilitate automation and orchestration workflows, where additional information can be shared among incident management systems. It can be used to cross-reference with other external tools such as threat intelligence feeds and vulnerability scanners.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property external_references ∷ ExternalReference Object List

Specifies a list of external references which refers to non-CTIM information.

Similar to external_ids field with major differences:

  • external_ids field is used to store a list of external identifiers that can be used to link entities across different data sources. These identifiers are typically standardized and well-known, such as CVE IDs, US-CERT advisories, or other industry-standard threat intelligence feeds. The external_ids field can be used to facilitate automation and orchestration workflows, where additional information can be shared among incident management systems.

  • external_references field, on the other hand, is used to provide a more general mechanism for linking entities to external sources of information. The external_references field can include references to blog posts, articles, external documents, threat intelligence reports, and other sources of information that may not have a standardized format or identifier.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property id ∷ String

Globally unique URI identifying this object.

  • This entry is required

    • IDs are URIs, for example https://www.domain.com/ctia/judgement/judgement-de305d54-75b4-431b-adb2-eb6b9e546014 for a Judgement. This ID type compares to the STIX id field. The optional STIX idref field is not used.

Property internal ∷ Boolean

If true, indicates that the sighting was reported from internal sources, such as an organization's own internal security tools or SOC. Internal sightings are often considered more reliable and actionable than external sightings, which are reported from external sources and may have a lower level of trustworthiness. Internal sightings can provide more context and can help identify potential threats that are unique to a particular environment or organization. Internal sightings can also help organizations prioritize their security response efforts by identifying threats that are specific to their environment and may not yet be widely known.

  • This entry is optional

Property language ∷ ShortStringString

The language field is used to specify the primary language of the affected system or the target of an attack. It can be used to provide additional context and information about the entity. The primary purpose of this field is to help analysts filter and prioritize entities based on their knowledge and expertise of different languages.

For example, if an incident involves an attack on a system in a country where a specific language is predominant, the language field can be used to indicate that language, which can help analysts to quickly identify and respond to incidents that may be geographically or culturally relevant. This information can be used to prioritize incidents based on their potential impact. The language field can also be used to help with correlation of incidents across different systems and regions, as well as to help with data analysis and reporting.

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property observables ∷ Observable Object List

The object(s) of interest.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property observed_time ∷ ObservedTime Object

  • This entry is required

Property relations ∷ ObservedRelation Object List

Provide any context we can about where the observable came from.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property resolution ∷ ResolutionString

Represents the disposition or actions taken on the associated threat intelligence.

  • This entry is optional

    • Resolution indicates if the sensor that is reporting the Sighting already took action on it, for instance a Firewall blocking the IP.
    • Allowed Values:
      • allowed
      • blocked
      • contained
      • detected

Property revision ∷ Integer

A monotonically increasing revision, incremented each time the object is changed.

  • This entry is optional

    • Zero, or a positive integer.

Property schema_version ∷ String

CTIM schema version for this entity.

  • This entry is required

    • A semantic version matching the CTIM version against which this object should be valid.

Property sensor ∷ SensorString

The OpenC2 Actuator name that best fits the device that is creating this sighting (e.g. network.firewall)

  • This entry is optional

    • Sensor The sensor/actuator name that best fits a device.
    • Allowed Values:
      • endpoint
      • endpoint.digital-telephone-handset
      • endpoint.laptop
      • endpoint.pos-terminal
      • endpoint.printer
      • endpoint.sensor
      • endpoint.server
      • endpoint.smart-meter
      • endpoint.smart-phone
      • endpoint.tablet
      • endpoint.workstation
      • network
      • network.bridge
      • network.firewall
      • network.gateway
      • network.guard
      • network.hips
      • network.hub
      • network.ids
      • network.ips
      • network.modem
      • network.nic
      • network.proxy
      • network.router
      • network.security_manager
      • network.sense_making
      • network.sensor
      • network.switch
      • network.vpn
      • network.wap
      • process
      • process.aaa-server
      • process.anti-virus-scanner
      • process.connection-scanner
      • process.directory-service
      • process.dns-server
      • process.email-service
      • process.file-scanner
      • process.location-service
      • process.network-scanner
      • process.remediation-service
      • process.reputation-service
      • process.sandbox
      • process.virtualization-service
      • process.vulnerability-scanner

Property sensor_coordinates ∷ SensorCoordinates Object

  • This entry is optional

Property severity ∷ SeverityString

  • This entry is optional

    • Allowed Values:
      • Critical
      • High
      • Info
      • Low
      • Medium
      • None
      • Unknown

Property short_description ∷ MedStringString

A single line, short summary of the object.

  • This entry is optional

    • MedString String with at most 2048 characters.

Property source ∷ MedStringString

Represents the source of the intelligence that led to the creation of the entity.

  • This entry is optional

    • MedString String with at most 2048 characters.

Property source_uri ∷ String

URI of the source of the intelligence that led to the creation of the entity.

  • This entry is optional

    • A URI

Property targets ∷ IdentitySpecification Object List

May include one or more targets that observed the associated indicator. Targets can include network devices, host devices, or other entities that are capable of detecting indicators of compromise.

Can be used to assess the scope of potential threats, helping analysts understand which devices or components of the network may be vulnerable to attack. For example, if a particular malware strain is detected on several different systems within an organization, the targets field may indicate which systems are affected and which may need to be isolated or patched to prevent further spread.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property timestamp ∷ Inst (Date)

The time this object was created at, or last modified.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property title ∷ ShortStringString

A short title for this object, used as primary display and reference value.

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property tlp ∷ TLPString

TLP stands for Traffic Light Protocol, which indicates precisely how a resource is intended to be shared, replicated, copied, etc.

It is used to indicate the sensitivity of the information contained within the message. This allows recipients to determine the appropriate handling and dissemination of the information based on their clearance level and need-to-know.

For example, an entity containing information about a critical vulnerability in a widely-used software might be marked as red, indicating that it should only be shared with a small group of highly trusted individuals who need to know in order to take appropriate action. On the other hand, a message containing more general information about security threats might be marked as amber or green, indicating that it can be shared more broadly within an organization.

  • This entry is optional

    • Allowed Values:
      • amber
      • green
      • red
      • white

Property type ∷ SightingTypeIdentifierString

  • This entry is required

    • Must equal: "sighting"

ExternalReference Object

ExternalReference External references are used to describe pointers to information represented outside of CTIM. For example, a Malware object could use an external reference to indicate an ID for that malware in an external database or a report could use references to represent source material.

Property Type Description Required?
source_name MedStringString The source within which the external-reference is defined (system, registry, organization, etc.)
description MarkdownString
external_id String An identifier for the external reference content.
hashes String List Specifies a dictionary of hashes for the contents of the url.
url String A URL reference to an external resource.

Property description ∷ MarkdownString

  • This entry is optional

    • Markdown Markdown string with at most 5000 characters.

Property external_id ∷ String

An identifier for the external reference content.

  • This entry is optional

Property hashes ∷ String List

Specifies a dictionary of hashes for the contents of the url.

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property source_name ∷ MedStringString

The source within which the external-reference is defined (system, registry, organization, etc.)

  • This entry is required

    • MedString String with at most 2048 characters.

Property url ∷ String

A URL reference to an external resource.

  • This entry is optional

    • A URI

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

SightingDataTable Object

SightingDataTable An embedded data table for sightings data.

Property Type Description Required?
columns ColumnDefinition Object List an ordered list of column definitions
rows Anything List an ordered list of rows
row_count Integer The number of rows in the data table.

Property columns ∷ ColumnDefinition Object List

an ordered list of column definitions

  • This entry is required
  • This entry's type is sequential (allows zero or more values)

Property row_count ∷ Integer

The number of rows in the data table.

  • This entry is optional

Property rows ∷ Anything List List

an ordered list of rows

  • This entry is required
  • This entry's type is sequential (allows zero or more values)

ColumnDefinition Object

Property Type Description Required?
name String
type ColumnTypeString
description MarkdownString
required Boolean If true, the row entries for this column cannot contain nulls. Defaults to true.
short_description String

Property description ∷ MarkdownString

  • This entry is optional

    • Markdown Markdown string with at most 5000 characters.

Property name ∷ String

  • This entry is required

Property required ∷ Boolean

If true, the row entries for this column cannot contain nulls. Defaults to true.

  • This entry is optional

Property short_description ∷ String

  • This entry is optional

Property type ∷ ColumnTypeString

  • This entry is required

    • Allowed Values:
      • integer
      • markdown
      • number
      • observable
      • string
      • url

SensorCoordinates Object

SensorCoordinates Describes the device that made the sighting (sensor) and contains identifying observables for the sensor.

Property Type Description Required?
observables Observable Object List
type SensorString
os String

Property observables ∷ Observable Object List

  • This entry is required
  • This entry's type is sequential (allows zero or more values)

Property os ∷ String

  • This entry is optional

Property type ∷ SensorString

  • This entry is required

    • Sensor The sensor/actuator name that best fits a device.
    • Allowed Values:
      • endpoint
      • endpoint.digital-telephone-handset
      • endpoint.laptop
      • endpoint.pos-terminal
      • endpoint.printer
      • endpoint.sensor
      • endpoint.server
      • endpoint.smart-meter
      • endpoint.smart-phone
      • endpoint.tablet
      • endpoint.workstation
      • network
      • network.bridge
      • network.firewall
      • network.gateway
      • network.guard
      • network.hips
      • network.hub
      • network.ids
      • network.ips
      • network.modem
      • network.nic
      • network.proxy
      • network.router
      • network.security_manager
      • network.sense_making
      • network.sensor
      • network.switch
      • network.vpn
      • network.wap
      • process
      • process.aaa-server
      • process.anti-virus-scanner
      • process.connection-scanner
      • process.directory-service
      • process.dns-server
      • process.email-service
      • process.file-scanner
      • process.location-service
      • process.network-scanner
      • process.remediation-service
      • process.reputation-service
      • process.sandbox
      • process.virtualization-service
      • process.vulnerability-scanner

Observable Object

Observable A simple, atomic value which has a consistent identity, and is stable enough to be attributed an intent or nature. This is the classic 'indicator' which might appear in a data feed of bad IPs, or bad Domains. These do not exist as objects within the CTIA storage model, so you never create an observable.

Property Type Description Required?
type ObservableTypeIdentifierString The type of observable.
value String The value of the observable.

Property type ∷ ObservableTypeIdentifierString

The type of observable.

  • This entry is required

    • ObservableTypeIdentifier Observable type names
    • Allowed Values:
      • acudid
      • amp_computer_guid
      • certificate_common_name
      • certificate_issuer
      • certificate_serial
      • cisco_cm_id
      • cisco_mid
      • cisco_uc_id
      • cortex_agent_id
      • crowdstrike_id
      • cvm_id
      • cybereason_id
      • darktrace_id
      • device
      • domain
      • email
      • email_messageid
      • email_subject
      • file_name
      • file_path
      • hostname
      • imei
      • imsi
      • ip
      • ipv6
      • mac_address
      • md5
      • meraki_network_id
      • meraki_node_sn
      • meraki_org_id
      • ms_machine_id
      • mutex
      • ngfw_id
      • ngfw_name
      • odns_identity
      • odns_identity_label
      • orbital_node_id
      • pki_serial
      • process_args
      • process_hash
      • process_name
      • process_path
      • process_uid
      • process_username
      • processor_id
      • registry_key
      • registry_name
      • registry_path
      • s1_agent_id
      • serial_number
      • sha1
      • sha256
      • swc_device_id
      • trend_micro_id
      • url
      • user
      • user_agent

Property value ∷ String

The value of the observable.

  • This entry is required

IdentitySpecification Object

IdentitySpecification Describes the target of the sighting and contains identifying observables for the target.

Property Type Description Required?
observables Observable Object List
observed_time ObservedTime Object
type SensorString
os String

Property observables ∷ Observable Object List

  • This entry is required
  • This entry's type is sequential (allows zero or more values)

Property observed_time ∷ ObservedTime Object

  • This entry is required

Property os ∷ String

  • This entry is optional

Property type ∷ SensorString

  • This entry is required

    • Sensor The sensor/actuator name that best fits a device.
    • Allowed Values:
      • endpoint
      • endpoint.digital-telephone-handset
      • endpoint.laptop
      • endpoint.pos-terminal
      • endpoint.printer
      • endpoint.sensor
      • endpoint.server
      • endpoint.smart-meter
      • endpoint.smart-phone
      • endpoint.tablet
      • endpoint.workstation
      • network
      • network.bridge
      • network.firewall
      • network.gateway
      • network.guard
      • network.hips
      • network.hub
      • network.ids
      • network.ips
      • network.modem
      • network.nic
      • network.proxy
      • network.router
      • network.security_manager
      • network.sense_making
      • network.sensor
      • network.switch
      • network.vpn
      • network.wap
      • process
      • process.aaa-server
      • process.anti-virus-scanner
      • process.connection-scanner
      • process.directory-service
      • process.dns-server
      • process.email-service
      • process.file-scanner
      • process.location-service
      • process.network-scanner
      • process.remediation-service
      • process.reputation-service
      • process.sandbox
      • process.virtualization-service
      • process.vulnerability-scanner

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Observable Object

Observable A simple, atomic value which has a consistent identity, and is stable enough to be attributed an intent or nature. This is the classic 'indicator' which might appear in a data feed of bad IPs, or bad Domains. These do not exist as objects within the CTIA storage model, so you never create an observable.

Property Type Description Required?
type ObservableTypeIdentifierString The type of observable.
value String The value of the observable.

Property type ∷ ObservableTypeIdentifierString

The type of observable.

  • This entry is required

    • ObservableTypeIdentifier Observable type names
    • Allowed Values:
      • acudid
      • amp_computer_guid
      • certificate_common_name
      • certificate_issuer
      • certificate_serial
      • cisco_cm_id
      • cisco_mid
      • cisco_uc_id
      • cortex_agent_id
      • crowdstrike_id
      • cvm_id
      • cybereason_id
      • darktrace_id
      • device
      • domain
      • email
      • email_messageid
      • email_subject
      • file_name
      • file_path
      • hostname
      • imei
      • imsi
      • ip
      • ipv6
      • mac_address
      • md5
      • meraki_network_id
      • meraki_node_sn
      • meraki_org_id
      • ms_machine_id
      • mutex
      • ngfw_id
      • ngfw_name
      • odns_identity
      • odns_identity_label
      • orbital_node_id
      • pki_serial
      • process_args
      • process_hash
      • process_name
      • process_path
      • process_uid
      • process_username
      • processor_id
      • registry_key
      • registry_name
      • registry_path
      • s1_agent_id
      • serial_number
      • sha1
      • sha256
      • swc_device_id
      • trend_micro_id
      • url
      • user
      • user_agent

Property value ∷ String

The value of the observable.

  • This entry is required

Observable Object

Observable A simple, atomic value which has a consistent identity, and is stable enough to be attributed an intent or nature. This is the classic 'indicator' which might appear in a data feed of bad IPs, or bad Domains. These do not exist as objects within the CTIA storage model, so you never create an observable.

Property Type Description Required?
type ObservableTypeIdentifierString The type of observable.
value String The value of the observable.

Property type ∷ ObservableTypeIdentifierString

The type of observable.

  • This entry is required

    • ObservableTypeIdentifier Observable type names
    • Allowed Values:
      • acudid
      • amp_computer_guid
      • certificate_common_name
      • certificate_issuer
      • certificate_serial
      • cisco_cm_id
      • cisco_mid
      • cisco_uc_id
      • cortex_agent_id
      • crowdstrike_id
      • cvm_id
      • cybereason_id
      • darktrace_id
      • device
      • domain
      • email
      • email_messageid
      • email_subject
      • file_name
      • file_path
      • hostname
      • imei
      • imsi
      • ip
      • ipv6
      • mac_address
      • md5
      • meraki_network_id
      • meraki_node_sn
      • meraki_org_id
      • ms_machine_id
      • mutex
      • ngfw_id
      • ngfw_name
      • odns_identity
      • odns_identity_label
      • orbital_node_id
      • pki_serial
      • process_args
      • process_hash
      • process_name
      • process_path
      • process_uid
      • process_username
      • processor_id
      • registry_key
      • registry_name
      • registry_path
      • s1_agent_id
      • serial_number
      • sha1
      • sha256
      • swc_device_id
      • trend_micro_id
      • url
      • user
      • user_agent

Property value ∷ String

The value of the observable.

  • This entry is required

ObservedRelation Object

ObservedRelation A relation inside a Sighting.

Property Type Description Required?
origin String
related Observable Object
relation ObservableRelationTypeString
source Observable Object
origin_uri String
relation_info Object

Property origin ∷ String

  • This entry is required

Property origin_uri ∷ String

  • This entry is optional

    • A URI

Property related ∷ Observable Object

  • This entry is required

Property relation ∷ ObservableRelationTypeString

  • This entry is required

    • Allowed Values:
      • Allocated
      • Allocated_By
      • Attached_To
      • Bound
      • Bound_By
      • Characterized_By
      • Characterizes
      • Child_Of
      • Closed
      • Closed_By
      • Compressed
      • Compressed_By
      • Compressed_From
      • Compressed_Into
      • Connected_From
      • Connected_To
      • Contained_Within
      • Contains
      • Copied
      • Copied_By
      • Copied_From
      • Copied_To
      • Created
      • Created_By
      • Decoded
      • Decoded_By
      • Decompressed
      • Decompressed_By
      • Decrypted
      • Decrypted_By
      • Deleted
      • Deleted_By
      • Deleted_From
      • Downloaded
      • Downloaded_By
      • Downloaded_From
      • Downloaded_To
      • Dropped
      • Dropped_By
      • Encoded
      • Encoded_By
      • Encrypted
      • Encrypted_By
      • Encrypted_From
      • Encrypted_To
      • Extracted_From
      • FQDN_Of
      • Freed
      • Freed_By
      • Hooked
      • Hooked_By
      • Initialized_By
      • Initialized_To
      • Injected
      • Injected_As
      • Injected_By
      • Injected_Into
      • Installed
      • Installed_By
      • Joined
      • Joined_By
      • Killed
      • Killed_By
      • Listened_On
      • Listened_On_By
      • Loaded_From
      • Loaded_Into
      • Locked
      • Locked_By
      • Mapped_By
      • Mapped_Into
      • Merged
      • Merged_By
      • Modified_Properties_Of
      • Monitored
      • Monitored_By
      • Moved
      • Moved_By
      • Moved_From
      • Moved_To
      • Opened
      • Opened_By
      • Packed
      • Packed_By
      • Packed_From
      • Packed_Into
      • Parent_Of
      • Paused
      • Paused_By
      • Previously_Contained
      • Properties_Modified_By
      • Properties_Queried
      • Properties_Queried_By
      • Read_From
      • Read_From_By
      • Received
      • Received_By
      • Received_From
      • Received_Via_Upload
      • Redirects_To
      • Refers_To
      • Related_To
      • Renamed
      • Renamed_By
      • Renamed_From
      • Renamed_To
      • Resolved_To
      • Resumed
      • Resumed_By
      • Root_Domain_Of
      • Searched_For
      • Searched_For_By
      • Sent
      • Sent_By
      • Sent_To
      • Sent_Via_Upload
      • Set_From
      • Set_To
      • Sub-domain_Of
      • Supra-domain_Of
      • Suspended
      • Suspended_By
      • Unhooked
      • Unhooked_By
      • Unlocked
      • Unlocked_By
      • Unpacked
      • Unpacked_By
      • Uploaded
      • Uploaded_By
      • Uploaded_From
      • Uploaded_To
      • Used
      • Used_By
      • Values_Enumerated
      • Values_Enumerated_By
      • Written_To_By
      • Wrote_To

Property relation_info ∷ Object

  • This entry is optional

  • Object Value

Property source ∷ Observable Object

  • This entry is required

Observable Object

Observable A simple, atomic value which has a consistent identity, and is stable enough to be attributed an intent or nature. This is the classic 'indicator' which might appear in a data feed of bad IPs, or bad Domains. These do not exist as objects within the CTIA storage model, so you never create an observable.

Property Type Description Required?
type ObservableTypeIdentifierString The type of observable.
value String The value of the observable.

Property type ∷ ObservableTypeIdentifierString

The type of observable.

  • This entry is required

    • ObservableTypeIdentifier Observable type names
    • Allowed Values:
      • acudid
      • amp_computer_guid
      • certificate_common_name
      • certificate_issuer
      • certificate_serial
      • cisco_cm_id
      • cisco_mid
      • cisco_uc_id
      • cortex_agent_id
      • crowdstrike_id
      • cvm_id
      • cybereason_id
      • darktrace_id
      • device
      • domain
      • email
      • email_messageid
      • email_subject
      • file_name
      • file_path
      • hostname
      • imei
      • imsi
      • ip
      • ipv6
      • mac_address
      • md5
      • meraki_network_id
      • meraki_node_sn
      • meraki_org_id
      • ms_machine_id
      • mutex
      • ngfw_id
      • ngfw_name
      • odns_identity
      • odns_identity_label
      • orbital_node_id
      • pki_serial
      • process_args
      • process_hash
      • process_name
      • process_path
      • process_uid
      • process_username
      • processor_id
      • registry_key
      • registry_name
      • registry_path
      • s1_agent_id
      • serial_number
      • sha1
      • sha256
      • swc_device_id
      • trend_micro_id
      • url
      • user
      • user_agent

Property value ∷ String

The value of the observable.

  • This entry is required

Observable Object

Observable A simple, atomic value which has a consistent identity, and is stable enough to be attributed an intent or nature. This is the classic 'indicator' which might appear in a data feed of bad IPs, or bad Domains. These do not exist as objects within the CTIA storage model, so you never create an observable.

Property Type Description Required?
type ObservableTypeIdentifierString The type of observable.
value String The value of the observable.

Property type ∷ ObservableTypeIdentifierString

The type of observable.

  • This entry is required

    • ObservableTypeIdentifier Observable type names
    • Allowed Values:
      • acudid
      • amp_computer_guid
      • certificate_common_name
      • certificate_issuer
      • certificate_serial
      • cisco_cm_id
      • cisco_mid
      • cisco_uc_id
      • cortex_agent_id
      • crowdstrike_id
      • cvm_id
      • cybereason_id
      • darktrace_id
      • device
      • domain
      • email
      • email_messageid
      • email_subject
      • file_name
      • file_path
      • hostname
      • imei
      • imsi
      • ip
      • ipv6
      • mac_address
      • md5
      • meraki_network_id
      • meraki_node_sn
      • meraki_org_id
      • ms_machine_id
      • mutex
      • ngfw_id
      • ngfw_name
      • odns_identity
      • odns_identity_label
      • orbital_node_id
      • pki_serial
      • process_args
      • process_hash
      • process_name
      • process_path
      • process_uid
      • process_username
      • processor_id
      • registry_key
      • registry_name
      • registry_path
      • s1_agent_id
      • serial_number
      • sha1
      • sha256
      • swc_device_id
      • trend_micro_id
      • url
      • user
      • user_agent

Property value ∷ String

The value of the observable.

  • This entry is required

Object

Property Type Description Required?
Keyword Anything

Property Keyword ∷ Anything

  • This entry is required

Context Object

Property Type Description Required?
file_create_events FileCreateType Object List a list of FileCreateType
file_delete_events FileDeleteType Object List a list of FileDeleteType
file_modify_events FileModifyType Object List a list of FileModifyType
file_move_events FileMoveType Object List a list of FileMoveType
http_events HTTPType Object List a list of HTTPType
library_load_events LibraryLoadType Object List a list of LibraryLoadType
netflow_events NetflowType Object List a list of NetflowType
process_create_events ProcessCreateType Object List a list of ProcessCreate
registry_create_events RegistryCreateType Object List a list of RegistryCreateType
registry_delete_events RegistryDeleteType Object List a list of RegistryDeleteType
registry_rename_events RegistryRenameType Object List a list of RegistryRenameType
registry_set_events RegistrySetType Object List a list of RegistrySetType

Property file_create_events ∷ FileCreateType Object List

a list of FileCreateType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property file_delete_events ∷ FileDeleteType Object List

a list of FileDeleteType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property file_modify_events ∷ FileModifyType Object List

a list of FileModifyType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property file_move_events ∷ FileMoveType Object List

a list of FileMoveType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property http_events ∷ HTTPType Object List

a list of HTTPType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property library_load_events ∷ LibraryLoadType Object List

a list of LibraryLoadType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property netflow_events ∷ NetflowType Object List

a list of NetflowType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property process_create_events ∷ ProcessCreateType Object List

a list of ProcessCreate

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property registry_create_events ∷ RegistryCreateType Object List

a list of RegistryCreateType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property registry_delete_events ∷ RegistryDeleteType Object List

a list of RegistryDeleteType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property registry_rename_events ∷ RegistryRenameType Object List

a list of RegistryRenameType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

Property registry_set_events ∷ RegistrySetType Object List

a list of RegistrySetType

  • This entry is optional
  • This entry's type is sequential (allows zero or more values)

RegistryRenameType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
registry_key ShortStringString
registry_old_key ShortStringString
time ObservedTime Object
type RegistryRenameTypeIdentifierString
process_guid Integer
process_username ShortStringString

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property registry_key ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property registry_old_key ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ RegistryRenameTypeIdentifierString

  • This entry is required

    • Must equal: "RegistryRenameEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

RegistryDeleteType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
registry_key ShortStringString
time ObservedTime Object
type RegistryDeleteTypeIdentifierString
process_guid Integer
process_username ShortStringString
registry_value MedStringString

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property registry_key ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property registry_value ∷ MedStringString

  • This entry is optional

    • MedString String with at most 2048 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ RegistryDeleteTypeIdentifierString

  • This entry is required

    • Must equal: "RegistryDeleteEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

RegistrySetType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
registry_key ShortStringString
registry_value MedStringString
time ObservedTime Object
type RegistrySetTypeIdentifierString
process_guid Integer
process_username ShortStringString
registry_data LongStringString
registry_data_length Integer

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property registry_data ∷ LongStringString

  • This entry is optional

    • LongString String with at most 5000 characters.

Property registry_data_length ∷ Integer

  • This entry is optional

Property registry_key ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property registry_value ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ RegistrySetTypeIdentifierString

  • This entry is required

    • Must equal: "RegistrySetEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

RegistryCreateType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
registry_key ShortStringString
time ObservedTime Object
type RegistryCreateTypeIdentifierString
process_guid Integer
process_username ShortStringString

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property registry_key ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ RegistryCreateTypeIdentifierString

  • This entry is required

    • Must equal: "RegistryCreateEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

HTTPType Object

Property Type Description Required?
host ShortStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
traffic Traffic Object
type HTTPTypeIdentifierString
encrypted Boolean
method HTTPMethodString
process_guid Integer
process_username ShortStringString
query LongStringString
url_port Integer

Property encrypted ∷ Boolean

  • This entry is optional

Property host ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property method ∷ HTTPMethodString

  • This entry is optional

    • Allowed Values:
      • CONNECT
      • GET
      • HEAD
      • OPTIONS
      • PATCH
      • POST
      • PUT
      • TRACE

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property query ∷ LongStringString

  • This entry is optional

    • LongString String with at most 5000 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property traffic ∷ Traffic Object

  • This entry is required

Property type ∷ HTTPTypeIdentifierString

  • This entry is required

    • Must equal: "HTTPEvent"

Property url_port ∷ Integer

  • This entry is optional

Traffic Object

Property Type Description Required?
destination_ip String
destination_port Integer
direction TrafficDirectionString
protocol Integer The IP protocol id
source_ip String
source_port Integer
destination_host_name String
destination_subnet String
source_subnet String

Property destination_host_name ∷ String

  • This entry is optional

Property destination_ip ∷ String

  • This entry is required

Property destination_port ∷ Integer

  • This entry is required

Property destination_subnet ∷ String

  • This entry is optional

Property direction ∷ TrafficDirectionString

  • This entry is required

    • Allowed Values:
      • incoming
      • outgoing

Property protocol ∷ Integer

The IP protocol id

  • This entry is required

Property source_ip ∷ String

  • This entry is required

Property source_port ∷ Integer

  • This entry is required

Property source_subnet ∷ String

  • This entry is optional

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

NetflowType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
time ObservedTime Object
traffic Traffic Object
type NetflowTypeIdentifierString
byte_count_in Integer
byte_count_out Integer
flow_time Inst (Date)
parent_process_account ShortStringString
parent_process_account_type ShortStringString
parent_process_args ShortStringString
parent_process_hash ShortStringString
parent_process_id Integer
parent_process_name ShortStringString
parent_process_path ShortStringString
process_account ShortStringString
process_account_type ShortStringString
process_args ShortStringString
process_guid Integer
process_hash ShortStringString
process_path ShortStringString
process_username ShortStringString

Property byte_count_in ∷ Integer

  • This entry is optional

Property byte_count_out ∷ Integer

  • This entry is optional

Property flow_time ∷ Inst (Date)

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property parent_process_account ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_account_type ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_args ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_hash ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_id ∷ Integer

  • This entry is optional

Property parent_process_name ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_path ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_account ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_account_type ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_args ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_hash ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_path ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property traffic ∷ Traffic Object

  • This entry is required

Property type ∷ NetflowTypeIdentifierString

  • This entry is required

    • Must equal: "NetflowEvent"

Traffic Object

Property Type Description Required?
destination_ip String
destination_port Integer
direction TrafficDirectionString
protocol Integer The IP protocol id
source_ip String
source_port Integer
destination_host_name String
destination_subnet String
source_subnet String

Property destination_host_name ∷ String

  • This entry is optional

Property destination_ip ∷ String

  • This entry is required

Property destination_port ∷ Integer

  • This entry is required

Property destination_subnet ∷ String

  • This entry is optional

Property direction ∷ TrafficDirectionString

  • This entry is required

    • Allowed Values:
      • incoming
      • outgoing

Property protocol ∷ Integer

The IP protocol id

  • This entry is required

Property source_ip ∷ String

  • This entry is required

Property source_port ∷ Integer

  • This entry is required

Property source_subnet ∷ String

  • This entry is optional

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

FileMoveType Object

Property Type Description Required?
file_name ShortStringString
file_path MedStringString
new_name ShortStringString
old_name ShortStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
type FileMoveTypeIdentifierString
process_guid Integer
process_username ShortStringString

Property file_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property file_path ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property new_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property old_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ FileMoveTypeIdentifierString

  • This entry is required

    • Must equal: "FileMoveEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

FileModifyType Object

Property Type Description Required?
file_name ShortStringString
file_path MedStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
type FileModifyTypeIdentifierString
failed Boolean
process_guid Integer
process_username ShortStringString

Property failed ∷ Boolean

  • This entry is optional

Property file_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property file_path ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ FileModifyTypeIdentifierString

  • This entry is required

    • Must equal: "FileModifyEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

FileDeleteType Object

Property Type Description Required?
file_name ShortStringString
file_path MedStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
type FileDeleteTypeIdentifierString
failed Boolean
process_guid Integer
process_username ShortStringString

Property failed ∷ Boolean

  • This entry is optional

Property file_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property file_path ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ FileDeleteTypeIdentifierString

  • This entry is required

    • Must equal: "FileDeleteEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

FileCreateType Object

Property Type Description Required?
file_name ShortStringString
file_path MedStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
type FileCreateTypeIdentifierString
failed Boolean
process_guid Integer
process_username ShortStringString

Property failed ∷ Boolean

  • This entry is optional

Property file_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property file_path ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ FileCreateTypeIdentifierString

  • This entry is required

    • Must equal: "FileCreateEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

LibraryLoadType Object

Property Type Description Required?
dll_library_name ShortStringString
dll_library_path MedStringString
process_id Integer
process_name ShortStringString
time ObservedTime Object
type LibraryLoadTypeIdentifierString
process_guid Integer
process_username ShortStringString

Property dll_library_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property dll_library_path ∷ MedStringString

  • This entry is required

    • MedString String with at most 2048 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ LibraryLoadTypeIdentifierString

  • This entry is required

    • Must equal: "LibraryLoadEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

ProcessCreateType Object

Property Type Description Required?
process_id Integer
process_name ShortStringString
time ObservedTime Object
type ProcessCreateTypeIdentifierString
parent_creation_time Inst (Date)
parent_process_args MedStringString
parent_process_disposition ShortStringString
parent_process_guid Integer
parent_process_hash MedStringString
parent_process_id Integer
parent_process_name ShortStringString
parent_process_size Integer
parent_process_username ShortStringString
process_args MedStringString
process_disposition ShortStringString
process_guid Integer
process_hash MedStringString
process_size Integer
process_username ShortStringString

Property parent_creation_time ∷ Inst (Date)

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property parent_process_args ∷ MedStringString

  • This entry is optional

    • MedString String with at most 2048 characters.

Property parent_process_disposition ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_guid ∷ Integer

  • This entry is optional

Property parent_process_hash ∷ MedStringString

  • This entry is optional

    • MedString String with at most 2048 characters.

Property parent_process_id ∷ Integer

  • This entry is optional

Property parent_process_name ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property parent_process_size ∷ Integer

  • This entry is optional

Property parent_process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_args ∷ MedStringString

  • This entry is optional

    • MedString String with at most 2048 characters.

Property process_disposition ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property process_guid ∷ Integer

  • This entry is optional

Property process_hash ∷ MedStringString

  • This entry is optional

    • MedString String with at most 2048 characters.

Property process_id ∷ Integer

  • This entry is required

Property process_name ∷ ShortStringString

  • This entry is required

    • ShortString String with at most 1024 characters.

Property process_size ∷ Integer

  • This entry is optional

Property process_username ∷ ShortStringString

  • This entry is optional

    • ShortString String with at most 1024 characters.

Property time ∷ ObservedTime Object

  • This entry is required

Property type ∷ ProcessCreateTypeIdentifierString

  • This entry is required

    • Must equal: "ProcessCreateEvent"

ObservedTime Object

ObservedTime Period of time when a cyber observation is valid. start_time must come before end_time (if specified).

Property Type Description Required?
start_time Inst (Date) Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.
end_time Inst (Date) If the observation was made over a period of time, than this field indicates the end of that period.

Property end_time ∷ Inst (Date)

If the observation was made over a period of time, than this field indicates the end of that period.

  • This entry is optional

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.

Property start_time ∷ Inst (Date)

Time of the observation. If the observation was made over a period of time, than this field indicates the start of that period.

  • This entry is required

    • ISO8601 Timestamp Schema definition for all date or timestamp values. Serialized as a string, the field should follow the rules of the ISO8601 standard.