Add Asset Data to Tenable Security Center

Tenable recommends that you add asset data to Tenable Security Center as a static IP list of assets.

To add assets:

Authenticate, if you have not already done so. Be sure to include the authentication token in your request headers. For more information on authentication, see the description of the /token endpoint in the Tenable Security Center API reference guide.

Use the POST version of the /asset endpoint.

HTTP Request Syntax:

POST /rest/asset{parameters}

Recommended parameters include:

Parameter Value

Parameter	Value
`definedIPs`	Specifies the IP addresses for the assets you want to add. Use commas or newline characters (`\n`) to separate values in this field. This field can accept individual IP addresses, CIDR addresses, or IP address ranges. You can use multiple address types in a single entry. For example, the following valid value includes a single IP address, a CIDR address, and a range of IP addresses: “definedIPs”: “127.0.0.1,192.0.2.0/24,198.168.1.1-198.168.1.11” This parameter corresponds to the IP Addresses parameter in the custom asset list options in the SecurityCenter user interface.
`name`	Specifies the display name of the static IP list of assets. This parameter corresponds to the Name parameter in the custom asset list options in the Tenable Security Center user interface.
`type`	Specifies the type of custom asset list you are adding. Tenable recommends `static`.

definedIPs

Specifies the IP addresses for the assets you want to add.

Use commas or newline characters (\n) to separate values in this field.

This field can accept individual IP addresses, CIDR addresses, or IP address ranges. You can use multiple address types in a single entry. For example, the following valid value includes a single IP address, a CIDR address, and a range of IP addresses:

“definedIPs”: “127.0.0.1,192.0.2.0/24,198.168.1.1-198.168.1.11”

This parameter corresponds to the IP Addresses parameter in the custom asset list options in the SecurityCenter user interface.

name

Specifies the display name of the static IP list of assets.

This parameter corresponds to the Name parameter in the custom asset list options in the Tenable Security Center user interface.

type Specifies the type of custom asset list you are adding. Tenable recommends static.

For a full list of parameters for the /asset endpoint, see the Tenable Security Center API reference guide.

HTTP Request Example:

{
  "tags": "",
  "name": "static test list",
  "description": "",
  "context": "",
  "status": -1,
  "createdTime": 0,
  "modifiedTime": 0,
  "groups": [],
  "type": "static",
  "definedIPs": "127.0.0.1,198.168.1.1"
}

To verify that the system correctly added the assets, view the assets in the Tenable Security Center user interface, or use the /asset endpoint to Retrieve Asset Data from Tenable Security Center.