--- title: "Submit a file or URL for malware analysis in IVX Server" slug: "submit-a-file-or-url-for-malware-analysis-in-ivx-server" tags: ["Product Usage", "CMS 11.x", "EX 11.x", "FX 11.x", "AX 11.x", "NX 11.x", "IVX 11.x", "Network Security"] updated: 2026-09-10T14:34:02Z published: 2026-09-10T14:34:02Z canonical: "docs.trellix.com/submit-a-file-or-url-for-malware-analysis-in-ivx-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit a file or URL for malware analysis in IVX Server 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](/network-and-platform/docs/deleting-files-automatically) 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] > 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:** 1. Login to IVX Server appliance. 2. On the **Submissions** page, click **Submit A Sample** and select **File** or **URL**. - For **File**, select the files. - For **URL**, enter the URL. 3. In the dialog, select the file you want to submit. 4. Enter the timeout value (in seconds). The minimum timeout is 60 seconds, the maximum is 600 seconds, and the default is 240 seconds. 5. (Optional) Select the priority for the analysis when adding multiple jobs to the MVX engine queue. The default value is **Normal**. 6. (Optional) Select the required guest image profile used by the MVX engine for malware analysis. 7. Turn on **Live** mode to initiate a real-time malware analysis job. To enable Live mode, execute the following CLI commands: ```plaintext analysis live url-dynamic-analysis enable analysis live controlled-live-mode enable ``` For more details, see [Configure Live mode for Malware Analysis using CLI](/network-and-platform/docs/configuring-live-mode-for-malware-analysis). 8. (Optional) Turn on **Enable Prefetch** to determine the URL target internally without navigating to the target location. > [!NOTE] > 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. 9. 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](/network-and-platform/docs/submit-a-file-or-url-for-malware-analysis-in-ivx-server#launching-and-using-a-vnc-session) for more details. > [!NOTE] > Note > > When you enable **VNC**, the **Priority** option is disabled. 10. (Optional) Enter the password to decrypt the uploaded ZIP file submitted for malware analysis. 11. Click **Submit**. The submitted file is displayed in the table. Click ![Refresh_submissions.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-c9ec136b-6a60-bf25-019c-d898b89cf27e.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) if the submitted file is not displayed. 12. The following table describes the details on the **Submissions** page: | Column Name | Description | | --- | --- | | Completed At | The date and time the sample completed analysis. > [!NOTE] > 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 ![IVX_Server_UI_Artifacts_icon.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-47a196dc-7a36-f520-05c0-a365f1ee3079.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) icon to download the artifacts associated with the submission. You will see this icon only if there are other artifacts available. Click ![IVX_Server_UI_Samples_download_icon.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-e4770b02-0579-c482-23df-1ed444439156.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) icon to download the samples. The password to view the file is "protected". Click the [**Connect to VNC server**](/network-and-platform/docs/submit-a-file-or-url-for-malware-analysis-in-ivx-server#launching-and-using-a-vnc-session) ![Connect_to_vnc.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-205130fc-1aed-a3be-cd4e-5002246a94a9.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) 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](https://thrive.trellix.com/s/article/000014797) 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. | 13. 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. 14. Click ![CSV_format_report.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-84009c40-d54f-cf71-66fe-76968114369d.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) 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** ![Connect_to_vnc.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-205130fc-1aed-a3be-cd4e-5002246a94a9.png?sv=2026-02-06&spr=https&st=2026-11-20T10%3A34%3A48Z&se=2026-11-20T11%3A34%3A48Z&sr=c&sp=r&sig=eqHxKevOVWaQgpLpT8AvOAfIaZSKJR%2BA6%2FSsW%2FdwYVo%3D) icon for a running submission, a new window appears, allowing you to interact directly with the sample submission for analysis in the virtual environment. 1. The VNC window lists the analysis jobs for each guest image profile selected during submission. 2. For each profile, you can: 1. Click the **Play** icon to view the live analysis within the current VNC window. 2. 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.