Web App Scanning Asset Properties

The following table defines the properties in a Tenable Data Stream web app scanning assets payload file. To see an example file, go to Web App Scanning Asset Payload Files.

Property Data Type Description
payload_id string The ID of the payload sent from Tenable Vulnerability Management.
version integer The version of the payload. This number increments when the payload structure changes.
type string The type of payload (WAS_ASSET).
count_updated integer The number of objects updated in the payload.
count_deleted integer The number of objects deleted in the payload.
updates[] array of objects A list of updated web app scanning asset objects.
updates[].id string The UUID of the asset in Tenable Vulnerability Management. Use this value as the unique key for the asset.
updates[].has_agent boolean Specifies whether a Tenable Agent scan identified the asset.
updates[].has_plugin_results boolean Specifies whether the asset has plugin results associated with it.
updates[].is_licensed boolean Indicates whether the asset is licensed by Tenable.
updates[].types[] array of strings A list of asset types that apply to the asset (for example, webapp).
updates[].terminated_by string The user who terminated the AWS instance of the asset.
updates[].deleted_by string The user who deleted the asset record.
updates[].agentNames[] array of strings The names of any Tenable Agents that scanned and identified the asset.
updates[].operating_systems[] array of strings The operating systems that scans have associated with the asset record.
updates[].system_types[] array of strings The system types as reported by Plugin ID 54615. Possible values include router, general-purpose, scan-host, and embedded.
updates[].manufacturer_tpm_ids[] array of strings The manufacturer's unique identifiers of the Trusted Platform Module (TPM) associated with the asset.
updates[].installed_software[] array of strings

A list of Common Platform Enumeration (CPE) values that represent software applications a scan identified as present on an asset. This attribute supports the CPE 2.2 format. For more information, see the "Component Syntax" section of the CPE Specification, Version 2.2. For assets identified in Tenable scans, this attribute contains data only if a scan using Nessus Plugin ID 45590 has evaluated the asset.

Note: If no scan detects an application within 30 days of the scan that originally detected the application, Tenable Vulnerability Management considers the detection of that application expired. As a result, the next time a scan evaluates the asset, Tenable Vulnerability Management removes the expired application from the installed_software_attribute. This activity is logged as a remove type of attribute_change update in the asset activity log.
updates[].is_public boolean Specifies whether if the asset is an internet-facing and accessible externally.
updates[].sources[] array of objects

Objects that describe the scan sources that identified the asset. An asset source is the entity that reported the asset details. Sources can include sensors, connectors, and API imports. If your request specifies multiple sources, Tenable Vulnerability Management returns all assets seen by any of the specified sources.

The items in the sources array must correspond to the names of the sources as defined in your organization's implementation of Tenable Vulnerability Management.

Commonly used names include:

  • AWS — The asset data was obtained from an Amazon Web Services connector.

  • NESSUS_AGENT — The asset data was obtained from a Tenable Agent scan.

  • NESSUS_SCAN — The asset data was obtained from a Tenable Nessus scan.

  • PVS — The asset data from a Tenable Network Monitor scan.

  • WAS — The asset data was obtained from a Tenable Web App Scanning scan.

updates[].sources[].name string

The name of the entity that reported the asset details. Sources can include sensors, connectors, and API imports. Source names can be customized by your organization (for example, you specify a name when you import asset records). If your organization does not customize source names, the system-generated names include:

  • AWS — The asset data was obtained from an Amazon Web Services connector.

  • NESSUS_AGENT — The asset data was obtained from a Tenable Agent scan.

  • NESSUS_SCAN — The asset data was obtained from a Tenable Nessus scan.

  • PVS — The asset data from a Tenable Network Monitor scan.

  • WAS — The asset data was obtained from a Tenable Web App Scanning scan.

updates[].sources[].first_seen string The ISO timestamp when the source first reported the asset.
updates[].sources[].last_seen string The ISO timestamp when the source last reported the asset.
updates[].tags array of objects

Object containing the tags for the asset.

Note: The tags object is always empty and appears to maintain compatibility with the Tenable API. Your tag data is sent in the tags payload file.
updates[].tags[].uuid string The UUID of the tag.
updates[].tags[].key string The tag category (the first half of the category:value pair).
updates[].tags[].value string The tag value (the second half of the category:value pair).
updates[].tags[].added_at string The ISO timestamp when the tag was assigned to the asset.
updates[].tags[].added_by string The UUID of the user who assigned the tag to the asset.
updates[].network object An object containing network-related information for the asset.
updates[].network.network_id string The ID of the network associated with the scanners that identified the asset. The default network ID is 00000000-0000-0000-0000-000000000000. For more information about network objects, see Manage Networks.
updates[].network.network_name string The ID of the network object associated with scanners that identified the asset. The default network name is Default. All other network names are user-defined. For more information about network objects, see Manage Networks.
updates[].network.ipv4s[] array of strings The IPv4 addresses that scans have associated with the asset record.
updates[].network.bios_uuid string The BIOS UUID of the asset.
updates[].network.ipv6s[] array of strings The IPv6 addresses that scans have associated with the asset record.
updates[].network.fqdns[] array of strings The fully-qualified domain names that scans have associated with the asset record.
updates[].network.mac_addresses[] array of strings The MAC addresses that scans have associated with the asset record.
updates[].network.netbios_names[] array of strings The NetBIOS names that scans have associated with the asset record.
updates[].network.hostnames[] array of strings The hostnames that scans have associated with the asset record.
updates[].network.ssh_fingerprints[] array of strings The SSH key fingerprints that scans have associated with the asset record.
updates[].network.network_interfaces[] array of objects The network interfaces that scans identified on the asset.
updates[].network.network_interfaces[].name string The name of the network interface.
updates[].network.network_interfaces[].virtual boolean Indicates whether the network interface is virtual.
updates[].network.network_interfaces[].aliased boolean Indicates whether the network interface is aliased.
updates[].network.network_interfaces[].fqdns[] array of strings A list of FQDNs for the network interface.
updates[].network.network_interfaces[].mac_addresses[] array of strings The MAC addresses of the network interface.
updates[].network.network_interfaces[].ipv4s[] array of strings A list of IPv4 addresses belonging to the interface.
updates[].network.network_interfaces[].ipv6s[] array of strings A list of IPv6 addresses belonging to the interface.
updates[].network.open_ports[] array of objects An array of open ports and their services as reported by the info-level plugins.
updates[].network.open_ports[].port integer The open port number.
updates[].network.open_ports[].protocol string The communication protocol corresponding to the open port.
updates[].network.open_ports[].service_names[] array of strings The names of the services associated with the open port.
updates[].network.open_ports[].first_seen string The ISO timestamp when the source first detected the open port on the asset.
updates[].network.open_ports[].last_seen string The ISO timestamp when the source last detected the open port on the asset.
updates[].scan object An object containing scan-related information for the asset.
updates[].scan.first_scan_time string The time and date of the first scan run against the asset.
updates[].scan.last_scan_time string The time and date of the last scan run against the asset.
updates[].scan.last_authenticated_scan_date string The time and date of the last credentialed scan run on the asset.
updates[].scan.last_licensed_scan_date string The time and date of the last scan that identified the asset as licensed. Tenable Vulnerability Management categorizes an asset as licensed if a scan of that asset has returned results from a non-discovery plugin within the last 90 days.
updates[].scan.last_scan_id string The UUID of the scan configuration used during the last scan of the asset.
updates[].scan.last_schedule_id string The schedule_uuid for the last scan of the asset.
updates[].scan.last_authentication_attempt_date string The date when last authentication scan attempt was made.
updates[].scan.last_authentication_success_date string The date when last authentication scan attempt was successful.
updates[].scan.last_authentication_scan_status string The status of the last scan authentication (for example, SUCCESS).
updates[].scan.last_scan_target string The last scan target that was scanned.
updates[].timestamps object An object containing various timestamps related to the asset.
updates[].timestamps.created_at string The time and date when Tenable Vulnerability Management created the asset record.
updates[].timestamps.updated_at string The time and date when the asset record was last updated.
updates[].timestamps.deleted_at string The time and date when a user deleted the asset record. When a user deletes an asset record, Tenable Vulnerability Management retains the record until the asset ages out of the license count.
updates[].timestamps.terminated_at string The time and date when a user terminated the Amazon Web Service (AWS) virtual machine instance of the asset.
updates[].timestamps.first_seen string The time and date when a scan first identified the asset.
updates[].timestamps.last_seen string The time and date of the scan that most recently identified the asset.
updates[].custom_attributes[] array of objects A list of custom attributes for the asset.
updates[].custom_attributes[].id string The identifier for the custom attribute.
updates[].custom_attributes[].value string The value of the custom attribute.
updates[].ratings object A list of vulnerability ratings and score calculations. These ratings provide a comprehensive view of exposure. Currently, only the Asset Criticality Rating (ACR) and Asset Exposure Score (AES) are provided.
updates[].ratings.acr object The Tenable-defined Asset Criticality Rating (ACR) for the asset. Tenable uses an algorithm based on the asset profile to assign a metric rating the importance of an asset to your organization from 1 to 10, with higher numbers for more critical assets.
updates[].ratings.acr.score number The Asset Criticality Rating (ACR) value.
updates[].ratings.aes object The Tenable-defined Asset Exposure Score (AES) for the asset. This metric weighs an asset's Vulnerability Priority Rating (VPR) and Asset Criticality Rating (AES) and then assigns a number from 1 to 1000, with higher numbers for more exposed assets.
updates[].ratings.aes.score number The Asset Exposure Score (AES) value.
updates[].acr_score string (Tenable Lumin-only) The Asset Criticality Rating (ACR) for the asset.
updates[].exposure_score string (Tenable Lumin-only) The Asset Exposure Score (AES) for the asset.
deletes[] array of objects Contains the web app scanning asset objects deleted in the payload.
deletes[].id string The ID of the deleted web app scanning asset.
deletes[].deleted_at string An ISO timestamp indicating the date and time when the asset was deleted.
first_ts string A Unix timestamp indicating the date and time of the first entry in the payload.
last_ts string A Unix timestamp indicating the date and time of the last entry in the payload.