#[non_exhaustive]pub struct NetworkFileActivity {Show 75 fields
pub action: Option<String>,
pub action_id: Option<i64>,
pub activity_id: Option<i64>,
pub activity_name: Option<String>,
pub actor: Option<Box<Actor>>,
pub api: Option<Box<Api>>,
pub app_name: Option<String>,
pub attacks: Option<Vec<Attack>>,
pub authorizations: Option<Vec<Authorization>>,
pub category_name: Option<String>,
pub category_uid: Option<i64>,
pub class_name: Option<String>,
pub class_uid: Option<i64>,
pub cloud: Option<Box<Cloud>>,
pub confidence: Option<String>,
pub confidence_id: Option<i64>,
pub confidence_score: Option<i64>,
pub connection_info: Option<Box<NetworkConnectionInfo>>,
pub count: Option<i64>,
pub cumulative_traffic: Option<Box<NetworkTraffic>>,
pub device: Option<Box<Device>>,
pub disposition: Option<String>,
pub disposition_id: Option<i64>,
pub dst_endpoint: Option<Box<NetworkEndpoint>>,
pub duration: Option<i64>,
pub end_time: Option<i64>,
pub end_time_dt: Option<String>,
pub enrichments: Option<Vec<Enrichment>>,
pub expiration_time: Option<i64>,
pub expiration_time_dt: Option<String>,
pub file: Option<Box<File>>,
pub firewall_rule: Option<Box<FirewallRule>>,
pub is_alert: Option<bool>,
pub ja4_fingerprint_list: Option<Vec<Ja4Fingerprint>>,
pub load_balancer: Option<Box<LoadBalancer>>,
pub malware: Option<Vec<Malware>>,
pub malware_scan_info: Option<Box<MalwareScanInfo>>,
pub message: Option<String>,
pub metadata: Option<Box<Metadata>>,
pub observables: Option<Vec<Observable>>,
pub observation_point: Option<String>,
pub observation_point_id: Option<i64>,
pub osint: Option<Vec<Osint>>,
pub policy: Option<Box<Policy>>,
pub proxy: Option<Box<NetworkProxy>>,
pub proxy_connection_info: Option<Box<NetworkConnectionInfo>>,
pub proxy_endpoint: Option<Box<NetworkProxy>>,
pub proxy_http_request: Option<Box<HttpRequest>>,
pub proxy_http_response: Option<Box<HttpResponse>>,
pub proxy_tls: Option<Box<Tls>>,
pub proxy_traffic: Option<Box<NetworkTraffic>>,
pub raw_data: Option<String>,
pub raw_data_hash: Option<Box<Fingerprint>>,
pub raw_data_size: Option<i64>,
pub risk_details: Option<String>,
pub risk_level: Option<String>,
pub risk_level_id: Option<i64>,
pub risk_score: Option<i64>,
pub severity: Option<String>,
pub severity_id: Option<i64>,
pub src_endpoint: Option<Box<NetworkEndpoint>>,
pub start_time: Option<i64>,
pub start_time_dt: Option<String>,
pub status: Option<String>,
pub status_code: Option<String>,
pub status_detail: Option<String>,
pub status_id: Option<i64>,
pub time: Option<i64>,
pub time_dt: Option<String>,
pub timezone_offset: Option<i64>,
pub tls: Option<Box<Tls>>,
pub traffic: Option<Box<NetworkTraffic>>,
pub type_name: Option<String>,
pub type_uid: Option<i64>,
pub unmapped: Option<Value>,
}Expand description
Network File Activity
Network File Activity events report file activities traversing the network, including file storage services such as Box, MS OneDrive, or Google Drive.
[UID:4010] Category: network | Name: network_file_activity
Constraints:
- at_least_one:
[dst_endpoint,src_endpoint]
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.action: Option<String>Action
The normalized caption of action_id.
optional
action_id: Option<i64>Action ID
The action taken by a control or other policy-based system leading to an outcome or disposition. An unknown action may still correspond to a known disposition. Refer to disposition_id for the outcome of the action.
recommended
activity_id: Option<i64>Activity ID
The normalized identifier of the activity that triggered the event.
required
activity_name: Option<String>Activity
The event activity name, as defined by the activity_id.
optional
actor: Option<Box<Actor>>Actor
The actor that performed the activity on the target file.
required
api: Option<Box<Api>>API Details
Describes details about a typical API (Application Programming Interface) call.
optional
app_name: Option<String>Application Name
The name of the application associated with the event or object.
optional
attacks: Option<Vec<Attack>>MITRE ATT&CKŽ and ATLAS⢠Details
An array of MITRE ATT&CKŽ objects describing identified tactics, techniques & sub-techniques. The objects are compatible with MITRE ATLAS⢠tactics, techniques & sub-techniques.
optional
Authorization Information
Provides details about an authorization, such as authorization outcome, and any associated policies related to the activity/event.
optional
category_name: Option<String>Category
The event category name, as defined by category_uid value: Network Activity.
optional
category_uid: Option<i64>Category ID
The category unique identifier of the event.
required
class_name: Option<String>Class
The event class name, as defined by class_uid value: Network File Activity.
optional
class_uid: Option<i64>Class ID
The unique identifier of a class. A class describes the attributes available in an event.
required
cloud: Option<Box<Cloud>>Cloud
Describes details about the Cloud environment where the event or finding was created.
required
confidence: Option<String>Confidence
The confidence, normalized to the caption of the confidence_id value. In the case of âOtherâ, it is defined by the event source.
optional
confidence_id: Option<i64>Confidence ID
The normalized confidence refers to the accuracy of the rule that created the finding. A rule with a low confidence means that the finding scope is wide and may create finding reports that may not be malicious in nature.
recommended
confidence_score: Option<i64>Confidence Score
The confidence score as reported by the event source.
optional
connection_info: Option<Box<NetworkConnectionInfo>>Connection Info
The network connection information.
optional
count: Option<i64>Count
The number of times that events in the same logical group occurred during the event Start Time to End Time period.
optional
cumulative_traffic: Option<Box<NetworkTraffic>>Cumulative Traffic
The cumulative (running total) network traffic aggregated from the start of a flow or session. Use when reporting: (1) total accumulated bytes/packets since flow initiation, (2) combined aggregation models where both incremental deltas and running totals are reported together (populate both traffic for the delta and this attribute for the cumulative total), or (3) final summary metrics when a long-lived connection closes. This represents the sum of all activity from flow start to the current observation, not a delta or point-in-time value.
optional
device: Option<Box<Device>>Device
An addressable device, computer system or host.
recommended
disposition: Option<String>Disposition
The disposition name, normalized to the caption of the disposition_id value. In the case of âOtherâ, it is defined by the event source.
optional
disposition_id: Option<i64>Disposition ID
Describes the outcome or action taken by a security control, such as access control checks, malware detections or various types of policy violations.
recommended
dst_endpoint: Option<Box<NetworkEndpoint>>Destination Endpoint
The endpoint that received the activity on the target file.
recommended
duration: Option<i64>Duration Milliseconds
The event duration or aggregate time, the amount of time the event covers from start_time to end_time in milliseconds.
optional
end_time: Option<i64>End Time
The end time of a time period, or the time of the most recent event included in the aggregate event.
optional
end_time_dt: Option<String>End Time
The end time of a time period, or the time of the most recent event included in the aggregate event.
optional
enrichments: Option<Vec<Enrichment>>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â}}]
optional
expiration_time: Option<i64>Expiration Time
The share expiration time.
optional
expiration_time_dt: Option<String>Expiration Time
The share expiration time.
optional
file: Option<Box<File>>File
The file that is the target of the activity.
required
firewall_rule: Option<Box<FirewallRule>>Firewall Rule
The firewall rule that pertains to the control that triggered the event, if applicable.
optional
is_alert: Option<bool>Alert
Indicates that the event is considered to be an alertable signal. Should be set to true if disposition_id = Alert among other dispositions, and/or risk_level_id or severity_id of the event is elevated. Not all control events will be alertable, for example if disposition_id = Exonerated or disposition_id = Allowed.
recommended
ja4_fingerprint_list: Option<Vec<Ja4Fingerprint>>JA4+ Fingerprints
A list of the JA4+ network fingerprints.
optional
load_balancer: Option<Box<LoadBalancer>>Load Balancer
The Load Balancer object contains information related to the device that is distributing incoming traffic to specified destinations.
recommended
malware: Option<Vec<Malware>>Malware
A list of Malware objects, describing details about the identified malware.
optional
malware_scan_info: Option<Box<MalwareScanInfo>>Malware Scan Info
Describes details about the scan job that identified malware on the target system.
optional
message: Option<String>Message
The description of the event/finding, as defined by the source.
recommended
metadata: Option<Box<Metadata>>Metadata
The metadata associated with the event or a finding.
required
observables: Option<Vec<Observable>>Observables
The observables associated with the event or a finding.
recommended
observation_point: Option<String>Observation Point
Indicates whether the source network endpoint, destination network endpoint, or neither served as the observation point for the activity. The value is normalized to the caption of the observation_point_id.
optional
observation_point_id: Option<i64>Observation Point ID
The normalized identifier of the observation point. The observation point identifier indicates whether the source network endpoint, destination network endpoint, or neither served as the observation point for the activity.
optional
osint: Option<Vec<Osint>>OSINT
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.
required
policy: Option<Box<Policy>>Policy
The policy that pertains to the control that triggered the event, if applicable. For example the name of an anti-malware policy or an access control policy.
optional
proxy: Option<Box<NetworkProxy>>Proxy
The proxy (server) in a network connection.
recommended
proxy_connection_info: Option<Box<NetworkConnectionInfo>>Proxy Connection Info
The connection information from the proxy server to the remote server.
recommended
proxy_endpoint: Option<Box<NetworkProxy>>Proxy Endpoint
The proxy (server) in a network connection.
optional
proxy_http_request: Option<Box<HttpRequest>>Proxy HTTP Request
The HTTP Request from the proxy server to the remote server.
optional
proxy_http_response: Option<Box<HttpResponse>>Proxy HTTP Response
The HTTP Response from the remote server to the proxy server.
optional
proxy_tls: Option<Box<Tls>>Proxy TLS
The TLS protocol negotiated between the proxy server and the remote server.
recommended
proxy_traffic: Option<Box<NetworkTraffic>>Proxy Traffic
The network traffic refers to the amount of data moving across a network, from proxy to remote server at a given point of time.
recommended
raw_data: Option<String>Raw Data
The raw event/finding data as received from the source.
optional
raw_data_hash: Option<Box<Fingerprint>>Raw Data Hash
The hash, which describes the content of the raw_data field.
optional
raw_data_size: Option<i64>Raw Data Size
The size of the raw data which was transformed into an OCSF event, in bytes.
optional
risk_details: Option<String>Risk Details
Describes the risk associated with the finding.
optional
risk_level: Option<String>Risk Level
The risk level, normalized to the caption of the risk_level_id value.
optional
risk_level_id: Option<i64>Risk Level ID
The normalized risk level id.
optional
risk_score: Option<i64>Risk Score
The risk score as reported by the event source.
optional
severity: Option<String>Severity
The event/finding severity, normalized to the caption of the severity_id value. In the case of âOtherâ, it is defined by the source.
optional
severity_id: Option<i64>Severity ID
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.required
src_endpoint: Option<Box<NetworkEndpoint>>Source Endpoint
The endpoint that performed the activity on the target file.
required
start_time: Option<i64>Start Time
The start time of a time period, or the time of the least recent event included in the aggregate event.
optional
start_time_dt: Option<String>Start Time
The start time of a time period, or the time of the least recent event included in the aggregate event.
optional
status: Option<String>Status
The event status, normalized to the caption of the status_id value. In the case of âOtherâ, it is defined by the event source.
recommended
status_code: Option<String>Status Code
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.
recommended
status_detail: Option<String>Status Detail
The status detail contains additional information about the event/finding outcome.
recommended
status_id: Option<i64>Status ID
The normalized identifier of the event status.
recommended
time: Option<i64>Event Time
The normalized event occurrence time or the finding creation time.
required
time_dt: Option<String>Event Time
The normalized event occurrence time or the finding creation time.
optional
timezone_offset: Option<i64>Timezone Offset
The number of minutes that the reported event time is ahead or behind UTC, in the range -1,080 to +1,080.
recommended
tls: Option<Box<Tls>>TLS
The Transport Layer Security (TLS) attributes.
optional
traffic: Option<Box<NetworkTraffic>>Traffic
The network traffic for this observation period. Use when reporting: (1) delta values (bytes/packets transferred since the last observation), (2) instantaneous measurements at a specific point in time, or (3) standalone single-event metrics. This attribute represents a point-in-time measurement or incremental change, not a running total. For accumulated totals across multiple observations or the lifetime of a flow, use cumulative_traffic instead.
recommended
type_name: Option<String>Type Name
The event/finding type name, as defined by the type_uid.
optional
type_uid: Option<i64>Type ID
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.
required
unmapped: Option<Value>Unmapped Data
The attributes that are not mapped to the event schema. The names and values of those attributes are specific to the event source.
optional
Trait Implementations§
Source§impl Clone for NetworkFileActivity
impl Clone for NetworkFileActivity
Source§fn clone(&self) -> NetworkFileActivity
fn clone(&self) -> NetworkFileActivity
1.0.0 ¡ Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more