Users can manually submit files and URLs to IVX Server or through APIs and sensors such as IPS, TIE, NX, EX, HX, and SWG. Users can view these submissions and alerts from all sources including APIs and sensors based on the selected date range and download artifacts collected from the submission along with detailed sample reports. If IVX is part of a cluster, the submissions and alerts are displayed for the entire cluster.
The files displayed on the Submissions page depends on the number of days (retention period) you have configured for the artifacts to be available in the list.
Malicious files are retained for up to 30 days.
Non-malicious files are retained for 2 days by default, but are available for up to 15 days.
Note
Only users with the roles admin, analyst, or api_analyst can submit files on the IVX Web UI.
To submit a file or URL for analysis:
Login to IVX Server appliance.
On the Submissions page, click Submit A Sample and select File or URL.
For File, select the files.
For URL, enter the URL.
In the dialog, select the file you want to submit.
Enter the timeout value (in seconds). The minimum timeout is 60 seconds, the maximum is 600 seconds, and the default is 240 seconds.
(Optional) Select the priority for the analysis when adding multiple jobs to the MVX engine queue. The default value is Normal.
(Optional) Select the required guest image profile used by the MVX engine for malware analysis.
Turn on Live mode to initiate a real-time malware analysis job. To enable Live mode, execute the following CLI commands:
analysis live url-dynamic-analysis enable analysis live controlled-live-mode enableFor more details, see Configure Live mode for Malware Analysis using CLI.
(Optional) Turn on Enable Prefetch to determine the URL target internally without navigating to the target location.
Note
If the user does not provide a prefetch value in the options field, this is enabled by default. If Live malware analysis is disabled, Enable Prefetch is automatically enabled.
Turn on VNC to enable Virtual Network Computing (VNC) server which allows you to view and interact with the sample during analysis in the virtual environment. See Handling VNC submissions for more details.
Note
When you enable VNC, the Priority option is disabled.
(Optional) Enter the password to decrypt the uploaded ZIP file submitted for malware analysis.
Click Submit. The submitted file is displayed in the table. Click
if the submitted file is not displayed.The following table describes the details on the Submissions page:
Column Name
Description
Completed At
The date and time the sample completed analysis.
Note
When you navigate to Submissions, the date range automatically resets to the default of 2 days, irrespective of the date range you have selected on the dashboard.
MD5
The MD5 hash of the sample. Click the hash value to view the analysis report for the sample.
Type
The type of file submitted for analysis. To filter results, enter a file type in the search box under the column heading and press Enter.
Name
The name of the file submitted for analysis. To search for a specific file, enter its name in the search bar under the column heading and press Enter. Click on the file link to open the analysis report for more information on that alert.
Verdict
The result of the analysis on the sample. A file or URL can have one of the following verdicts:
Clean: No malware was detected in the sample.
Malicious: The sample contains malware, and was designed to be used maliciously.
Riskware: The sample is not intended to be malicious, but could be used maliciously.
Signature
The name of the threat group behind a malicious attack. To view all alerts associated with a threat, enter the signature name in the search box under the column heading and press Enter.
Artifacts
Click
icon to download the artifacts associated with the submission. You will see this icon only if there are other artifacts available.Click
icon to download the samples. The password to view the file is "protected".Click the Connect to VNC server
icon to open a VNC session with the sample in the virtual environment. This icon only appears for submissions where VNC is enabled.The VNC session is available on all systems running IVX Server build 11.0.0.1020552 (11.0.0-abbot-hotfix) or later. See KB14797 for more details.
Submitter
The name of the user who submitted the sample. To filter samples by a submitter, enter their name in the search bar under the column heading and press Enter.
Submissions made through ICAP are now displayed in the Submitter field as ICAP, allowing you to easily identify and track all submissions originating from ICAP.
UUID
A unique reference ID generated for each file or URL submitted for analysis.
Analysis mode
Indicates where the analysis was performed for this submission. It displays “Sandbox” for analysis conducted in a sandbox environment and “Live” for real-time analysis.
Use the toggle button to switch between Running and Completed to check whether the submitted files are still being analyzed or completed. When viewing Running submissions, only up to 1000 records are displayed.
Click
to download the report in CSV format. The maximum of 1000 records are only displayed in the report.
Launching and using a VNC session
After you click the Connect to VNC server
icon for a running submission, a new window appears, allowing you to interact directly with the sample submission for analysis in the virtual environment.
The VNC window lists the analysis jobs for each guest image profile selected during submission.
For each profile, you can:
Click the Play icon to view the live analysis within the current VNC window.
Click the Open in new tab icon to launch the analysis session in a new browser tab.
Handling VNC submissions
If multiple samples are already in the queue, VNC submission waits until a virtual machine (VM) is available. The analysis starts only after the VM resources are free.
The VNC port ranges from 5901 to 6413 which is allowed from the user's network if they are using a VNC viewer.
Operating system support:
For CentOS submissions, a VNC icon does not appear in the submission list and it cannot be opened because these samples are only subjected to static analysis.
For OSX submissions, VNC recordings are generated as 0 KB artifacts. For other operating systems, the recordings are generated normally.
Samples submitted with VNC enabled are sent directly for analysis and do not appear in the queue displayed by the show mvx node queuemgr status command.
The VNC feature is only available for samples submitted directly through the IVX Web UI and it is not supported for submissions made through sensors or the API.
The VNC session is only available on the specific broker node where the sample was originally submitted.