Import File Formats

Exclusion Import File

Using the POST /file/upload and POST /exclusions/import API endpoints, you can import exclusions as a comma-separated values (.csv) file for use in scan configuration in Tenable Vulnerability Management.

This file is composed of a header and at least one line of data. Each line in the file must be separated by 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 in this line.

Data (Required)

Each data line in the file represents one exclusion configuration.

Each data line is a comma-delimited string of fields described in the table below.

📘

Note

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

FieldDescriptionRequired
idAn integer that uniquely identifies the exclusion.optional
nameThe name of the exclusion. You can use any combination of alpha-numeric characters or symbols.required
descriptionA description for the exclusion.required
membersThe target or targets where you want the scan exclusion to apply. This value can have the following formats:
  • A host name (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 host names, IP addresses, or IP ranges, bracketed by quotation marks ("192.0.2.57,192.0.2.177,192.0.2.8")
required
creation_dateThe Unix timestamp that Vulnerability Management uses as the creation date for the imported exclusion(s).optional
last_modification_dateThe Unix timestamp that Vulnerability Management uses as the last modification date for the exclusion(s).optional

Example

id,name,description,members,creation_date,last_modification_date
1,Exclusion Rule 1,routers,"192.0.2.57,192.0.2.177,192.0.2.8",1561643735,1561643785
,Exclusion Rule 2,workstations,192.0.2.57-192.0.2.67,,