- 10 Oct 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
Tenable.io - Delete Asset
- Updated on 10 Oct 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
Tenable.io - Delete Asset deletes assets from Tenable.io for:
- Assets that match the results of the selected saved query, and match the Enforcement Action Conditions, if defined or assets selected on the relevant asset page.
Tenable.io assets are entities of value on a network, that can be exploited. This includes laptops, desktops, servers, routers, mobile phones, virtual machines, software containers, and cloud instances.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapter Fetch History and Asset Investigation Modules
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
Use stored credentials from the Tenable.io Adapter - Select this option to use the the first connected Tenable.io adapter credentials.
- When you select this option, the Select Adapter Connection drop-down is available, and you can choose which adapter connection to use for this Enforcement Action.
NOTETo use this option, you must successfully configure a Tenable.io adapter connection.
Required Fields
These fields must be configured to run the Enforcement Set.
Instance Name - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
- Hard delete - Select to completely remove the assets along with all related data. When not selected, only the assets are removed. Related data is kept.
Tunnel Name - For Axonius-hosted (SaaS) deployments. Select the tunnel through which to connect to perform the action.
Connection Parameters
If Use stored credentials from the Tenable.io Adapter is disabled, these fields are required.
Tenable.io domain - The IP address or hostname of your Tenable.io management server.
Access API key and Secret API key (required) - These values must be created in the Tenable.io console. To generate an API key in the Tenable.io console, see Tenable.io - Generate an API Key.
Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
HTTPS proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
APIs
Axonius uses the Tenable.io Bulk Delete Assets API.
Required Ports
Axonius must be able to communicate to Tenable.io via the following ports:
- TCP port 80
Required Permissions
The Tenable.io user account must have ADMINISTRATOR (64) permissions.
Version Matrix
This Enforcement Action has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.
Version | Supported | Notes |
---|---|---|
Tenable.io v1.0 | Yes |
For more details about other Enforcement Actions available, see Action Library.