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.
Field | Description | Required |
---|---|---|
id | An integer that uniquely identifies the exclusion. | optional |
name | The name of the exclusion. You can use any combination of alpha-numeric characters or symbols. | required |
description | A description for the exclusion. | optional |
members | The target or targets where you want the scan exclusion to apply. This value can have the following formats:
| required |
creation_date | The Unix timestamp that Vulnerability Management uses as the creation date for the imported exclusion(s). | optional |
last_modification_date | The Unix timestamp that Vulnerability Management uses as the last modification date for the exclusion(s). | optional |
uuid | The 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,,,
Updated 7 days ago