Import File Formats

Exclusion Import File

Using the Import exclusion API endpoint, 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:

Legacy Header

id,name,description,members,creation_date,last_modification_date

Header with Exclusion UUID

id,name,description,members,creation_date,last_modification_date,uuid

Do not enter spaces after the commas.

📘

Note

Even if the file does not contain a header, the data must be formatted in the order defined by the optional headers.

Data (Required)

Each data line in the file represents one exclusion configuration and is a comma-delimited string of fields described in the following table.

On save, server-generated data will replace the id, uuid, creation_date, and last_modification_date data that you enter.

📘

Note

Optional fields can be blank, but you must enter the associated comma separator 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.optional
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
uuidThe universally unique identifier for the exclusion.optional

Example

CSV file with legacy header

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,,

CSV file with header that includes an exclusion UUID

id,name,description,members,creation_date,last_modification_date,uuid
1,Exclusion Rule 1,routers,"192.0.2.57,192.0.2.177,192.0.2.8",1561643735,1561643785,96b22ae6-6024-4a9d-85c5-f57a9fbf9488
,Exclusion Rule 2,workstations,192.0.2.57-192.0.2.67,,,