Tenable Security Center
Integrate Tenable Security Center to retrieve your scanned hosts, their software, vulnerabilities and compliance results
The Tenable Security Center connector retrieves into OverView the hosts scanned by your on-premises Tenable Security Center (formerly Tenable.sc): their network interfaces, operating system, hardware (manufacturer, model, serial number) and last logged-on user, their installed software and open ports, the vulnerabilities detected on them (plugin, severity, CVE, CVSS, EPSS and VPR scores, CISA KEV, status, first and last seen dates) and the results of compliance audits (CIS, DISA STIG and similar benchmarks, with passed and failed rules).
Installed software, hardware and the last logged-on user are reported by credentialed scans and Nessus Agents: hosts covered only by unauthenticated scans provide their network information and remotely detected vulnerabilities.
API access is the recommended method for this connector. Where it is not available (a segregated network, a version without API keys), OverView accepts CSV exports from Security Center, described in Alternative: import CSV exports.
Prerequisites
- Tenable Security Center 5.13 or later, the first version with API key authentication. The menu paths below are those of Security Center 6.x.
- An Administrator account to enable API key authentication, and the Security Manager account of the organization whose data you want to import, to create the dedicated user
- Network access from OverView to the Security Center web interface (HTTPS, port 443 by default)
Information to provide in OverView
| Field | Description |
|---|---|
| API URL* | The URL you use to open Tenable Security Center in a browser, without a trailing slash (e.g., https://securitycenter.example.com, or https://securitycenter.example.com:8443 on a non-standard port). The connector appends /rest/ itself, so do not add it. |
| Access Key* | Access key of the API key pair generated for the dedicated user |
| Secret Key* | Secret key of the API key pair generated for the dedicated user |
Parameters
These parameters are optional. Leave them at their default value unless you have a specific reason to change them.
| Parameter | Description | Default |
|---|---|---|
| Verify SSL Certificate | Verifies the TLS certificate presented by Security Center. Disable it only if your Security Center still uses its self-signed certificate. | Enabled |
| Include Informational Findings | Also imports the informational findings (severity Info) as vulnerabilities. They usually outnumber the actual vulnerabilities by far and significantly increase the import volume. Installed software and open ports are imported whatever this setting. | Disabled |
Procedure
Enable API key authentication
API keys are disabled until an administrator enables them. Without this step, the API Keys option does not appear in the user actions menu.
- Sign in with an Administrator account and click System > Configuration.
- Click the Security tile.
- In Authentication Settings, enable Allow API Keys, then click Submit.
Create a dedicated user
Vulnerability data belongs to an organization. Administrator accounts do not belong to any organization and have no access to it, so the connector uses an organizational user.
- Sign in with the Security Manager account of the organization and click Users > Users.
- Click Add and fill in:
- Username and Password (e.g.,
overview-connector) - Role: Security Analyst
- Group: a group with access to every repository you want to import
- User Must Change Password and Password Expiration: leave disabled, a blocked account cannot use its API keys
- Username and Password (e.g.,
- Click Submit.
The group, not the role, defines which data the user sees. In Users > Groups, right-click the group and click View: the Access section must list every repository to import in Repositories, with Viewable Hosts set to All Defined Ranges. A repository missing from the group is missing from the import.
Generate the API keys
- In Users > Users, right-click the row of the dedicated user, then click API Keys > Generate API Key.
- Confirm the generation.
- In the Your API Key window, copy the Access Key and the Secret Key immediately.
The secret key cannot be displayed again once the window is closed. If you lose it, generate a new key pair: the previous keys are replaced and immediately stop working.
Configure the Connector in OverView
- In OverView, go to Data Sources Settings > Sources.
- Select Tenable Security Center and click Configure.
- Fill in the API URL, Access Key and Secret Key, then click Save Configuration.
Required Permissions
The API keys inherit the role, organization and group of their user. The Security Analyst role is the one Tenable requires for its own API integrations (Splunk, IBM QRadar). The connector only reads data; it never creates, modifies or launches anything in Security Center.
| Data retrieved | Endpoint | Requirement |
|---|---|---|
| Credential check | GET /rest/system, GET /rest/currentUser | Any user with API keys |
| Hosts | POST /rest/analysis (tool: sumip, sourceType: cumulative) | Organizational user whose group has access to the repositories |
| Vulnerabilities, compliance results, installed software, open ports, hardware and users | POST /rest/analysis (tool: vulndetails, sourceType: cumulative) | Same user |
| Host last seen date (optional, Security Center 5.20 or later) | GET /rest/hosts | Same user |
Security Center returns 400 Bad Request rather than 403 when the user behind the API keys lacks the permission for a request.
Verify the access
From a machine that can reach Security Center, run:
curl -k -H "x-apikey: accesskey=ACCESS_KEY; secretkey=SECRET_KEY" \
"https://securitycenter.example.com/rest/currentUser?fields=username,role,organization,group"
The response must show the dedicated user, a role other than Administrator, and the expected organization and group.
Security Best Practices
- Use a dedicated user for the OverView integration rather than a personal account
- Keep the user in a group limited to the repositories you want to import
- Rotate the API keys regularly according to your organization's security policy: generating a new pair immediately revokes the previous one
Alternative: import CSV exports
Where API access is not available, OverView imports the CSV files exported from the Vulnerabilities and Host Assets pages of Security Center. Produce them with an organizational user, whose group scopes the exported data exactly like the API, and repeat the export after each scan cycle.
Export vulnerabilities from Tenable Security Center
- Click Analysis > Vulnerabilities and select the Vulnerability Detail List tool, so that each row is one vulnerability on one host.
- Click Export > Export as CSV.
- Select the columns to include, then click Submit.
- Above 1,000 rows, Security Center asks for a report name and generates the file in the background: download it from Reporting > Report Results.
Export hosts from Tenable Security Center
- Click Assets > Host Assets.
- Click Export at the top of the table to download the CSV file.
Import into OverView
- In OverView, go to Data Sources Settings > Sources.
- Select Tenable Security Center and click Configure.
- Choose the File Import mode, import your export files, then click Save Configuration.
Alternative: file import through DropPoint
The API access described above is the recommended method for this connector. Where it is not available (a segregated network, a version or licence without API, an export you already produce), OverView accepts file exports, to be uploaded to the bucket dedicated to Tenable Security Center.
Bucket : s3://tenable_sc/
Example : s3://tenable_sc/export.csv
The procedure is described in the OverView DropPoint guide: generating credentials, configuring the client, then sending files from the OverView web interface, the AWS CLI or an SDK. Its examples come pre-filled with this bucket when you follow this link.