Exclusion Import File

You can import one or more exclusions as a .csv file.

Note:Tenable does not recommend opening the .csv file in Microsoft Excel, as Excel can add additional characters to the file that Tenable Vulnerability Management cannot recognize.

This file is composed of a header and at least one line of data. Separate each line in the file with a new line break.

Header (Optional)

A header line in the file is optional. If included, the header must be the first line in the file and be formatted as follows:

id,name,description,members,creation_date,last_modification_date

Note: There are no spaces after the commas.

Data (Required)

Each data line in the file represents one exclusion configuration. Data lines must be separated from each other by a new line break. The file must include at least one data line.

Each data line is a comma-separated string of fields described in the following.

Note: Optional fields can be blank, but the associated comma separator must be present in the data line.

Field Description

Required

id An integer that uniquely identifies the exclusion. No
name The name of the exclusion. You can use any combination of alphanumeric characters or symbols. Yes
description A description for the exclusion. Yes
members

The target or targets where you want the scan exclusion to apply.

This value can have the following formats:

  • A hostname (example.com)
  • An IP address (192.0.2.57)
  • An IP range (192.0.2.57-192.0.2.67)
  • A comma-separated list of multiple hostnames, IP addresses, or IP ranges, bracketed by quotation marks ("192.0.2.57,192.0.2.177,192.0.2.8")
Yes
creation_date The Unix timestamp that Tenable Vulnerability Management uses as the creation date for the imported exclusion. No
last_modification_date The Unix timestamp that Tenable Vulnerability Management uses as the last modification date for the exclusion. No

Example

Copy
id,name,description,members,creation_date,last_modification_date
1,Exclusion Rule 1,routers,"192.0.2.57,192.0.21.177,192.0.28",1561643735,1561643785
2,Exclusion Rule 2,workstations,192.0.257-192.0.267,1561643735,1561643785