Generate an Asset Query with the Asset Query Builder

Required User Role: Basic User, Scan Operator, Standard User, Scan Manager, Administrator, or Custom Role

Important: The following feature is only available for customers using the Legacy Tenable One or Tenable One Advanced licensing packages. For more information, see Tenable One Foundation / Tenable One Advanced Licensing in the Tenable Licensing Quick Reference Guide.

You can use the Asset Query Builder to generate an interactive list of your nodes (assets and asset groups).

To generate a custom asset query:

  1. Access the Top Attack Paths tab.

  2. In the Custom Queries section, click Asset Query Builder.

    The Query Builder pane appears.

  3. For each asset you want to include in the query:

    1. Select the radio button next to the type of origin you want to use for the query:

      • Asset type — Generate a query based on a certain type of asset.

      • Specific asset — Generate a query based on a specific asset.

    2. In the text box, type the asset type or specific node/asset you want to use for the query.

    3. (Optional) To apply filters to the asset query:

      1. Click the button.

        The Filters window appears.

      2. In the Parameter drop-down, select the parameter by which you want to filter the origin.

      3. In the Operator drop-down, select the operator to apply to the parameter.

      4. In the text box, type or select the value or values you want to use for the filter.

        Note: The values you can use differ depending on the parameter you selected.

      5. Click Apply and search.

        Tenable Exposure Management applies the filter to the asset query.

  4. (Optional) Click Add an Asset to add additional assets to the query.

  5. Click Search .

    Tenable Exposure Management returns any assets and/or asset groups that match the query you created. For more information on interacting with the data, see Interact with Asset Query Data.

  6. (Optional) To reset the query pane, at the top of the pane, click the button.

    Tenable Exposure Management resets the selections within the pane.

(Optional) Save your Query as a Preset/Bookmark

Required User Role: Standard User, Scan Manager, Administrator, or Custom Role

Once you've built your custom query, you can save it as a preset, where you can then access it as a bookmark when creating new built-in attack path queries.

To save your query as a preset:

  1. At the top of the pane, click the button.

    The Save as preset window appears.

  2. In the Name of preset text box, type a name for the query.

  3. In the Description of preset text box, type a description of the query.

  4. Click Save preset.

    Tenable Exposure Management saves the query as a preset. You can access your saved queries in the Bookmarks section of the Query Library.

Tip: When you save a query as a preset, you can use it as a filter on the Top Attack Paths tab.

What to Do Next

Interact with the asset data provided by the query.