Imports

POST Imports

Purpose

Queues a third-party import.

Required Permissions

Scan Management (Read/Write).

Request Body

Content-Type: application/json

{
    WorkgroupID: int,
    ImportType: string,
    Filter: string,
    FileName: string,
    FileContents: byte[],
    Base64FileContents: string
}

Provide either FileContents or Base64FileContents.

Request Body Details

  • WorkgroupID: ID of the Workgroup to import the assets into
  • ImportType: (case-senstitive, default: PASSWORDSAFE) Type of import being queued:
    • PASSWORDSAFE: Password Safe import file. Expected file extension: .xml.
    • RETINARTD: Retina© RTD file. Expected file extension: .rtd.
      Support for the following file types has been deprecated and will be removed from the product in a future version.
    • NESSUS: Nessus© import file. Expected file extension: .csv.
    • NESSUSSECCEN: NessusSecurityCenter© import file. Expected file extension: .csv.
    • NEXPOSE: Nexpose© import file. Expected file extension: .csv or .xml.
    • QUALYSGUARD: QualysGuard© file. Expected file extension: .csv or .xml.
    • METASPLOIT: METASPLOIT© import file. Expected file extension: .xml.
    • MCAFEEVM: McAfee Vulnerability Management© import file. Expected file extension: .csv.
    • TRIPWIRE: Tripwire© import file. Expected file extension: .csv.
  • Filter: (default: All Assets) Asset selection filter:
    • All Assets: No filter, import all.
    • Single IPv4 address (i.e. 10.0.0.1).
    • IPv4 range (i.e. 10.0.0.1-10.0.0.5).
    • CIDR (i.e. 10.0.0.0/24).
  • FileName: Filename (including extension) of the import file. One of the following is required:
    • FileContents: The array containing the content of the import file.
    • Base64FileContents: Base64 string containing the content of the import file.

Response Body

Content-Type: application/json

{
    ImportID: int
}

Response Codes

200 – Request successful. Import ID in the response body.

For more information, please see Common Response Codes.