TOC & Recently Viewed

Recently Viewed Topics

Asset Objects

You can specify the attributes listed below in asset objects when adding asset data to Tenable.io.

Object Syntax

{ "tenable_uuid": {string}, "mac_address": [ {string} ], "netbios_name": {string}, "fqdn": [ {string} ], "ip_address": [ {string} ], "ipv4": [ {string} ], "ipv6": [ {string} ], "hostname": [ {string} ], "operating_system": [ {string} ], "ssh_fingerprint": {string}, "bios_uuid": {string}, "manufacturer_tpm_id": {string}, "mcafee_epo_guid": {string}, "mcafee_epo_agent_guid": {string}, "symantec_ep_hardware_key": {string}, "qualys_asset_id": {string}, "qualys_host_id": {string}, "servicenow_sys_id": {string}, "gcp_project_id": {string}, "gcp_zone": {string}, "gcp_instance_id": {string}, "azure_vm_id": {string}, "azure_resource_id": {string}, "aws_availability_zone": {string}, "aws_ec2_instance_id": {string}, "aws_ec2_instance_ami_id": {string}, "aws_ec2_instance_group_name": [ {string} ], "aws_ec2_instance_state_name": {string}, "aws_ec2_instance_type": {string}, "aws_ec2_name": {string}, "aws_ec2_product_code": [ {string} ], "aws_owner_id": {string}, "aws_region": {string}, "aws_subnet_id": {string}, "aws_vpc_id": {string} }

Object Attributes

The table below defines the attributes of an asset object.

Note: To add an asset object to Tenable.io, the asset object in the request must contain a value for at least one identifier attribute. The Required column in the table below indicates which attributes are required identifiers.

Attribute Type Description Required?
tenable_uuid string The UUID of the asset. excluded from add requests (system-generated)
mac_address array A list of MAC addresses for the asset. required identifier
netbios_name string

The NetBIOS name for the asset.

required identifier
fqdn array A list of FQDNs for the asset. required identifier
ip_address array A list of IPv4 addresses for the asset. Tenable.io supports this legacy field for backwards compatibility, but for new requests, this field should be replaced by the ipv4 field. required identifier (legacy)
ipv4 array A list of IPv4 addresses for the asset. required identifier
ipv6 array A list of IPv6 addresses for the asset. optional
hostname array A list of hostnames for the asset. optional
operating_system string The operating system installed on the asset. optional
ssh_fingerprint string

The SSH key fingerprints that scans have associated with the asset record.

optional
bios_uuid string

The BIOS UUID of the asset.

optional
manufacturer_tpm_id string

The manufacturer's unique identifier of the Trusted Platform Module (TPM) associated with the asset.

optional
mcafee_epo_guid string

The unique identifier of the asset in McAfee ePolicy Orchestrator (ePO) . For more information, see the McAfee documentation.

optional
mcafee_epo_agent_guid string

The unique identifier of the McAfee ePO agent that identified the asset. For more information, see the McAfee documentation.

optional
symantec_ep_hardware_key string

The hardware key for the asset in Symantec Endpoint Protection.

optional
qualys_asset_id string

The Asset ID of the asset in Qualys. For more information, see the Qualys documentation.

Note: Tenable is enabling Qualys asset import for customers in a rolling fashion. For more information, contact your Tenable representative.

optional
qualys_host_id string

The Host ID of the asset in Qualys. For more information, see the Qualys documentation.

Note: Tenable is enabling Qualys asset import for customers in a rolling fashion. For more information, contact your Tenable representative.

optional
servicenow_sys_id string

The unique record identifier of the asset in ServiceNow. For more information, see the ServiceNow documentation.

optional
gcp_project_id string

The customized name of the project to which the virtual machine instance belongs in Google Cloud Platform (GCP). For more information, see Creating and Managing Projects in the GCP documentation.

optional
gcp_zone string

The zone where the virtual machine instance runs in GCP. For more information, see Regions and Zones in the GCP documentation.

optional
gcp_instance_id string

The unique identifier of the virtual machine instance in GCP.

optional
azure_vm_id string

The unique identifier of the Microsoft Azure virtual machine instance. For more information, see Accessing and Using Azure VM Unique ID in the Microsoft Azure documentation.

optional
azure_resource_id string

The unique identifier of the resource in the Azure Resource Manager. For more information, see the Azure Resource Manager Documentation.

optional
aws_availability_zone string

The availability zone where Amazon Web Services hosts the virtual machine instance, for example, "us-east-1a". Availability zones are subdivisions of AWS regions. For more information, see Regions and Availability Zones in the AWS documentation.

optional
aws_ec2_instance_id string

The unique identifier of the Linux instance in Amazon EC2. For more information, see the Amazon Elastic Compute Cloud Documentation.

optional
aws_ec2_instance_ami_id string

The unique identifier of the Linux AMI image in Amazon Elastic Compute Cloud (Amazon EC2). For more information, see the Amazon Elastic Compute Cloud Documentation.

optional
aws_ec2_instance_group_name array

The virtual machine instance's group in AWS.

optional
aws_ec2_instance_state_name string

The state of the virtual machine instance in AWS at the time of the scan.

optional
aws_ec2_instance_type string

The type of instance in AWS EC2.

optional
aws_ec2_name string

The name of the virtual machine instance in AWS EC2.

optional
aws_ec2_product_code array

The product code associated with the AMI used to launch the virtual machine instance in AWS EC2.

optional
aws_owner_id string

The canonical user identifier for the AWS account associated with the asset, for example, "79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be". For more information, see AWS Account Identifiers in the AWS documentation.

optional
aws_region string

The region where AWS hosts the virtual machine instance, for example, "us-east-1". For more information, see Regions and Availability Zones in the AWS documentation.

optional
aws_subnet_id string

The unique identifier of the AWS subnet where the virtual machine instance was running at the time of the scan.

optional
aws_vpc_id string

The unique identifier for the virtual public cloud that hosts the AWS virtual machine instance. For more information, see the Amazon Virtual Private Cloud User Guide.

optional

Object Example

{ "tenable_uuid": "6edeee7cf86e47adb4f6f61cb9184eaa", "mac_address": [ { "00-00-5E-00-53-00", "00-00-5E-00-53-FF" } ], "netbios_name": "COMPUTERNAME1", "fqdn": [ { "example.com" } ], "ip_address": [], "ipv4": [ { "172.204.81.57", "172.82.157.177" } ], "ipv6": [ { "2001:DB8:1234:1234/32" } ], "hostname": [ { "rhel6x86.target.example.com" } ], "operating_system": [ { "Linux Kernel 2.6.32-71.el6.i686 on Red Hat Enterprise Linux Server release 6.0 (Santiago)" } ], "ssh_fingerprint": "423fa07b4a12f386149e09ea10021a89", "bios_uuid": "423ee0f1-0032-700c-afd7-a686d88da63e", "manufacturer_tpm_id": null, "mcafee_epo_guid": null, "mcafee_epo_agent_guid": null, "symantec_ep_hardware_key": null, "qualys_asset_id": null, "qualys_host_id": null, "servicenow_sys_id": null, "gcp_project_id": null, "gcp_zone": null, "gcp_instance_id": null, "azure_vm_id": null, "azure_resource_id": null, "aws_availability_zone": null, "aws_ec2_instance_id": null, "aws_ec2_instance_ami_id": null, "aws_ec2_instance_group_name": [], "aws_ec2_instance_state_name": null, "aws_ec2_instance_type": null, "aws_ec2_name": null, "aws_ec2_product_code": [], "aws_owner_id": null, "aws_region": null, "aws_subnet_id": null, "aws_vpc_id": null }

Copyright © 2019 Tenable, Inc. All rights reserved. Tenable, Tenable.io, Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc.. Tenable.sc, Lumin, Assure, and the Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.