Skip to main content
Version: 0.9

Tenable Security Center (WIP)

Reads Tenable Security Center (on-premises, formerly Tenable.sc) and does two things:

  • Endpoints. Every host Security Center has scanned is created or enriched as an endpoint, like any other endpoint integration.
  • Vulnerabilities. Every finding on those hosts, open and fixed, is kept with its history in the tenant's vulnerability index, apart from the endpoints. Dashboards, risk and remediation reporting read it.
Type nametenable_sc
CreatesEndpoints
Runs onA sensor with HTTPS reach to Security Center
Presence flagtsc_exists
Field prefixtsc_
Vulnerability indexvulns-<tenant id>

How it reads Security Center​

Everything comes from Security Center's analysis API, which only queries: nothing is changed in Security Center. Each run reads, for the configured repositories:

WhatSecurity Center's viewBecomes
Scanned hostsThe IP summary of the cumulative databaseEndpoints
Open findingsVulnerability details, cumulative databaseFindings in the vulnerability index
Fixed findingsVulnerability details, mitigated databaseFindings in the vulnerability index

Each run reads them whole. Security Center answers a few thousand findings in a few seconds, and reading everything is what lets a run tell which findings are no longer reported at all.

Endpoints​

Matching​

A host is matched to the endpoint it already is by, strongest first:

  1. Its Security Center host key: the repository and Security Center's host UUID.
  2. The Nessus agent that scanned it: the same agent the Nessus agents integration records.
  3. Its name and its IP address together.
  4. Its name, short or fully qualified.
  5. Its IP address, only on an endpoint whose name does not say it is another host.

A host known by nothing but an address, which is typical of an uncredentialed sweep, enriches the endpoint it matches but never creates one.

What it writes​

Security Center is a scanner's view of the host. The shared fields names, fqdn, domains, os, type, mac and private_ip are written only when empty, so what an agent on the host reported stays.

FieldHolds
tsc_host_key, tsc_host_uuidHow Security Center tells the host apart
tsc_agent_uuidThe Nessus agent behind an agent scan
tsc_ip, tsc_dns_name, tsc_netbios_name, tsc_macThe host's addresses and names
tsc_os, tsc_bios_guidIts operating system, from Security Center's CPE, and its BIOS GUID
tsc_repository, tsc_policy, tsc_plugin_setWhere its data lives and how it was last scanned
tsc_last_auth_scan, tsc_last_unauth_scanIts last credentialed and uncredentialed scans
tsc_critical, tsc_high, tsc_medium, tsc_lowIts open findings by severity
tsc_score, tsc_acr, tsc_aesSecurity Center's vulnerability score, asset criticality rating and asset exposure score

The two last-scan dates are decommissioning evidence: a scan only finds a host that is there.

Vulnerabilities​

One document per finding​

A finding is one plugin on one host, port and protocol. It keeps the same document for its whole life, open, fixed or back again, so a run never duplicates one.

FieldHolds
asset_idThe endpoint the host is. Findings are written after the endpoints are synced, so a host created by the same run is linked at once
plugin_id, plugin_name, familyWhat was found
severity, severity_name, risk_factorHow bad: 0 Info to 4 Critical
cve, cvss2, cvss3, cvss3_vector, cvss4, vpr, epssScores and the CVEs it covers
exploit_available, exploit_ease, exploit_frameworksWhether it can be exploited
port, protocolWhere on the host
synopsis, solution, description, plugin_output, see_also, xrefThe plugin's text, cut to a few thousand characters
vuln_published, patch_published, plugin_published, plugin_modifiedPublication dates
accept_risk, recast_riskWhether the finding's risk was accepted or recast in Security Center
ip, dns_name, netbios_name, host_key, repository_*The host as Security Center reported it

Its lifecycle​

FieldHolds
stateopen, fixed, reopened (fixed once and found again) or removed
first_seen, last_seenFirst and last time a scan found it
fixed_atThe scan that found it fixed, the most recent time
reopened_at, reopen_countWhen it last came back, and how often
removed_atWhen Security Center stopped reporting it at all
historyEvery change of state with its time, the latest 50

A finding is removed when a run that read everything finds it neither open nor fixed. Its host was removed from Security Center, or its data aged out, without a scan finding the finding fixed. It is not counted as remediated.

Security Center forgets fixed findings; the index does not

Security Center keeps fixed findings for a short while only, often a few weeks. The vulnerability index keeps every finding it has seen, so history builds up from the first run onwards. What was fixed before the first run and has already gone from Security Center cannot be recovered.

Informational findings​

Findings of severity Info are mostly inventory and configuration facts, and are usually the large majority of what a scan reports. They are left out unless Include informational findings is on.

Requirements​

Network access​

FromToProtocolPort
The sensor running the integrationSecurity CenterHTTPS over TCP443

Access in Security Center​

NeedWhy
API keys of a Security Center userGenerated in Security Center under the user's API keys. API keys must be enabled for the organisation
That user able to read the vulnerability data of the repositoriesEvery read is an analysis query scoped to those repositories

Give the integration a user of its own whose role can only read the repositories it needs. An administrator's keys work, but carry far more than the integration needs.

TODO

Confirm the least-privileged Security Center role that can run vulnerability analysis on a repository.

Configuration​

FieldRequiredNotes
NameYesLabel for this instance
URLYesSecurity Center, e.g. https://securitycenter.contoso.com
Access KeyYesThe API access key
Secret KeyYesThe API secret key
RepositoriesNoComma-separated repository names or IDs that belong to this tenant. Empty reads every repository the user can see
CookiesNoFor a Security Center behind an access gateway: name=value; name2=value2
Proxy settingsNohttp://host:port
Ignore SSLNoSkips certificate validation. Install Security Center's CA on the sensor instead where possible: the API keys are sent on every request
SensorYesSensor that will run the integration
Repositories separate tenants

When one Security Center serves several organisations, list each tenant's repositories on its own instance. An instance with no repositories listed reads everything its user can see.

Its scan template adds:

OptionDefaultEffect
VulnerabilitiesOnKeeps every finding in the vulnerability index. Off reads the hosts only
Include informational findingsOffAlso keeps severity Info findings

See also​