API Integrations
This page explains the process for integrating with Tenable IO and Tenable SC.
This is a licensed feature. Contact your Account Manager to add these integrations to your PlexTrac instance.
Licensed integrations are currently found in two locations within the Admin Dashboard:
  • For HackerOne and Snyk: Admin Dashboard>Tools & Integrations>Integrations
  • For Tenable IO and Tenable SC: Admin Dashboard>API Integrations>Tenable IO Integration OR Tenable SC Integration
For information about HackerOne and Snyk integrations, visit the Integrations (Licensed) page.

Integration Process

The Tenable integration is a micro service executed via a report findings import that involves the following process:
  • PlexTrac's backend makes a request to the customer's Tenable IO or SC instance
  • PlexTrac's pulls the requested data
  • PlexTrac transforms the data into a format that can be imported into the report
  • PlexTrac imports the data into an existing report
Once the data has been imported, the user is alerted via the notification bell within PlexTrac. A notification is also sent if an import failure occurs.

License Status

Tenable integrations require a license. To validate license status, go to the Admin Dashboard and click the appropriate button under "API Integrations."
If an integration has not been licensed, the following messages with account sales contact information will appear:
or
Once the integration has been licensed, clicking the appropriate button under "API Integrations" will result in the following messages appearing and the integration process can begin.
or

Integrating Tenable IO

A Tenable IO API Access and Secret key that has Administrator [64] permissions will need to be generated before beginning this process. Visit Tenable's Generate API Keys page for more information.
Step 1: From the Admin Dashboard, click Tenable IO Integration under "API Integrations."
Step 2: If the tenant is licensed, the option to configure will appear on the page. Click Configure Tenable IO Integration.
Step 3: Enter the Access Key and Secret Key. Unless hosting a PlexTrac instance, leave the Tenable Domain field blank. Click Save.
Step 4: A Sync Now button and integration details information appears on the page. Click Sync Now.
If the keys are correct no error message will appear and a confirmation message will confirm successful synchronization.

Integrating Tenable SC

A Tenable SC API Access and Secret key that has Administrator [64] permissions will need to be generated before beginning this process. Visit Tenable's Enable API Key Authentication page for more information.
Step 1: From the Admin Dashboard, click Tenable SC Integration under "API Integrations."
Step 2: If the tenant is licensed, the option to configure will appear on the page. Click Configure Tenable SC Integration.
Step 3: Enter the Access Key and Secret Key. Unless hosting a PlexTrac instance, leave the Tenable Domain field blank. Click Save.
Step 4: A Sync Now button and integration details information appears on the page. Click Sync Now.
If the keys are correct no error message will appear and a confirmation message will confirm successful synchronization.
Click Next below to learn about the Help Center.