TOC & Recently Viewed

Recently Viewed Topics

Add Asset Data to SecurityCenter

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

To add assets:

  1. 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 SecurityCenter API reference guide.
  2. Use the POST version of the /asset endpoint.

    HTTP Request Syntax:

    POST /rest/asset{parameters}

    Recommended parameters include:

    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,172.36.48.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 SecurityCenter 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 SecurityCenter 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" }
  3. To verify that the system correctly added the assets, view the assets in the SecurityCenter user interface, or use the /asset endpoint to Retrieve Asset Data from SecurityCenter.

 

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