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 identity 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