Manage vulnerability assessment scanners

Relevant for AppViz administrators

This section describes how to manage vulnerability assessment scanner information, either by integrating directly with scanners, or importing vulnerabilities manually from files.

Supported vulnerability assessment service providers

AppViz supports the following scanners:

• Qualys - QualysGuard (v7.0 and above). QualysGuard licenses must have KB permissions to integrate with AppViz, including API permissions.

• Rapid 7 - Nexpose
• Tenable - Nessus Vulnerability Scanner, versions 6 and above
• Tenable - Nessus Manager
• Tenable - SecurityCenter

If your vulnerability scanner is not supported, AppViz enables you to import vulnerability data using our API instead. For details, see Import vulnerability data.

Vulnerability scanner configuration prerequisites

Configuring a vulnerability scanner in AppViz requires the following:

Connections	An open connection between the ASMS and the scanner. Default ports: QualysGuard: 443 Nessus: 8834 Rapid Nexpose: 3780
Credentials	Credentials for a user with read permissions for all scans and API access
API address	A full API address for the scanner.

Define general vulnerability assessment settings

Do the following:

1. Navigate to the Administration area.

   • Hover over the SETTINGS icon at the bottom left of the screen. After the panel expands, click ADMINISTRATION.

   • In the toolbar, click your username. From the drop-down menu, click ADMINISTRATION.

     

   The Administration area appears in the workspace.

2. Click the VULNERABILITY ASSESSMENT tab. For example:

   

3. Define the following general vulnerability settings:

   Max Number of Addresses in Object	Enter the maximum network object size. Only vulnerability information for network objects with this number of IP addresses or less will appear in ASMS. For example, an object with an IP range of 10.20.0.0/16 includes 65,536 IP addresses. It will therefore be ignored while performing vulnerability queries. Default = 256, Max = 1024
   Refresh Scan Results Automatically	Determines whether AppViz refreshes vulnerability data automatically, and if so, how often and when. Default = Enabled, and set to Daily at 00:00.

4. Click Save Changes.

Add a vulnerability scanner

Do the following:

1. Navigate to the Administration area.

   • Hover over the SETTINGS icon at the bottom left of the screen. After the panel expands, click ADMINISTRATION.

   • In the toolbar, click your username. From the drop-down menu, click ADMINISTRATION.

     

   The Administration area appears in the workspace.

2. Click the VULNERABILITY ASSESSMENT tab.

3. To add a new scanner, click + Add Scanner. A new scanner definition area is added towards the bottom of the screen.

   

   Tip: If you already have scanners configured, you may need to scroll down to view the new area.

   Populate the fields as follows:

   Service provider	Select the scanner type you want to add.
   Scanner API address	Enter the scanner's server URL.
   Username / Password	Enter the credentials used to access the scanner server.

4. Click Save Changes.

   Your new scanner is added to the grid, and scanning begins. It may take some time until the initial vulnerability scan is complete.

Delete a scanner

To delete a scanner configuration, click the Delete button next to the scanner you want to delete.

Each of the scanners you configure enables you to do the following:

Update	Update vulnerability data from this scanner. This performs a manual refresh for the selected scanner, and is useful if you don't have refresh automatically selected, or if you want to run a manual update in between scheduled refreshes.
Disable	Disable the scanner without losing the scanner configuration data.

Run a vulnerability scan

This section describes how to run a vulnerability scan from the AppViz Administration area.

Before you start, you must have vulnerability scanners configured. For details, see Add a vulnerability scanner.

Do the following:

1. Navigate to the Administration area.

   • Hover over the SETTINGS icon at the bottom left of the screen. After the panel expands, click ADMINISTRATION.

   • In the toolbar, click your username. From the drop-down menu, click ADMINISTRATION.

     

   The Administration area appears in the workspace.

2. Click the VULNERABILITY ASSESSMENT tab. For example:

   

3. Click Run Scan. A full scan is run on all vulnerability scanners configured.

Import vulnerability assessment information

This section describes how to import your vulnerability data into AppViz from a CSV file using the command line.

Use this process when AppViz does not support integrating directly with your vulnerability scanner, and you do not want to use the API.

Do the following:

• Prepare your CSV files
• Import vulnerability data

Prepare your CSV files

In the /home/bflow/config/vulnerability_from_file directory, create the following CSV files:

Vulnerability data

Name the file with a prefix that includes: vulnerability_info. For example: vulnerability_info_dataJun12-19.csv Include the following column headers in the file: Mandatory column headers (in this order): Vulnerability ID (String, unique) Summary (String) Description (String) CVSS score (Float) Optional column headers: CVEs (Strings divided by ',')

Server-vulnerability mapping

Name the file with a prefix that includes: servers_vulnerability. For example: servers_vulnerability_dataJun12-19.csv Include the following column headers in the file: Mandatory column headers (in this order): IP address (string). Only single IP addresses are supported, not ranges or subnets. Vulnerability ID (string) Optional column headers: Date (Unix timestamps, in milliseconds). Default is the current date and time. Note: Each entry can contain only one vulnerability. If a single server has more than one vulnerability, the server must be represented on multiple lines.

Continue with Import vulnerability data.

Import vulnerability data

Once your have both your vulnerability data and server-vulnerability mapping CSV files ready in the /home/bflow/config/vulnerability_from_file, you're ready to import vulnerability data into AppViz.

For more details, see Prepare your CSV files.

Do the following:

Open a terminal and run one of the following:

• Import both vulnerability and server mapping data together:

  BusinessFlow-CLI.sh -t import_vulnerability_files

  Note: Use this command if you this is the first time you are importing vulnerability data.

• Import vulnerability data only:

  BusinessFlow-CLI.sh -t import_vulnerability_information

• Import mapping data only:

  BusinessFlow-CLI.sh -t import_servers_vulnerability

The vulnerabilities are imported.