Tenable.sc API: Configuration Section

/configSection

Methods
GET

Gets the Configuration Sections

Request Parameters

None

Example Response
Expand
{
	"type" : "regular",
	"response" : [
		{
			"id" : 0,
			"name" : "Plugins",
			"description" : "Review and apply license information for Tenable products"
		},
		{
			"id" : 1,
			"name" : "Mail",
			"description" : "Configure SMTP settings for sending e-mail from Tenable.sc"
		},
		null,
		{
			"id" : 3,
			"name" : "Security",
			"description" : "Configure login and display security settings"
		},
		{
			"id" : 4,
			"name" : "Miscellaneous",
			"description" : "Settings for Web Proxy, Syslog, Notifications, and additional report types"
		},
		{
			"id" : 5,
			"name" : "Data Expiration",
			"description" : "Settings for how long data is retained"
		},
		{
			"id" : 6,
			"name" : "External Schedules",
			"description" : "Configure data retrieval settings for NNM and LCE"
		},
		{
			"id" : 7,
			"name" : "Plugins / Feed",
			"description" : "Manage Tenable plugins and feeds"
		},
		{
			"id" : 8,
			"name" : "SAML",
			"description" : "Settings for SAML 2.0 identity provider or Shibboleth idenity provider"
		}
	],
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1549381986
}

/configSection/{id}

Methods
GET

Gets the Configuration Section associated with {id}.

NOTE: For id "8", the /saml/{id}::GET endpoint is a direct alias and may also be used (see the SAML).

Request Query Parameters

None

Example Response
Expand
{
	"type" : "regular",
	"response" : {
		"id" : "1",
		"name" : "Mail",
		"description" : "This is the Mail section.",
		"SMTPHost" : "",
		"SMTPAuth" : "",
		"SMTPConnection" : "",
		"SMTPPort" : "",
		"SMTPUsername" : "",
		"SMTPPassword" : "",
		"SMTPReturnAddress" : "",
		"SMTPHostname" : ""
	},
	"error_code" : 0,
	"error_msg" : "",
	"warnings" : [],
	"timestamp" : 1410211451
}

PATCH

Edits the Configuration Section associated with {id}, changing only the passed in fields.

NOTE: For id "8", the /saml/{id}::PATCH endpoint is a direct alias and may also be used (see the SAML).

Request Parameters

(All fields are optional)

Expand

NOTE: For valid names for section types, perform /configSection/{id}::GET on desired configuration section type.

{
    <name:string> : <value:string>...
}
Example Response
See /configSection/{id}::GET