Tenable Vulnerability Management - Add IP Addresses to Tag Value

Tenable Vulnerability Management - Add IP Addresses to Tag Value adds IP addresses from Axonius assets to an existing tag value in Tenable Vulnerability Management for:

  • Assets returned by the selected query or assets selected on the relevant asset page.

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

When accessing an enforcement action using the API, you must use the backend form of field names.

Use the Syntax Helper to find the correct name. In the enforcement action, enable Configure Dynamic Values and select Syntax Helper.

Note

Prerequisites

APIs

Axonius uses the Tenable Vulnerability Management API.

Required Ports

Axonius must be able to communicate via the following ports:

  • Port 443 (HTTPS)

Required Permissions

  • Standard User [32] user role. This role has permissions to read and update tags in Tenable Vulnerability Management.

Required Fields

These fields must be configured to run the Enforcement Set.

  • Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
  • Configure Dynamic Values (optional) - 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 Vulnerability Management Adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.

    • When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.

    Note

    To use this option, you must successfully configure a Tenable Vulnerability Management adapter connection.

  • Tag value name - The name of an existing tag value in Tenable Vulnerability Management. The tag value must already exist and must be unique across all tag categories. If multiple tag values have the same name in different categories, the action will fail with an error.

  • Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.


Additional Fields

These fields are optional.

💡

Connection and Credentials

When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

  • Tenable Vulnerability Management domain (optional, default: empty) - The IP address or hostname of your Tenable Vulnerability Management management server.

  • Access API key and Secret API key - These values must be created in the Tenable Vulnerability Management console. To generate an API key in the Tenable Vulnerability Management console, see Tenable Vulnerability Management - Generate an API Key.

  • Verify SSL (Optional) (default: enabled) - Selects whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings. This setting is enabled by default on all new adapter settings. If you need to disable SSL verification, make sure you disable this setting.)

  • HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.

  • IPs to add (overrides other IP selection options) - Enter the IP addresses to add to the tag value. Comma-separated values are accepted. Empty values and duplicates are ignored. This field overrides IP Source Field Mapping and the other IP selection options. If you set this field per asset using Dynamic Values, each asset updates the tag separately and in parallel, so the updates can overwrite one another. To use one IP field for all assets, use IP Source Field Mapping.
  • IP Source Field Mapping - Select one or more Axonius fields that hold IP addresses, for example a management IP field. When you select more than one field, they are used in priority order, and for each asset the first field that has a value is used instead of the network interface IP addresses. Leave empty to use the default IP extraction (network interfaces, Public IPs field).

Note

  • The IP addresses to add are selected in this order: IPs to add, then IP Source Field Mapping, then network interfaces and the Public IPs field.
  • When you use IP Source Field Mapping, the Use public IP addresses, Use private IP addresses, Exclude IPv6 addresses, and Add Hostnames to Scan options, and the CIDR exclusion list still apply.
  • A Tenable Vulnerability Management tag filter holds up to 1,024 IP addresses. If the selected IP addresses (together with the IP addresses already in the tag value, when Override current IP address List is cleared) exceed this limit, the action fails before calling Tenable and the message shows the tag value name and the number of IP addresses. To resolve this, narrow the query or split the assets across several tag values.
  • Use public IP addresses - Include public IP addresses from Axonius assets when adding to the tag value.
  • Use private IP addresses - Include private IP addresses from Axonius assets when adding to the tag value.
  • Exclude IPv6 addresses - When enabled, excludes IPv6 addresses and only includes IPv4 addresses.
  • Override current IP address List - When enabled, replaces all existing IP addresses in the tag value with the new list. When disabled, appends the new IP addresses to the existing list.
  • Add Hostnames to Scan - When enabled, includes hostnames from Axonius assets in addition to IP addresses.
  • Use preferred hostname FQDN - When enabled and Add Hostnames to Scan is selected, uses the preferred FQDN from Axonius for each asset.
  • Use AWS Public Dns as hostname - When enabled and Add Hostnames to Scan is selected, uses the AWS public DNS name for AWS assets.
  • Use Public IPs field - When enabled, uses the Public IPs field from Axonius instead of parsing IP addresses from network interfaces.


For more details about other enforcement actions available, see Action Library.


Did this page help you?