---
title: Generic Upload Guide
slug: rbvm-help/generic-upload-guide
createdAt: 2026-10-26T13:51:22.006Z
---

**Summary**: How to upload generic scan files into Ivanti Neurons.

## Generic Upload Overview – CSV

The Ivanti Neurons platform’s **Generic Upload** functionality allows users to upload assets and findings information from **any CSV-format source** they have into the platform using the Generic Upload Mapping tool. This utility provides the flexibility to bring in data from an unsupported scanner, a homegrown CMDB for assets, or even penetration test data from a red team or third-party penetration test on your assets.

## Generic Upload Process: Network

Once you have exported the chosen source’s CSV data, log in to your Ivanti Neurons platform. Navigate to the **Settings (**:inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/nNbQyA_cMpuwaBOoCx9_w_reporting-a-bug.png" alt="Settings Menu - Gear - Small" caption size="10" width="20" height="20"}**) > Uploads **page by clicking the gear in the top-right corner of the screen.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/7w3Nn53pUUCcqzFlmn_HE_generic-upload-guide.png" alt="Uploads Menu Location-1" position="flex-start" size="57" width="399" height="270" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide.png" showCaption="false"}

In the **Upload Wizard**, enter the **Upload Name** and click **Next**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/LX3A7t14eZYioV8x4hgO-_generic-upload-guide1.png" alt="Generic Upload - Upload Name Field" position="flex-start" size="98" width="688" height="226" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_1.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_1.png" showCaption="false"}

Select an assessment to associate with this scan. You can either select an available assessment or create a new one. To create a new assessment, click the **Create Assessment** button. Fill out the fields in the **Add a New Assessment** window and click **Submit**. You can now select your new assessment from the list.

Select an assessment from the list to associate with this scan (you can use the search field to find an assessment) and click **Next**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/DAz5yKP6JmBvlKD0ZjZBX_generic-upload-guide2.png" alt="Generic Upload - Create or Select Assessment" position="flex-start" size="98" width="684" height="134" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_2.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_2.png" showCaption="false"}

Select a network for this scan. You can either select an available network or create a new one. To create a new network, click the **Create Network** button. Fill out the fields in the **Add a New Network** window and click **Submit**. You can now select your new network from the list.

Select a network from the list (you can use the search field to find a network) and click **Next**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/GA0EhEcZG7CgmKcKxf8o7_generic-upload-guide3.png" alt="Generic Upload - Create or Select Network" position="flex-start" size="98" width="688" height="153" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_3.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_3.png" showCaption="false"}

On the **Upload Files** page, there are two ways to add scan files. You can either drag and drop the file in the gray **Drag files here** or click the **Select Files** button and search for the scan file on your computer. Once the file has been added, click **Upload**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/eF_1HdYDIW3WgDJtXUhhJ_generic-upload-guide4.png" alt="Generic Upload - Upload Scan Files" position="flex-start" size="98" width="686" height="247" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_4.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_4.png" showCaption="false"}

Once the upload finishes, you must map the CSV file to the minimum required fields in Ivanti Neurons. This status is indicated in the **State** column as **Requires Manual Mapping**, as shown here.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/BfR3JHK-3U1kU7H97hWWd_generic-upload-guide5.png" alt="Generic Upload - Requires Manual Mapping State" position="flex-start" size="29" width="203" height="32" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_5.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_5.png" showCaption="false"}

To start the mapping process, click **Requires Manual Mapping**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/0c02azLvyDcCrHvKdI6tc_generic-upload-guide6.png" alt="Generic Upload - Requires Manual Mapping Location" position="flex-start" size="98" width="686" height="118" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_6.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_6.png" showCaption="false"}

### Field Mapping

Accessing the **Generic Upload Wizard** for the first time presents the user with a brief tutorial on its features. The first step is to define the scanner type needed for the Scanner card. Depending on the data type, you can select either Host or Application. To create the scanner for the data set, click the **Plus (+)** button on the card.

A **scanner** is a data source used to attribute assets and findings within the platform. For example, you may have a scanner for your homegrown configuration management database (CMDB) for hosts, one for the homegrown CMDB for applications, one for a red team penetration test for your hosts, and one for a scanner that is not currently supported. All these are identified by their scanner and their plugin, which we will cover later.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/WPYZppELX9BgrSv09YGTu_generic-upload-guide7.png" alt="Generic Upload - Scanner Plus Button Location" position="flex-start" size="51" width="355" height="265" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_7.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_7.png" showCaption="false"}

Clicking the **Plus (+)** button opens the **Create Scanner** window. Enter the scanner name, select the scanner type (host or application), add the scanner’s version, and enter a description. Note that each scanner has a different set of required fields that are defined later in this document.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/XTOCAQGGNEHpf3zTRhKh4_generic-upload-guide8.png" alt="Generic Upload - Create Scanner Window" position="flex-start" size="72" width="504" height="371" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_8.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_8.png" showCaption="false"}

After completing the required fields, click **Submit**. In the **Scanner – Version** box, the new scanner details appear. In the **Mapping - Version** card, the user can find any previously created mappings and check the **Top row of the CSV contains headers** box, if needed.  If the ingested data set contains a header, ensure that this box is checked. Additionally, the interface provides the user with breadcrumbs for the remaining required fields.

The required fields are important here; as mentioned earlier, the plugin is the unique identifier within your scanner that identifies a particular finding. With this, you can upload future data, and the platform with intuitively know whether things are closed by their presence in the newer file.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Zf08wXqL2vAqClZqP2H62_generic-upload-guide9.png" alt="Generic Upload Guide - Map Attributes" position="flex-start" size="94" width="656" height="158" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_9.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_9.png" showCaption="false"}

Each required field is removed from the breadcrumb list as it is assigned.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/rL-7uGtGQyyLRXXeIiAqS_generic-upload-guide10.png" alt="Generic Upload Guide - Completed Field Mapping Removed" position="flex-start" size="98" width="686" height="236" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_10.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_10.png" showCaption="false"}

Other than the required fields, Ivanti Neurons also provides highly recommended fields that are important to map for better data representation. Leaving these recommended fields blank will not throw any errors.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/MZhpQq198g1UFFb4crc7l_generic-upload-guide11.png" alt="Generic Upload Guide - Mapping Highly Recommended Fields" position="flex-start" size="98" width="687" height="423" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_11.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_11.png" showCaption="false"}

Ivanti Neurons fields allows users to map a field from the CSV to more than one field in Ivanti Neurons. Click **Add another attribute** in each pane to map the same CSV field to more than one field in Ivanti Neurons.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Y6sW5wPZASxrDhZeZgeJQ_generic-upload-guide12.png" alt="Generic Upload Guide - Add Another Attribute" position="flex-start" size="98" width="687" height="258" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_12.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_12.png" showCaption="false"}

The maximum number of Ivanti Neurons fields that can be mapped to the same CSV field is **three**.

Since there are more chances for Tags and Output (applicable only for application scanners) to have multiple values, they are handled differently. Ivanti Neurons allows the mapping of multiple CSV fields to the Tags and Output fields. All other fields remain the same. In other words, Ivanti Neurons cannot map multiple CSV fields to the same fields in Ivanti Neurons other than the Tags and Output fields.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ekq3V_VAyXJaIjjXKa_tz_generic-upload-guide13.png" alt="Generic Upload Guide - Mapping Multiple Fields to Tags" position="flex-start" size="98" width="685" height="406" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_13.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_13.png" showCaption="false"}

Ivanti Neurons supports the **Asset Only Mapping** option as well. For example, if the CSV file only has host-related information and a user wishes to ingest only Host/Application data.

In the **Mapping - Version** pane, have the user enable the **Asset Only Mapping** option. Once this is ticked, the required fields change.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/hK0dwK6RXHGZHqKVF4OLc_generic-upload-guide14.png" alt="Generic Upload Guide - Asset Only Mapping" position="flex-start" size="98" width="683" height="414" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_14.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_14.png" showCaption="false"}

Once you have mapped all the required fields successfully, click the **Save Mapping** button to save this mapping.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/C2lHnJzFa49osDUaynY7d_generic-upload-guide15.png" alt="Generic Upload Guide - Save Mapping Button" position="flex-start" size="98" width="685" height="201" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_15.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_15.png" showCaption="false"}

In the **Create a Mapping** window, fill out the name, version, and description fields. Once complete, click **Submit**.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/yiYV2dMhUq8zlYfTG6buX_generic-upload-guide16.png" alt="Generic Upload Guide - Create a Mapping Window" position="flex-start" size="78" width="545" height="526" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_16.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_16.png" showCaption="false"}

For application scanners, the **Create a Mapping** window includes the Findings Type dropdown as a required field. User can choose the findings to be categorized as SAST, DAST, OSS, CONTAINER, and OTHERS. If no value is selected, by default Ivanti Neurons will mark all application findings as DAST.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/j42TsI9EPn2VLFTA4_LYl_generic-upload-guide17.png" alt="Generic Upload Guide - Finding Type DAST" position="flex-start" size="76" width="530" height="592" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_17.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_17.png" showCaption="false"}

After saving the mapping, the platform must validate the data set. During the validation process, the system looks at the file’s first 5,000 lines. Click the **Validate Mapping** button to proceed.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/-pRoUPdcfXEII6YyovPF3_generic-upload-guide18.png" alt="Generic Upload - Validate Mapping Button Location" position="flex-start" size="97" width="678" height="52" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_18.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_18.png" showCaption="false"}

You will see the following screen during the validation process.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/f8Na3DfCaqkFLH2wJGwZD_generic-upload-guide19.png" alt="Generic Upload - Validation Processing" position="flex-start" size="98" width="686" height="203" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_19.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_19.png" showCaption="false"}

Once validation is complete, the platform provides the validation results. Depending on the system’s ability to validate data, the platform presents varying percentages on the amount of data that can be validated. In this example, all the fields are 100% valid. The user can also force the system to revalidate the complete file by clicking the **Force Full Scan** button.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/N8QeLdlaCuCSonn9D8Qb-_generic-upload-guide20.png" alt="Generic Upload - Force Full Scan Button Location" position="flex-start" size="98" width="687" height="150" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_20.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_20.png" showCaption="false"}

Once validation is complete, click the **Finalize Import** button. The **Save Mapping to File** dialog box appears.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/5Y-io-nE4Ks2dPCcv_b4k_generic-upload-guide21.png" alt="Generic Upload - Save Mapping to File Dialog Box" position="flex-start" size="92" width="645" height="140" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_21.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_21.png" showCaption="false"}

Clicking **Yes** returns the user to the Upload Wizard. In the Upload Wizard, we can confirm the mapping was saved, the scanner was created, and the file is ready to process. To process the scan file, click the **Start** button.

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/cQ4KhA5u2q4PtVMFUIibN_generic-upload-guide22.png" alt="Generic Upload - Start Button Location" position="flex-start" size="98" width="684" height="134" initialPath="Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_22.png" githubPath="RBVM_14.70_help/Resources/Images/RS KB Mirror for Ivanti - 2022/Generic Upload Guide_22.png" showCaption="false"}

When uploading the next set of data to the platform, it will automatically fingerprint to the scanner created earlier.

## Appendix A: CSV Data Structure

Below is a sample of accepted field headers for both network and application CSV ingestion. In the Detailed View section, the required fields are noted as a baseline for the data to be ingested into the platform.  When generating the CSV file, it does not need to be in this exact format nor does it need to have the same headers.  When mapping the file, it is necessary to map the data to the fields. Detailed mapping is provided below.

### Network

```bash
host_name,ip,fqdn,os,plugin_id,title,service_name,service_port,severity,description,cves,tags,reference_name,reference_url,date_found,finding_tags,Soln
```

### Detailed Field View

```bash
Assets (Host)
 CPEs
 Certainty
 Criticality
 DNS
 Device Class
 Discovered On (yyyy-MM-dd)
 FQDN
 Hostname (required)
 IP Address (required)
 Last Found On (yyyy-MM-dd)
 NetBIOS
 Operating System
 Owner
 Tags

Findings (Host)
 CVEs
 Description (Highly Recommended)
 Discovered On (yyyy-MM-dd)
 Last Found On (yyyy-MM-dd)
 Plugin ID (required)
 Reference Names/IDs
 Reference Types
 Reference URLs
 Scanner Output
 Service Name
 Service Port
 Severity (required)
 Solution (Highly Recommended)
 Tags
 Title (required)
```

### Application

```bash
Address,name1,Location,Description,Plugin ID,Severity,Solution,Title,Discovered On,Last Found On,Hostname,IP Address,Criticality,Owner,Tags,Title__findings,Discovered On_find,Last Found On_find,Plugin ID_find,Output,Full Request,Request Parameter,Request Method,Request URL,Full Response,Payload,CWE,Tags_finds,Reference Types,Reference URLs,Reference Names/IDs
```

### Detailed Field View

```bash
Assets (Application)
 Base URL (required)
 Criticality
 Discovered On (yyyy-MM-dd)
 Hostname
 IP Address
 Last Found On (yyyy-MM-dd)
 Name (required)
 Owner
 Tags

Findings (Application)
 Application URL (required)
 CWE
 Description (Highly Recommended)
 Discovered On (yyyy-MM-dd)
 Full Request (Base64 Encoded)
 Full Response (Base64 Encoded)
 Last Found On (yyyy-MM-dd)
 Output
 Payload
 Plugin ID (required)
 Reference Names/IDs
 Reference Types
 Reference URLs
 Request Method
 Request Parameter
 Request URL
 Severity (required)
 Solution (Highly Recommended)
 Tags
 Title (required)
```