Added

Vulnerability Management: Plugin Update Interval for Sensor Profiles

Tenable has added the plugin_update_interval_hours parameter to the agent and scanner profile endpoints in Tenable Vulnerability Management. This parameter enables you to configure how frequently sensors assigned to a profile check for plugin updates, with intervals as frequent as once per hour instead of the default 24 hours. This helps new plugins reach your sensors sooner.

The Tenable Vulnerability Management interface presents this setting as the Set plugin check in cadence option.

Parameters

Specify the following property in the config object of the request body:

ParameterData TypeDescription
plugin_update_interval_hoursIntegerSpecifies how frequently sensors assigned to the profile check for plugin updates, in hours. Supported values are 1 through 24. If omitted or set to null, the default interval is 24 hours.

A value outside the supported range, or a value that is not a whole number, returns a 400 response.

📘

Note

This feature requires Tenable Agent version 11.2.4 or later for agent profiles and Tenable Nessus version 10.12.7 or later for scanner profiles.

Affected Endpoints

The following endpoints have been updated:

API EndpointNameUpdate
POST /sensors/profiles/{sensor_type}Create profileAccepts plugin_update_interval_hours in the config object of the request body.
PUT /sensors/profiles/{sensor_type}/{profile_uuid}Update profileAccepts plugin_update_interval_hours in the config object of the request body.
GET /sensors/profiles/{sensor_type}List profilesReturns plugin_update_interval_hours for each profile with the setting configured.
GET /sensors/profiles/{sensor_type}/{profile_uuid}Get profile detailsReturns plugin_update_interval_hours when the profile has the setting configured.

Both agent and scanner profiles support this property. Specify agent or scanners for the {sensor_type} path parameter.

Example Request

For example, to create an agent profile whose agents check for plugin updates every four hours, use the following cURL request:

curl --request POST \
     --url https://cloud.tenable.com/sensors/profiles/agent \
     --header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "US-1A Sensors",
  "description": "This profile targets sensors for US-1A.",
  "config": {
    "plugin_update_interval_hours": 4
  }
}
'