FireEyeNX

FireEye Network Security is an effective cyber threat protection solution that helps organizations minimize the risk of costly breaches by accurately detecting and immediately stopping advanced, targeted, and other evasive attacks hiding in internet traffic.

Network Security · FireEye Network Security (NX)

Details

IDFireEyeNX
ProviderTrellix
CategoryNetwork Security
From Version5.0.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

FireEye Network Security is an effective cyber threat protection solution that helps organizations minimize the risk of costly breaches by accurately detecting and immediately stopping advanced, targeted, and other evasive attacks hiding in internet traffic.
This integration was integrated and tested with version 2.0.0 of FireEyeNX APIs.

Configure FireEyeNX in Cortex

Parameter Description Required
url URL True
credentials Username True
request_timeout HTTP(S) Request Timeout (in seconds) False
isFetch Fetch incidents False
incidentType Incident type False
first_fetch First fetch time interval False
max_fetch Fetch Limit False
fetch_type Fetch Types False
fetch_mvx_correlated_events Fetches MVX-correlated events only. False
malware_type Alert Malware Type False
replace_alert_url Use instance URL for all the fetched alerts URL. False
fetch_artifacts Fetch artifacts for each alert. False
insecure Trust any certificate (not secure) False
proxy Use system proxy settings False

Commands

You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

fireeye-nx-get-alerts


Search and retrieve FireEye alerts based on several filters.

Base Command

fireeye-nx-get-alerts

Input

Argument Name Description Required
alert_id The ID number of the alert to retrieve. To retrieve the alert ID, execute the fireeye-nx-get-alerts command without specifying the alert_id. Optional
src_ip The source IPv4 address related to the malware alert to retrieve. Optional
dst_ip The destination IPv4 address related to the malware alert to retrieve. Optional
duration The time interval to search. This filter is used with either the start_time or end_time filter. If duration, start time, and end time are not specified, the system defaults to duration=12_hours, end_time=current_time. If only the duration is specified, the end_time defaults to the current_time. Possible values are: “1_hour”, “2_hours”, “6_hours”, “12_hours”, “24_hours”, and “48_hours”. Optional
start_time The start time of the search. This filter is used with the duration filter. If the start_time is specified but not the duration, the system defaults to duration=12_hours, starting at the specified start_time.
Formats:
YYYY-MM-dd
YYYY-MM-ddTHH:mm:ss
N days
N hours
Example:
2020-05-01
2020-05-01T00:00:00
2 days
5 hours
Optional
end_time The end time of the search. This filter is used with the duration filter. If the end_time is specified but not the duration, the system defaults to duration=12_hours, ending at the specified end_time.
Formats:
YYYY-MM-dd
YYYY-MM-ddTHH:mm:ss
N days
N hours
Example:
2020-05-01
2020-05-01T00:00:00
2 days
5 hours
Optional
file_name The name of the malware file to retrieve. Optional
file_type The malware file type to retrieve. Optional
info_level The level of information to retrieve. Possible values are: “concise”, “normal”, and “extended”. Optional
malware_name The name of the malware object to retrieve. Optional
malware_type The type of the malware object to retrieve. Possible values are: “domain_match”, “malware_callback”, “malware_object”, “web_infection”, and “infection_match”. Optional
md5 The MD5 hash of the alert to retrieve. This filter is not time dependent; it does not default to duration=12_hours. Optional
url A specific alert URL to retrieve. Optional

Context Output

Path Type Description
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Md5Sum String The md5sum of malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Sha256 String The SHA256 hash of malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Application String The application of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.HttpHeader String The HTTP header of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Original String The filename of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Name String The name of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Sid String The SID of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Type String The file type of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Stype String The STYPE of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Url String The URL of the malware associated with the alert.
FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Content String The content of the malware associated with the alert.
FireEyeNX.Alert.Explanation.CncServices.CncService.Address String The CNC service IP address associated with the alert.
FireEyeNX.Alert.Explanation.CncServices.CncService.Channel String The CNC service channel associated with the alert.
FireEyeNX.Alert.Explanation.CncServices.CncService.Port Number The CNC service port address associated with the alert.
FireEyeNX.Alert.Explanation.CncServices.CncService.Protocol String The CNC service protocol associated with the alert.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Totalmemory Number The total memory of heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Lastbytesreceived Number The last byte received in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Imagepath String The image path of the process in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Md5sum String The md5sum of the process in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Pid Number The PID of the process in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.IncrementCount Number The increment count in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Name String The name of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Bytesreceived Number The bytes received in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Lasttotalmemory Number The last total memory in heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Type String The type of heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Timestamp Number The timestamp of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.RCount Number The RCount of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.TotalSize String The total size of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.RUnit String The RUnit of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Mode String The mode of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Pattern String The pattern of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Percentage Number The entry percentage of the bytes list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Byte String The entry byte of the bytes list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Count Number The entry count of the bytes list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.FirstOffset String The entry offset of the bytes list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.IsNOP String If entry NOP appears in the bytes list in the heap spraying then yes, otherwise no.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Distinct Number The distinct number of the byte list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Count Number The number of the byte list in the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Javascript String If heap spraying has javascript then yes, otherwise no.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.DNA Number The DNA of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.TotalRCount Number The total row count of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.ProcessedRCount Number The processed row count of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processed String The processed memory of the heap spraying.
FireEyeNX.Alert.Explanation.OsChanges.Process.Fid.Ads String The FID ads of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Fid.Content Number The FID content of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.UserSid String The parent user account SID of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.SessionId Number The parent user account session ID of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.UserAccountName String The parent user account name of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.AuthenticationId String The parent user account authentication ID of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.SuperPrivilegesPresent Number If super privileges are present in this process then 1, otherwise 0.
FireEyeNX.Alert.Explanation.OsChanges.Process.Parentname String The path of the parent process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Sha256sum String The sha256sum of the parent process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Pid Number The PID of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Filesize Number File size of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Ppid Number The PPID of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Mode String The mode of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Cmdline String The path of the command associated with the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Sha1sum String The sha1sum of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.Md5sum String The md5sum of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.SrcThread String The source thread name of the process.
FireEyeNX.Alert.Explanation.osChanges.Process.Value String The value of the path in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.UserSid String The SID of the user account for the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.SessionId Number The session ID of the user account for the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.UserAccountName String The name of the user account for the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.AuthenticationId String The authentication ID of the user account for the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.SuperPrivilegesPresent Number If super privileges are present in this user account then 1, otherwise 0.
FireEyeNX.Alert.Explanation.OsChanges.Process.Timestamp Number The timestamp of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.MemoryData String The memory data of the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.LocalThreadCount Number The local thread count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileOpenCount Number The file open count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileModifyCount Number The file modify count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileCreateCount Number The file created count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.ChildProcessCount Number The file process count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileFailedCount Number The file failed count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.HttpReqCount Number The HTTP request count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.RemoteThreadCount Number The remote thread count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.MutexCreateCount Number The mutex-created count of the telemetry data in the process.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Mode String The mode of the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Imagepath String The image path of the process in the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Md5sum String The md5sum of the process in the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Pid Number The PID of the process in the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Ntstatus String The NTSTATUS of the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Suppressed Boolean If the registry key was suppressed then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Value String The value of the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Timestamp Number The timestamp of the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.SrcThread String The source thread name of the registry key.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Randomized Boolean If the registry key was randomized then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.Buffered Boolean If the registry key was buffered then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.Regkey.NoExtend Boolean If the registry key has no_extend then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.Os.Name String The name of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.Os.Arch String The architecture of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.Os.Version String The version of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.Os.Sp Number The service pack version of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Date String The monitored date of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Build Number The monitored build of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Time String The monitored time of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Version String The monitored version of the operating system.
FireEyeNX.Alert.Explanation.OsChanges.Analysis.Mode String The mode of the analysis.
FireEyeNX.Alert.Explanation.OsChanges.Analysis.Product String The product name of the analysis.
FireEyeNX.Alert.Explanation.OsChanges.Analysis.Ftype String The file type of the analysis.
FireEyeNX.Alert.Explanation.OsChanges.Analysis.Version String The version of the analysis.
FireEyeNX.Alert.Explanation.OsChanges.Network.Mode String The mode of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.ProtocolType String The protocol type of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Ipaddress String The IP address of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.DestinationPort Number The destination port address of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Imagepath String The image path of the process in the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Tainted Boolean If the process state is tainted then true, otherwise false for the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Md5sum String The md5sum of the process in the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Pid Number The PID of the process in the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.HttpRequest String The HTTP request of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Timestamp Number The timestamp of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Hostname String The hostname of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.Qtype String The QTYPE of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.AnswerNumber Number The answer number of the network.
FireEyeNX.Alert.Explanation.OsChanges.Network.DnsResponseCode Number The DNS response code of the network.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Mode String The mode of opening the file.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Ext String The extension of opening the file.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Buffered Boolean If the opened file was buffered then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.NoExtend Boolean If the opened file has no_extend then true, otherwise false.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Name String The name of the action for opening the file.
FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Timestamp Number The timestamp of opening the file.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Dllname String The DLL file name of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Apiname String The API name of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Address String The address of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Imagepath String The image path of the process in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Md5sum String The md5sum of the process in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Pid Number The PID of the process in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.SrcThread String The source thread name of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Protection String The protection number of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.SymbolName String The symbol name of the call stack entry in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.FrameNumber Number The frame number of the call stack entries in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.ModuleName String The module name of the call stack entry in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.InstructionAddress String The instruction address of the call stack entry in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.SymbolDisplacement String The symbol displacement of the call stack entry in the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Params.Param.Id Number The ID parameter of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Params.Param.Content String The path parameter of the exploit code.
FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Timestamp Number The timestamp of the exploit codes.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Mode String The mode of the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Imagepath String The image path of the process in the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Md5sum String The md5sum of the process in the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Pid Number The PID of the process in the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.SrcThread String The source thread name of the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Value String The path of the folder.
FireEyeNX.Alert.Explanation.OsChanges.Folder.Timestamp Number The timestamp of the folder.
FireEyeNX.Alert.Explanation.OsChanges.File.Mode String The mode of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Fid.Ads String The Alternate Data Stream (ADS) of the FID for the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Fid.Content Number The content of the FID in the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Imagepath String The image path of the process for the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Md5sum String The md5sum of the process for the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Pid Number The PID of the process for the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Tainted Boolean If the process state is tainted then true, otherwise false for the file.
FireEyeNX.Alert.Explanation.OsChanges.File.SrcThread String The source thread name of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Ntstatus String The NTSTATUS of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Filesize Number The size of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Value String The value of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.CreateOptions String The created option of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Timestamp Number The timestamp of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Type String The type of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Sha256sum String The sha256sum of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Sha1sum String The sha1sum of the file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.InspectionType String The inspection type of the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.TimeDateStamp String The time date stamp of the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Characteristics.Names.Name Unknown The list of characteristic names in the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Characteristics.Value String The characteristic value in the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.DllCharacteristics.Names String The characteristic name in the DLL portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.DllCharacteristics.Value String The characteristic value in the DLL portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Dll String If the portable file is a DLL file then yes, otherwise no file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Magic String The magic hex value of the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Subsystem String The subsystem of the portable executable file.
FireEyeNX.Alert.Explanation.OsChanges.File.PE.Machine String The hexadecimal address of the machine in the file.
FireEyeNX.Alert.Explanation.OsChanges.File.Md5sum String The md5sum of the file.
FireEyeNX.Alert.Explanation.OsChanges.Application.AppName String The app name of the application.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Imagepath String The image path of the queried system process.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Md5sum String The system time process info of the md5sum that is queried.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Pid Number The system time process info of the PID (process ID) that is queried
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Ntstatus String The NTSTATUS of the system time that is queried.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Timestamp Number The timestamp of the system that is queried.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.SystemTime.Value String The time value of the system that is queried.
FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.SystemTime.Time String The time of the system that is queried.
FireEyeNX.Alert.Explanation.OsChanges.EndOfReport String The end of the report.
FireEyeNX.Alert.Explanation.OsChanges.MaliciousAlert.Classtype String The class type of the malicious alert.
FireEyeNX.Alert.Explanation.OsChanges.MaliciousAlert.DisplayMsg String The display message of the malicious alert.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Hwnd String The hexadecimal address of the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Processinfo.Imagepath String The image path of the process for the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Processinfo.Pid Number The PID of the process for the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Buffered Boolean A flag indicating whether the dialog detected is buffered.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.NoExtend Boolean A flag indicating whether NoExtend is true in the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Timestamp Number The timestamp of the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.DlgId String The dialog ID of the dialog detected.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Note String A note in the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Hwnd String The hexadecimal address of the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Processinfo.Imagepath String The image path of the process for the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Processinfo.Pid Number The PID of the process for the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Buffered Boolean A flag indicating whether the dismissed dialog is buffered.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.NoExtend Boolean A flag indicating whether NoExtend is true in the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Timestamp Number The timestamp of the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.DlgId String The dialog ID of the dismissed dialog.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Imagepath String The image path of the process for the Windows Management Instrumentation (WMI) query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Md5sum String The md5sum of the process for the WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Pid Number The PID of the process for the WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Wmicontents.Wmiconent.Query String The query for the WMI content for WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Wmicontents.Wmicontent.Lang String Language of the WMI content for the WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Timestamp Number The timestamp of the WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Buffered Boolean A flag indicating whether the WMI query is buffered.
FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.NoExtend Boolean A flag indicating whether NoExtend is true in the WMI query.
FireEyeNX.Alert.Explanation.OsChanges.Uac.Mode String The mode of the User Account Control (UAC).
FireEyeNX.Alert.Explanation.OsChanges.Uac.Value String The value of the User Account Control.
FireEyeNX.Alert.Explanation.OsChanges.Uac.Timestamp Number The timestamp of the User Account Control.
FireEyeNX.Alert.Explanation.OsChanges.Uac.Status String The status of the User Account Control.
FireEyeNX.Alert.Explanation.StaticAnalysis.Static.Value String The value of the static analysis.
FireEyeNX.Alert.Explanation.StolenData.Info.Field Unknown The information field of the stolen data.
FireEyeNX.Alert.Explanation.StolenData.Info.Type String The information type of the stolen data.
FireEyeNX.Alert.Explanation.StolenData.EventId Number The event ID of the stolen data.
FireEyeNX.Alert.Src.Ip String The source IP address of the alert.
FireEyeNX.Alert.Src.Mac String The source MAC address of the alert.
FireEyeNX.Alert.Src.Port Number The source port address of the alert.
FireEyeNX.Alert.Src.Host String The source host of the alert.
FireEyeNX.Alert.AlertUrl String The alert URL.
FireEyeNX.Alert.Action String The action of the alert.
FireEyeNX.Alert.Occurred String The time when the alert occurred.
FireEyeNX.Alert.AttackTime String The time when an attack occurred.
FireEyeNX.Alert.Dst.Mac String The destination MAC address of the alert.
FireEyeNX.Alert.Dst.Port Number The destination port address of the alert.
FireEyeNX.Alert.Dst.Ip String The destination IP address of the alert.
FireEyeNX.Alert.ApplianceId String The appliance ID of the alert.
FireEyeNX.Alert.Id Number The ID of the alert.
FireEyeNX.Alert.Name String The type of the alert.
FireEyeNX.Alert.Severity String The severity of the alert.
FireEyeNX.Alert.Uuid String The universally unique identifier (UUID) of the alert.
FireEyeNX.Alert.Ack String A flag indicating whether an acknowledgment is received.
FireEyeNX.Alert.Product String The product name of the alert.
FireEyeNX.Alert.Vlan Number The virtual LAN (VLAN) of the alert.
FireEyeNX.Alert.Malicious String A flag indicating whether the alert is malicious.
FireEyeNX.Alert.ScVersion String The SC version of the alert.

Command Example


#### Context Example

{
“FireEyeNX”: {
“Alert”: [
{
“Ack”: “no”,
“Action”: “notified”,
“AlertUrl”: “https://fireeye-941918/event_stream/events_for_bot?ev_id=11364”,
“ApplianceId”: “866ED7558A08”,
“AttackTime”: “2020-09-29 18:30:01 +0000”,
“Dst”: {
“Mac”: “xx:xx:xx:xx:xx:xx”,
“Ip”: “1.1.1.1”,
“Port”: 0
},
“Explanation”: {
“MalwareDetected”: {
“Malware”: [
{
“Name”: “dummy malware name 1”
}
]
}
},
“Id”: 1,
“Malicious”: “yes”,
“Name”: “dummy name 1”,
“Occurred”: “0000-00-00 02:12:53 +0000”,
“Product”: “WEB_MPS”,
“ScVersion”: “1.000”,
“Severity”: “MINR”,
“Src”: {
“Ip”: “1.1.1.1”,
“Port”: 0,
“Mac”: “xx:xx:xx:xx:xx:xx”
},
“Uuid”: “0b0b0b0b0-0b0b0b-0b0b-0b0b-0b0b0b0b0b”,
“Vlan”: 0
},
{
“Ack”: “no”,
“Action”: “notified”,
“AlertUrl”: “https://fireeye-941918/event_stream/events_for_bot?ev_id=11365”,
“ApplianceId”: “866ED7558A08”,
“AttackTime”: “2020-09-29 19:00:01 +0000”,
“Dst”: {
“Mac”: “xx:xx:xx:xx:xx:xx”,
“Ip”: “1.1.1.1”,
“Port”: 0
},
“Explanation”: {
“MalwareDetected”: {
“Malware”: [
{
“Name”: “dummy malware name 2”
}
]
}
},
“Id”: 2,
“Malicious”: “yes”,
“Name”: “dummy name 2”,
“Occurred”: “0000-00-00 02:12:53 +0000”,
“Product”: “WEB_MPS”,
“ScVersion”: “1.000”,
“Severity”: “MINR”,
“Src”: {
“Ip”: “1.1.1.1”,
“Port”: 0,
“Mac”: “xx:xx:xx:xx:xx:xx”
},
“Uuid”: “0a0a0a0a0-0a0a0a-0a0a-0a0a-0a0a0a0a0a”,
“Vlan”: 0
}
]
}
}


#### Human Readable Output

>### Alert(s) Information
>
>|ID|Distinguisher(UUID)|Malware Name|Alert Type|Victim IP|Time (UTC)|Severity|Malicious|SC Version|Victim Port|Victim MAC Address|Target IP|Target Port|Target MAC Address|
>|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
>| 1 | 0b0b0b0b0-0b0b0b-0b0b-0b0b-0b0b0b0b0b | dummy malware name 1 | dummy name 1 | 1.1.1.1 | 0000-00-00 02:12:53 +0000 | MINR | yes | 1.000 | 0 | xx:xx:xx:xx:xx:xx | 1.1.1.1 | 0 | xx:xx:xx:xx:xx:xx |
>| 2 | 0a0a0a0a0-0a0a0a-0a0a-0a0a-0a0a0a0a0a | dummy malware name 2 | dummy name 2 | 1.1.1.1 | 0000-00-00 02:12:53 +0000 | MINR | yes | 1.000 | 0 | xx:xx:xx:xx:xx:xx | 1.1.1.1 | 0 | xx:xx:xx:xx:xx:xx |

### fireeye-nx-get-artifacts-metadata-by-alert

***
Gets malware artifacts metadata for the specified UUID.

#### Base Command

`fireeye-nx-get-artifacts-metadata-by-alert`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| uuid | Universally unique ID (UUID) of the alert. To retrieve the UUID, execute the fireeye-nx-get-alerts command. | Required |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| FireEyeNX.Alert.Uuid | String | Universally unique ID \(UUID\) of the alert. |
| FireEyeNX.Alert.ArtifactsMetadata.ArtifactType | String | The artifact type. |
| FireEyeNX.Alert.ArtifactsMetadata.ArtifactName | String | The artifact name. |
| FireEyeNX.Alert.ArtifactsMetadata.ArtifactSize | String | The artifact size. |

#### Command Example

```!fireeye-nx-get-artifacts-metadata-by-alert uuid=0b0b0b0b-0b0b-0b0b-0b0b-0b0b0b0b0b0b```

#### Context Example

{
“FireEyeNX”: {
“Alert”: {
“ArtifactsMetadata”: [
{
“ArtifactType”: “artifact type test 1”,
“ArtifactName”: “artifact name test 1”,
“ArtifactSize”: “1010”
},
{
“ArtifactType”: “artifact type test 2”,
“ArtifactName”: “artifact name test 2”,
“ArtifactSize”: “1010”
}
],
“Uuid”: “0b0b0b0b-0b0b-0b0b-0b0b-0b0b0b0b0b0b”
}
}
}


#### Human Readable Output

>### Artifacts Metadata
>
>|Artifact Type|Artifact Name|Artifact Size (Bytes)|
>|---|---|---|
>| artifact type test 1 | artifact name test 1 | 1010 |
>| artifact type test 2 | artifact name test 2 | 1010 |

### fireeye-nx-get-artifacts-by-alert

***
Downloads malware artifacts data for the specified UUID as a zip file.

#### Base Command

`fireeye-nx-get-artifacts-by-alert`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| uuid | The universally unique ID (UUID) of the alert. To get the UUID, execute the fireeye-nx-get-alerts command. | Required |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| File.Size | Number | The size of the file. |
| File.SHA1 | String | The SHA1 hash of the file. |
| File.SHA256 | String | The SHA256 hash of the file. |
| File.Name | String | The name of the file. |
| File.SSDeep | String | The SSDeep hash of the file. |
| File.EntryID | String | The entry ID of the file. |
| File.Info | String | The file information. |
| File.Type | String | The file type. |
| File.MD5 | String | The MD5 hash of the file. |
| File.Extension | String | The file extension. |

#### Command Example

```!fireeye-nx-get-artifacts-by-alert uuid=0b0b0b0b-0b0b-0b0b-0b0b-0b0b0b0b0b0b```

#### Context Example

{
“File”: {
“Size”: 17277,
“SHA1”: “574352bb238d3379429063d71990c0000000000”,
“SHA256”: “1f8ac8eaba9abaf9d12b9b82180a110eab15b14aeec14715f48b4dedaaaaaaaaa”,
“Name”: “0b0b0b0b-0b0b-0b0b-0b0b-0b0b0b0b0b0b.zip”,
“SSDeep”: “000:aaaaaa/aAaAaAaA+AaAaAaAaA:aa0/aAaAaAaAaAaAaA”,
“EntryID”: “150@1”,
“Info”: “zip”,
“Type”: “Zip archive data, at least v1.0 to extract”,
“MD5”: “1aA1aA1aA1aA1aA1aA1aA1aA”,
“Extension”: “zip”
}
}


### fireeye-nx-get-reports

***
Returns reports on selected alerts by specifying a time_frame value or a start_time and end_time of the search range.

#### Base Command

`fireeye-nx-get-reports`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| report_type | The type of report to be queried. | Required |
| type | The output format of the report. Possible values are: "csv" and "pdf", or both depending upon the report type. | Optional |
| start_time | The start time of the search. The search occurs between the start and end times. When specifying a start_time value, you must specify both a start_time and an end_ time value.<br/> Formats:<br/>YYYY-MM-dd<br/>YYYY-MM-ddTHH:mm:ss<br/>N days <br/>N hours<br/>Example:<br/> 2020-05-01 <br/> 2020-05-01T00:00:00 <br/> 2 days <br/> 5 hours. | Optional |
| end_time | The end time of the search. The search occurs between the start and end times. When specifying an end_time value, you must specify both a start_time and an end_time value.<br/> Formats:<br/>YYYY-MM-dd<br/>YYYY-MM-ddTHH:mm:ss<br/>N days <br/>N hours<br/>Example:<br/> 2020-05-01 <br/> 2020-05-01T00:00:00 <br/> 2 days <br/> 5 hours. | Optional |
| time_frame | The time frame in which reports are searched. | Optional |
| limit | The maximum number (N) of items covered by each IPS Top N report. This argument is required only for IPS Top N reports. Possible values are: "25", "50", "75", and "100". | Optional |
| interface | The internet interface. Possible values are: "A", "B", "C", "D", "AB", and "All". This option is required only for IPS reports. | Optional |
| infection_id | The alert ID. To retrieve the alert ID, execute the fireeye-nx-get-alerts command. Use the combination of infection_id and infection_type arguments to specify a unique alert to describe in the Alert Details Report. If one option is used alone and does not specify a unique alert, an error message is produced. | Optional |
| infection_type | The type of the infection. Use the combination of infection_id and infection_type arguments to specify a unique alert to describe in the Alert Details Report. If one option is used alone and does not specify a unique alert, an error message is produced. Possible values are: "malware-object", "malware-callback", "infection-match", "domain-match", and "web-infection". | Optional |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| InfoFile.Name | String | The file name. |
| InfoFile.EntryID | String | The ID for locating the file in the War Room. |
| InfoFile.Size | Number | The size of the file \(in bytes\). |
| InfoFile.Type | String | The file type, as determined by libmagic \(same as displayed in the file entries\). |
| InfoFile.Extension | String | The file extension. |
| InfoFile.Info | String | Basic information about the file. |

#### Command Example

```!fireeye-nx-get-reports report_type="IPS Executive Summary Report" type=csv time_frame=between start_time=2020-01-29T23:59:59 end_time=2020-08-29T23:59:59```

#### Context Example

{
“InfoFile”: {
“EntryID”: “1052@8db8b36d-df26-4a3a-8f8a-40e45629ff54”,
“Extension”: “csv”,
“Info”: “csv”,
“Name”: “ips_executive_summary_report_fireeye_20200709_151727878642.csv”,
“Size”: 606,
“Type”: “ASCII text”
}
}


### fireeye-nx-get-events

***
Search and retrieve FireEye events based on several filters.

#### Base Command

`fireeye-nx-get-events`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| duration | The time interval to search. This filter is used with the end_time filter. If the duration is not specified, the system defaults to duration=12_hours, end_time=current_time. | Optional |
| start_time | The start time of the search. This filter is used with the duration filter. If the start_time is specified but not the duration, the system defaults to duration=12_hours, starting at the specified start_time.<br/>Formats:<br/>YYYY-MM-dd<br/>YYYY-MM-ddTHH:mm:ss<br/>N days <br/>N hours<br/>Example:<br/> 2020-05-01 <br/> 2020-05-01T00:00:00 <br/> 2 days <br/> 5 hours | Optional |
| end_time | The end time of the search. This filter is used with the duration filter. If the end_time is specified but not the duration, the system defaults to duration=12_hours, ending at the specified end_time. <br/>Formats:<br/>YYYY-MM-dd<br/>YYYY-MM-ddTHH:mm:ss<br/>N days <br/>N hours<br/>Example:<br/> 2020-05-01 <br/> 2020-05-01T00:00:00 <br/> 2 days <br/> 5 hours | Optional |
| mvx_correlated_only | Whether to include all IPS events or MVX-correlated events only. Default: false | Optional |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| FireEyeNX.Event.EventId | Number | The ID of the event. |
| FireEyeNX.Event.Occurred | String | The date and time when the event occurred. |
| FireEyeNX.Event.SrcIp | String | The IP address of the victim. |
| FireEyeNX.Event.SrcPort | Number | The port number of the victim. |
| FireEyeNX.Event.DstIp | String | The IP address of the attacker. |
| FireEyeNX.Event.DstPort | Number | The port number of the attacker. |
| FireEyeNX.Event.Severity | Number | The severity level of the event. |
| FireEyeNX.Event.SignatureRev | Number | The signature revision number of the event. |
| FireEyeNX.Event.SignatureIden | Number | The signature identity number of the event. |
| FireEyeNX.Event.SignatureMatchCnt | Number | The signature match count number of the event. |
| FireEyeNX.Event.Vlan | Number | The virtual LAN \(VLAN\) of the event. |
| FireEyeNX.Event.VmVerified | Boolean | Whether the event VM was verified. |
| FireEyeNX.Event.SrcMac | String | The MAC address of the source machine. |
| FireEyeNX.Event.DstMac | String | The MAC address of the destination machine. |
| FireEyeNX.Event.RuleName | String | The rule name for the event. |
| FireEyeNX.Event.SensorId | String | The sensor ID of the FireEye machine. |
| FireEyeNX.Event.CveId | String | The CVE ID found in the event. |
| FireEyeNX.Event.ActionTaken | Number | The IPS blocking action taken on the event. |
| FireEyeNX.Event.AttackMode | String | The attack mode mentioned in the event. |
| FireEyeNX.Event.InterfaceId | Number | The interface ID of the event. |
| FireEyeNX.Event.Protocol | Number | The protocol used in the event. |
| FireEyeNX.Event.IncidentId | Number | The incident ID of the event on FireEye. |

#### Command Example

```!fireeye-nx-get-events duration=48_hours end_time=2020-08-10T06:31:00```

#### Context Example

{
“FireEyeNX”: {
“Event”: [
{
“EventId”:1,
“Occurred”:”2020-08-10T06:31:00Z”,
“SrcIp”:”1.1.1.1”,
“SrcPort”:1,
“DstIp”:”1.1.1.1”,
“DstPort”:1,
“Vlan”:0,
“SignatureMatchCnt”:1,
“SignatureIden”:1,
“SignatureRev”:1,
“Severity”:1,
“VmVerified”:true,
“SrcMac”:”dummy”,
“DstMac”:”dummy”,
“RuleName”:”dummy”,
“SensorId”:”dummy”,
“CveId”:”CVE-123”,
“ActionTaken”:1,
“AttackMode”:”dummy”,
“InterfaceId”:1,
“Protocol”:1,
“IncidentId”:1
}
]
}
}
```

Human Readable Output

IPS Events

Event ID Time (UTC) Victim IP Attacker IP CVE ID Severity Rule Protocol
1 2020-08-10T06:31:00Z 1.1.1.1 1.1.1.1 CVE-123 1 dummy 1

Configuration parameters

  • url — URL (required)
  • credentials — Username (required)
  • request_timeout — HTTP(S) Request Timeout (in seconds)
  • isFetch — Fetch incidents
  • incidentType — Incident type
  • incidentFetchInterval — Incidents Fetch Interval
  • first_fetch — First fetch time interval
  • max_fetch — Fetch Limit
  • fetch_type — Fetch Types
  • fetch_mvx_correlated_events — Fetches MVX-correlated events only
  • malware_type — Alert Malware Type
  • replace_alert_url — Use instance URL for all the fetched alerts URL.
  • fetch_artifacts — Fetch artifacts for each alert
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings

Commands (5)

  • fireeye-nx-get-alerts

    Search and retrieve FireEye alerts based on several filters.

  • fireeye-nx-get-artifacts-by-alert

    Downloads malware artifacts data for the specified UUID as a zip file.

  • fireeye-nx-get-artifacts-metadata-by-alert

    Gets malware artifacts metadata for the specified UUID.

  • fireeye-nx-get-events

    Search and retrieve FireEye events based on several filters.

  • fireeye-nx-get-reports

    Returns reports on selected alerts by specifying a time_frame value or a start_time and end_time of the search range.

category: Network Security
provider: Trellix
sectionorder:
- Connect
- Collect
commonfields:
  id: FireEyeNX
  version: -1
configuration:
- additionalinfo: URL to connect to the FireEye NX.
  display: URL
  name: url
  required: true
  type: 0
  section: Connect
- display: Username
  name: credentials
  required: true
  type: 9
  section: Connect
- additionalinfo: The FireEye NX API calls timeout if the response is not returned within the configured time interval. Default is 120 seconds.
  defaultvalue: '120'
  display: HTTP(S) Request Timeout (in seconds)
  name: request_timeout
  type: 0
  section: Connect
  advanced: true
  required: false
- display: Fetch incidents
  name: isFetch
  type: 8
  section: Collect
  required: false
- display: Incident type
  name: incidentType
  type: 13
  section: Connect
  required: false
- display: Incidents Fetch Interval
  name: incidentFetchInterval
  defaultvalue: '1'
  required: false
  type: 19
  section: Collect
  advanced: true
- additionalinfo: The time range to consider for the initial data fetch.(<number> <unit>, e.g., 1 hour, 2 hours, 6 hours, 12 hours, 48 hours). Default is 12 hours. The API supports up to 48 hours. More than 48 hours will produce an error.
  defaultvalue: 12 hours
  display: First fetch time interval
  name: first_fetch
  type: 0
  section: Collect
  required: false
- additionalinfo: The maximum number of alerts to fetch. A maximum of 200 alerts is fetched. Default is 50.
  defaultvalue: '50'
  display: Fetch Limit
  name: max_fetch
  type: 0
  section: Collect
  required: false
- additionalinfo: Fetches Alerts and/or IPS Events.
  display: Fetch Types
  name: fetch_type
  options:
  - Alerts
  - IPS Events
  type: 16
  section: Collect
  required: false
- additionalinfo: Fetches MVX-correlated events only. Works only for events defined in Fetch Types.
  display: Fetches MVX-correlated events only
  name: fetch_mvx_correlated_events
  type: 8
  section: Collect
  required: false
- additionalinfo: The type of malware object to fetch alerts.
  display: Alert Malware Type
  name: malware_type
  options:
  - domain_match
  - malware_callback
  - malware_object
  - web_infection
  - infection_match
  type: 15
  section: Collect
  required: false
- additionalinfo: Replaces the domain of the alert URL key to the instance URL for fetch incident and command.
  display: Use instance URL for all the fetched alerts URL.
  name: replace_alert_url
  type: 8
  section: Collect
  required: false
- display: Fetch artifacts for each alert
  name: fetch_artifacts
  type: 8
  section: Collect
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  section: Connect
  advanced: true
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  section: Connect
  advanced: true
  required: false
description: FireEye Network Security is an effective cyber threat protection solution that helps organizations minimize the risk of costly breaches by accurately detecting and immediately stopping advanced, targeted, and other evasive attacks hiding in internet traffic.
display: FireEye NX
name: FireEyeNX
script:
  commands:
  - arguments:
    - description: 'Universally unique ID (UUID) of the alert. To retrieve the UUID, execute the fireeye-nx-get-alerts command.'
      name: uuid
      required: true
    description: Gets malware artifacts metadata for the specified UUID.
    name: fireeye-nx-get-artifacts-metadata-by-alert
    outputs:
    - contextPath: FireEyeNX.Alert.Uuid
      description: Universally unique ID (UUID) of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.ArtifactsMetadata.ArtifactType
      description: The artifact type.
      type: String
    - contextPath: FireEyeNX.Alert.ArtifactsMetadata.ArtifactName
      description: The artifact name.
      type: String
    - contextPath: FireEyeNX.Alert.ArtifactsMetadata.ArtifactSize
      description: The artifact size.
      type: String
  - arguments:
    - auto: PREDEFINED
      description: The type of report to be queried.
      name: report_type
      predefined:
      - Website Callback Server Report
      - Website Executive Summary
      - Website Infected Host Trends
      - Website Malware Activity
      - Website Antivirus Report
      - IPS Executive Summary Report
      - IPS Top N Attacks Report
      - IPS Top N Attackers Report
      - IPS Top N Victims Report
      - IPS Top N MVX-Correlated Report
      - Alert Details Report
      required: true
    - auto: PREDEFINED
      description: 'The output format of the report. Possible values are: "csv" and "pdf", or both depending upon the report type.'
      name: type
      predefined:
      - pdf
      - csv
    - description: 'The start time of the search. The search occurs between the start and end times. When specifying a\ \ start_time value, you must specify both a start_time and an end_ time value.\n\ Formats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours.'
      name: start_time
    - description: 'The end time of the search. The search occurs between the start and end times. When specifying an\ \ end_ time value, you must specify both a start_time and an end_time value.\n\ Formats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours.'
      name: end_time
    - auto: PREDEFINED
      description: The time frame in which reports are searched.
      name: time_frame
      predefined:
      - pastWeek
      - pastMonth
      - pastThreeMonth
      - between
      - today
      - oneDayAgo
      - twoDaysAgo
      - threeDaysAgo
      - fourDaysAgo
      - fiveDaysAgo
      - sixDaysAgo
      - pastHour
      - pastDay
    - auto: PREDEFINED
      description: 'The maximum number (N) of items covered by each IPS Top N report. This argument is required only for IPS Top N reports. Possible values are: "25", "50", "75", and "100".'
      name: limit
      predefined:
      - '25'
      - '50'
      - '75'
      - '100'
    - auto: PREDEFINED
      description: 'The internet interface. Possible values are: "A", "B", "C", "D", "AB", and "All". This option is required only for IPS reports.'
      name: interface
      predefined:
      - A
      - B
      - C
      - D
      - AB
      - All
    - description: The alert ID. To retrieve the alert ID, execute the fireeye-nx-get-alerts command. Use the combination of infection_id and infection_type arguments to specify a unique alert to describe in the Alert Details Report. If one option is used alone and does not specify a unique alert, an error message is produced.
      name: infection_id
    - auto: PREDEFINED
      description: 'The type of the infection. Use the combination of infection_id and infection_type arguments to specify a unique alert to describe in the Alert Details Report. If one option is used alone and does not specify a unique alert, an error message is produced. Possible values are: "malware-object", "malware-callback", "infection-match", "domain-match", and "web-infection".'
      name: infection_type
      predefined:
      - malware-object
      - malware-callback
      - infection-match
      - domain-match
      - web-infection
    description: Returns reports on selected alerts by specifying a time_frame value or a start_time and end_time of the search range.
    name: fireeye-nx-get-reports
    outputs:
    - contextPath: InfoFile.Name
      description: The file name.
      type: String
    - contextPath: InfoFile.EntryID
      description: The ID for locating the file in the War Room.
      type: String
    - contextPath: InfoFile.Size
      description: The size of the file (in bytes).
      type: Number
    - contextPath: InfoFile.Type
      description: The file type, as determined by libmagic (same as displayed in the file entries).
      type: String
    - contextPath: InfoFile.Extension
      description: The file extension.
      type: String
    - contextPath: InfoFile.Info
      description: Basic information about the file.
      type: String
  - arguments:
    - description: The ID number of the alert to retrieve. To retrieve the alert ID, execute the fireeye-nx-get-alerts command without specifying the alert_id.
      name: alert_id
    - description: The source IPv4 address related to the malware alert to retrieve.
      name: src_ip
    - description: The destination IPv4 address related to the malware alert to retrieve.
      name: dst_ip
    - auto: PREDEFINED
      description: 'The time interval to search. This filter is used with either the start_time or end_time filter. If duration, start time, and end time are not specified, the system defaults to duration=12_hours, end_time=current_time. If only the duration is specified, the end_time defaults to the current_time. Possible values are: "1_hour", "2_hours", "6_hours", "12_hours", "24_hours", and "48_hours".'
      name: duration
      predefined:
      - 1_hour
      - 2_hours
      - 6_hours
      - 12_hours
      - 24_hours
      - 48_hours
    - description: "The start time of the search. This filter is used with the duration filter. If the start_time is specified but not the duration, the system defaults to duration=12_hours, starting at the specified start_time.\nFormats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours."
      name: start_time
    - description: "The end time of the search. This filter is used with the duration filter. If the end_time is specified but not the duration, the system defaults to duration=12_hours, ending at the specified end_time.\nFormats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours."
      name: end_time
    - description: The name of the malware file to retrieve.
      name: file_name
    - description: The malware file type to retrieve.
      name: file_type
    - auto: PREDEFINED
      defaultValue: concise
      description: 'The level of information to retrieve. Possible values are: "concise", "normal", and "extended".'
      name: info_level
      predefined:
      - concise
      - normal
      - extended
    - description: The name of the malware object to retrieve.
      name: malware_name
    - auto: PREDEFINED
      description: 'The type of the malware object to retrieve. Possible values are: "domain_match", "malware_callback", "malware_object", "web_infection", and "infection_match".'
      name: malware_type
      predefined:
      - domain_match
      - malware_callback
      - malware_object
      - web_infection
      - infection_match
    - description: The MD5 hash of the alert to retrieve. This filter is not time dependent; it does not default to duration=12_hours.
      name: md5
    - description: A specific alert URL to retrieve.
      name: url
    description: Search and retrieve FireEye alerts based on several filters.
    name: fireeye-nx-get-alerts
    outputs:
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Md5Sum
      description: The md5sum of malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Sha256
      description: The SHA256 hash of malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Application
      description: The application of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.HttpHeader
      description: The HTTP header of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Original
      description: The filename of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Name
      description: The name of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Sid
      description: The SID of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Type
      description: The file type of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Stype
      description: The STYPE of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Url
      description: The URL of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.MalwareDetected.Malware.Content
      description: The content of the malware associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.CncServices.CncService.Address
      description: The CNC service IP address associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.CncServices.CncService.Channel
      description: The CNC service channel associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.CncServices.CncService.Port
      description: The CNC service port address associated with the alert.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.CncServices.CncService.Protocol
      description: The CNC service protocol associated with the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Totalmemory
      description: The total memory of heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Lastbytesreceived
      description: The last byte received in heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Imagepath
      description: The image path of the process in heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Md5sum
      description: The md5sum of the process in heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processinfo.Pid
      description: The PID of the process in heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.IncrementCount
      description: The increment count in heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Name
      description: The name of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Bytesreceived
      description: The bytes received in heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Lasttotalmemory
      description: The last total memory in heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Type
      description: The type of heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Timestamp
      description: The timestamp of the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.RCount
      description: The RCount of the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.TotalSize
      description: The total size of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.RUnit
      description: The RUnit of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Mode
      description: The mode of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Pattern
      description: The pattern of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Percentage
      description: The entry percentage of the bytes list in the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Byte
      description: The entry byte of the bytes list in the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.Count
      description: The entry count of the bytes list in the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.FirstOffset
      description: The entry offset of the bytes list in the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Entry.IsNOP
      description: If entry NOP appears in the bytes list in the heap spraying then yes, otherwise no.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Distinct
      description: The distinct number of the byte list in the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.BytesList.Count
      description: The number of the byte list in the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Javascript
      description: If heap spraying has javascript then yes, otherwise no.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.DNA
      description: The DNA of the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.TotalRCount
      description: The total row count of the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.ProcessedRCount
      description: The processed row count of the heap spraying.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Heapspraying.Processed
      description: The processed memory of the heap spraying.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Fid.Ads
      description: The FID ads of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Fid.Content
      description: The FID content of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.UserSid
      description: The parent user account SID of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.SessionId
      description: The parent user account session ID of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.UserAccountName
      description: The parent user account name of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.AuthenticationId
      description: The parent user account authentication ID of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.ParentUserAccount.SuperPrivilegesPresent
      description: If super privileges are present in this process then 1, otherwise 0.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Parentname
      description: The path of the parent process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Sha256sum
      description: The sha256sum of the parent process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Pid
      description: The PID of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Filesize
      description: File size of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Ppid
      description: The PPID of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Mode
      description: The mode of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Cmdline
      description: The path of the command associated with the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Sha1sum
      description: The sha1sum of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Md5sum
      description: The md5sum of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.SrcThread
      description: The source thread name of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.osChanges.Process.Value
      description: The value of the path in the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.UserSid
      description: The SID of the user account for the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.SessionId
      description: The session ID of the user account for the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.UserAccountName
      description: The name of the user account for the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.AuthenticationId
      description: The authentication ID of the user account for the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.UserAccount.SuperPrivilegesPresent
      description: If super privileges are present in this user account then 1, otherwise 0.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.Timestamp
      description: The timestamp of the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.MemoryData
      description: The memory data of the process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.LocalThreadCount
      description: The local thread count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileOpenCount
      description: The file open count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileModifyCount
      description: The file modify count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileCreateCount
      description: The file created count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.ChildProcessCount
      description: The file process count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.FileFailedCount
      description: The file failed count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.HttpReqCount
      description: The HTTP request count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.RemoteThreadCount
      description: The remote thread count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Process.TelemetryData.MutexCreateCount
      description: The mutex-created count of the telemetry data in the process.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Mode
      description: The mode of the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Imagepath
      description: The image path of the process in the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Md5sum
      description: The md5sum of the process in the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Processinfo.Pid
      description: The PID of the process in the registry key.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Ntstatus
      description: The NTSTATUS of the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Suppressed
      description: If the registry key was suppressed then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Value
      description: The value of the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Timestamp
      description: The timestamp of the registry key.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.SrcThread
      description: The source thread name of the registry key.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Randomized
      description: If the registry key was randomized then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.Buffered
      description: If the registry key was buffered then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Regkey.NoExtend
      description: If the registry key has no_extend then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Os.Name
      description: The name of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Os.Arch
      description: The architecture of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Os.Version
      description: The version of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Os.Sp
      description: The service pack version of the operating system.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Date
      description: The monitored date of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Build
      description: The monitored build of the operating system.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Time
      description: The monitored time of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.OsMonitor.Version
      description: The monitored version of the operating system.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Analysis.Mode
      description: The mode of the analysis.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Analysis.Product
      description: The product name of the analysis.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Analysis.Ftype
      description: The file type of the analysis.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Analysis.Version
      description: The version of the analysis.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Mode
      description: The mode of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.ProtocolType
      description: The protocol type of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Ipaddress
      description: The IP address of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.DestinationPort
      description: The destination port address of the network.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Imagepath
      description: The image path of the process in the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Tainted
      description: If the process state is tainted then true, otherwise false for the network.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Md5sum
      description: The md5sum of the process in the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Processinfo.Pid
      description: The PID of the process in the network.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.HttpRequest
      description: The HTTP request of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Timestamp
      description: The timestamp of the network.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Hostname
      description: The hostname of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.Qtype
      description: The QTYPE of the network.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.AnswerNumber
      description: The answer number of the network.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Network.DnsResponseCode
      description: The DNS response code of the network.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Mode
      description: The mode of opening the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Ext
      description: The extension of opening the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Buffered
      description: If the opened file was buffered then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.NoExtend
      description: If the opened file has no_extend then true, otherwise false.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Name
      description: The name of the action for opening the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.ActionFopen.Timestamp
      description: The timestamp of opening the file.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Dllname
      description: The DLL file name of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Apiname
      description: The API name of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Address
      description: The address of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Imagepath
      description: The image path of the process in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Md5sum
      description: The md5sum of the process in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Processinfo.Pid
      description: The PID of the process in the exploit code.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.SrcThread
      description: The source thread name of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Protection
      description: The protection number of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.SymbolName
      description: The symbol name of the call stack entry in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.FrameNumber
      description: The frame number of the call stack entries in the exploit code.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.ModuleName
      description: The module name of the call stack entry in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.InstructionAddress
      description: The instruction address of the call stack entry in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Callstack.CallstackEntry.SymbolDisplacement
      description: The symbol displacement of the call stack entry in the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Params.Param.Id
      description: The ID parameter of the exploit code.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Params.Param.Content
      description: The path parameter of the exploit code.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Exploitcode.Timestamp
      description: The timestamp of the exploit codes.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Mode
      description: The mode of the folder.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Imagepath
      description: The image path of the process in the folder.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Md5sum
      description: The md5sum of the process in the folder.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Processinfo.Pid
      description: The PID of the process in the folder.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.SrcThread
      description: The source thread name of the folder.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Value
      description: The path of the folder.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Folder.Timestamp
      description: The timestamp of the folder.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Mode
      description: The mode of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Fid.Ads
      description: The Alternate Data Stream (ADS) of the FID for the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Fid.Content
      description: The content of the FID in the file.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Imagepath
      description: The image path of the process for the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Md5sum
      description: The md5sum of the process for the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Pid
      description: The PID of the process for the file.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Processinfo.Tainted
      description: If the process state is tainted then true, otherwise false for the file.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.SrcThread
      description: The source thread name of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Ntstatus
      description: The NTSTATUS of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Filesize
      description: The size of the file.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Value
      description: The value of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.CreateOptions
      description: The created option of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Timestamp
      description: The timestamp of the file.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Type
      description: The type of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Sha256sum
      description: The sha256sum of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Sha1sum
      description: The sha1sum of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.InspectionType
      description: The inspection type of the portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.TimeDateStamp
      description: The time date stamp of the portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Characteristics.Names.Name
      description: The list of characteristic names in the portable executable file.
      type: Unknown
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Characteristics.Value
      description: The characteristic value in the portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.DllCharacteristics.Names
      description: The characteristic name in the DLL portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.DllCharacteristics.Value
      description: The characteristic value in the DLL portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Dll
      description: If the portable file is a DLL file then yes, otherwise no file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Magic
      description: The magic hex value of the portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Subsystem
      description: The subsystem of the portable executable file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.PE.Machine
      description: The hexadecimal address of the machine in the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.File.Md5sum
      description: The md5sum of the file.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Application.AppName
      description: The app name of the application.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Imagepath
      description: The image path of the queried system process.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Md5sum
      description: The system time process info of the md5sum that is queried.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Processinfo.Pid
      description: The system time process info of the PID (process ID) that is queried.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Ntstatus
      description: The NTSTATUS of the system time that is queried.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.Timestamp
      description: The timestamp of the system that is queried.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.SystemTime.Value
      description: The time value of the system that is queried.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.QuerySystemTime.SystemTime.Time
      description: The time of the system that is queried.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.EndOfReport
      description: The end of the report.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.MaliciousAlert.Classtype
      description: The class type of the malicious alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.MaliciousAlert.DisplayMsg
      description: The display message of the malicious alert.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Hwnd
      description: The hexadecimal address of the dialog detected.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Processinfo.Imagepath
      description: The image path of the process for the dialog detected.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Processinfo.Pid
      description: The PID of the process for the dialog detected.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Buffered
      description: A flag indicating whether the dialog detected is buffered.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.NoExtend
      description: A flag indicating whether NoExtend is true in the dialog detected.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.Timestamp
      description: The timestamp of the dialog detected.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDetected.DlgId
      description: The dialog ID of the dialog detected.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Note
      description: A note in the dismissed dialog.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Hwnd
      description: The hexadecimal address of the dismissed dialog.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Processinfo.Imagepath
      description: The image path of the process for the dismissed dialog.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Processinfo.Pid
      description: The PID of the process for the dismissed dialog.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Buffered
      description: A flag indicating whether the dismissed dialog is buffered.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.NoExtend
      description: A flag indicating whether NoExtend is true in the dismissed dialog.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.Timestamp
      description: The timestamp of the dismissed dialog.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.DialogDismissed.DlgId
      description: The dialog ID of the dismissed dialog.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Imagepath
      description: The image path of the process for the Windows Management Instrumentation (WMI) query.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Md5sum
      description: The md5sum of the process for the WMI query.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Processinfo.Pid
      description: The PID of the process for the WMI query.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Wmicontents.Wmiconent.Query
      description: The query for the WMI content for WMI query.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Wmicontents.Wmicontent.Lang
      description: Language of the WMI content for the WMI query.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Timestamp
      description: The timestamp of the WMI query.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.Buffered
      description: A flag indicating whether the WMI query is buffered.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Wmiquery.NoExtend
      description: A flag indicating whether NoExtend is true in the WMI query.
      type: Boolean
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Uac.Mode
      description: The mode of the User Account Control (UAC).
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Uac.Value
      description: The value of the User Account Control.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Uac.Timestamp
      description: The timestamp of the User Account Control.
      type: Number
    - contextPath: FireEyeNX.Alert.Explanation.OsChanges.Uac.Status
      description: The status of the User Account Control.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.StaticAnalysis.Static.Value
      description: The value of the static analysis.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.StolenData.Info.Field
      description: The information field of the stolen data.
      type: Unknown
    - contextPath: FireEyeNX.Alert.Explanation.StolenData.Info.Type
      description: The information type of the stolen data.
      type: String
    - contextPath: FireEyeNX.Alert.Explanation.StolenData.EventId
      description: The event ID of the stolen data.
      type: Number
    - contextPath: FireEyeNX.Alert.Src.Ip
      description: The source IP address of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Src.Mac
      description: The source MAC address of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Src.Port
      description: The source port address of the alert.
      type: Number
    - contextPath: FireEyeNX.Alert.Src.Host
      description: The source host of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.AlertUrl
      description: The alert URL.
      type: String
    - contextPath: FireEyeNX.Alert.Action
      description: The action of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Occurred
      description: The time when the alert occurred.
      type: String
    - contextPath: FireEyeNX.Alert.AttackTime
      description: The time when an attack occurred.
      type: String
    - contextPath: FireEyeNX.Alert.Dst.Mac
      description: The destination MAC address of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Dst.Port
      description: The destination port address of the alert.
      type: Number
    - contextPath: FireEyeNX.Alert.Dst.Ip
      description: The destination IP address of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.ApplianceId
      description: The appliance ID of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Id
      description: The ID of the alert.
      type: Number
    - contextPath: FireEyeNX.Alert.Name
      description: The type of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Severity
      description: The severity of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Uuid
      description: The universally unique identifier (UUID) of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Ack
      description: A flag indicating whether an acknowledgment is received.
      type: String
    - contextPath: FireEyeNX.Alert.Product
      description: The product name of the alert.
      type: String
    - contextPath: FireEyeNX.Alert.Vlan
      description: The virtual LAN (VLAN) of the alert.
      type: Number
    - contextPath: FireEyeNX.Alert.Malicious
      description: A flag indicating whether the alert is malicious.
      type: String
    - contextPath: FireEyeNX.Alert.ScVersion
      description: The SC version of the alert.
      type: String
  - arguments:
    - description: The universally unique ID (UUID) of the alert. To get the UUID, execute the fireeye-nx-get-alerts command.
      name: uuid
      required: true
    description: Downloads malware artifacts data for the specified UUID as a zip file.
    name: fireeye-nx-get-artifacts-by-alert
    outputs:
    - contextPath: File.Size
      description: The size of the file.
      type: Number
    - contextPath: File.SHA1
      description: The SHA1 hash of the file.
      type: String
    - contextPath: File.SHA256
      description: The SHA256 hash of the file.
      type: String
    - contextPath: File.Name
      description: The name of the file.
      type: String
    - contextPath: File.SSDeep
      description: The SSDeep hash of the file.
      type: String
    - contextPath: File.EntryID
      description: The entry ID of the file.
      type: String
    - contextPath: File.Info
      description: The file information.
      type: String
    - contextPath: File.Type
      description: The file type.
      type: String
    - contextPath: File.MD5
      description: The MD5 hash of the file.
      type: String
    - contextPath: File.Extension
      description: The file extension.
      type: String
  - arguments:
    - auto: PREDEFINED
      description: The time interval to search. This filter is used with the end_time filter. If the duration is not specified, the system defaults to duration=12_hours, end_time=current_time.
      name: duration
      predefined:
      - 1_hour
      - 2_hours
      - 6_hours
      - 12_hours
      - 24_hours
      - 48_hours
    - description: "The start time of the search. This filter is used with the duration filter. If the start_time is specified but not the duration, the system defaults to duration=12_hours, starting at the specified start_time.\nFormats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours."
      name: start_time
    - description: "The end time of the search. This filter is used with the duration filter. If the end_time is specified but not the duration, the system defaults to duration=12_hours, ending at the specified end_time. \nFormats:\nYYYY-MM-dd\nYYYY-MM-ddTHH:mm:ss\nN days \nN hours\nExample:\n 2020-05-01 \n 2020-05-01T00:00:00 \n 2 days \n 5 hours."
      name: end_time
    - auto: PREDEFINED
      description: 'Whether to include all IPS events or MVX-correlated events only. Default: false.'
      name: mvx_correlated_only
      predefined:
      - 'true'
      - 'false'
    description: Search and retrieve FireEye events based on several filters.
    name: fireeye-nx-get-events
    outputs:
    - contextPath: FireEyeNX.Event.EventId
      description: The ID of the event.
      type: Number
    - contextPath: FireEyeNX.Event.Occurred
      description: The date and time when the event occurred.
      type: String
    - contextPath: FireEyeNX.Event.SrcIp
      description: The IP address of the victim.
      type: String
    - contextPath: FireEyeNX.Event.SrcPort
      description: The port number of the victim.
      type: Number
    - contextPath: FireEyeNX.Event.DstIp
      description: The IP address of the attacker.
      type: String
    - contextPath: FireEyeNX.Event.DstPort
      description: The port number of the attacker.
      type: Number
    - contextPath: FireEyeNX.Event.Severity
      description: The severity level of the event.
      type: Number
    - contextPath: FireEyeNX.Event.SignatureRev
      description: The signature revision number of the event.
      type: Number
    - contextPath: FireEyeNX.Event.SignatureIden
      description: The signature identity number of the event.
      type: Number
    - contextPath: FireEyeNX.Event.SignatureMatchCnt
      description: The signature match count number of the event.
      type: Number
    - contextPath: FireEyeNX.Event.Vlan
      description: The virtual LAN (VLAN) of the event.
      type: Number
    - contextPath: FireEyeNX.Event.VmVerified
      description: Whether the event VM was verified.
      type: Boolean
    - contextPath: FireEyeNX.Event.SrcMac
      description: The MAC address of the source machine.
      type: String
    - contextPath: FireEyeNX.Event.DstMac
      description: The MAC address of the destination machine.
      type: String
    - contextPath: FireEyeNX.Event.RuleName
      description: The rule name for the event.
      type: String
    - contextPath: FireEyeNX.Event.SensorId
      description: The sensor ID of the FireEye machine.
      type: String
    - contextPath: FireEyeNX.Event.CveId
      description: The CVE ID found in the event.
      type: String
    - contextPath: FireEyeNX.Event.ActionTaken
      description: The IPS blocking action taken on the event.
      type: Number
    - contextPath: FireEyeNX.Event.AttackMode
      description: The attack mode mentioned in the event.
      type: String
    - contextPath: FireEyeNX.Event.InterfaceId
      description: The interface ID of the event.
      type: Number
    - contextPath: FireEyeNX.Event.Protocol
      description: The protocol used in the event.
      type: Number
    - contextPath: FireEyeNX.Event.IncidentId
      description: The incident ID of the event on FireEye.
      type: Number
  dockerimage: demisto/python3:3.12.13.10116658
  isfetch: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- FireEyeNX-Test
fromversion: 5.0.0
defaultclassifier: FireEye NX
defaultmapperin: FireEye NX-mapper