# Tenable Security Center

This document explains how to integrate Tenable Security Center
with Google Security Operations (Google SecOps).

## Before you begin

To configure the Tenable Security Center integration, you must first obtain the
necessary connection credentials and confirm you understand the required
authentication method.

### Authentication prerequisites

The integration supports two mutually exclusive authentication methods. You must
provide one complete pair of credentials.

- **Username and password**: Use your standard login credentials.

- **Access Key and Secret Key (Recommended)**: This method uses API key
  authorization and takes priority if both credential pairs are provided.

  To generate these keys, see
  [API Key Authorization](https://docs.tenable.com/security-center/best-practices/api/Content/APIKeyAuthorization.htm#x-apikey-Header-Element).

### SSL verification

The integration verifies the SSL certificate of the Tenable Security Center
server by default. If your environment uses a self-signed or internal
certificate, you must disable the `Verify SSL` setting.

### Integration inputs

To configure the integration, use the following parameters:

> [!NOTE]
> **Note:** If `Username`, `Password`, `Access Key`, and `Secret Key` are all provided, the integration uses `Access Key` and `Secret Key` for authentication.

| Parameters ||
|---|---|
| `Server Address` | *Required* The address of the Tenable Security Center server to use in the integration. |
| `Username` | *Optional* Username to sign in to the Tenable Security Center server. Both `Username` and `Password` must be provided. |
| `Password` | *Optional* Password to sign in to the Tenable Security Center server. Both `Username` and `Password` must be provided. |
| `Access Key` | *Optional* Access Key of the Tenable Security Center account. Both `Access Key` and `Secret Key` must be provided. |
| `Secret Key` | *Optional* Secret Key of the Tenable Security Center account. Both `Access Key` and `Secret Key` must be provided. |
| `Verify SSL` | *Optional* If selected, verifies that the SSL certificate for the connection to the Tenable server is valid. Selected by default. |

## Actions

### Add IP To IP List Asset

Add an IP to IP list asset in Tenable Security Center.

#### Parameters

| **Parameter Display Name** | **Type** | **Default Value** | **Is Mandatory** | **Description** |
|---|---|---|---|---|
| Asset Name | String | N/A | Yes | Specify the name of the IP list asset to which you want to add new IPs. |

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    {
        "type": "regular",
        "response": {
            "id": "41",
            "name": "api_test_5",
            "type": "static",
            "description": "",
            "tags": "qweqwe",
            "context": "",
            "status": "0",
            "createdTime": "1606129689",
            "modifiedTime": "1606129689",
            "ioSyncStatus": "Not Synced",
            "ioFirstSyncTime": "-1",
            "ioLastSyncSuccess": "-1",
            "ioLastSyncFailure": "-1",
            "ioSyncErrorDetails": null,
            "typeFields": {
                "definedIPs": "203.0.113.1,203.0.113.10"
            },
            "repositories": [
                {
                    "ipCount": "-1",
                    "repository": {
                        "id": "1",
                        "name": "Example-Repository",
                        "description": ""
                    }
                }
            ],
            "ipCount": -1,
            "groups": [],
            "assetDataFields": [],
            "canUse": "true",
            "canManage": "true",
            "creator": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "owner": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "ownerGroup": {
                "id": "0",
                "name": "Full Access",
                "description": "Full Access group"
            },
            "targetGroup": {
                "id": -1,
                "name": "",
                "description": ""
            },
            "template": {
                "id": -1,
                "name": "",
                "description": ""
            }
        },
        "error_code": 0,
        "error_msg": "",
        "warnings": [],
        "timestamp": 1606129688
    }

##### Case wall

| **Result type** | **Value/Description** | **Type** |
|---|---|---|
| Output message\* | **The action should not fail nor stop a playbook execution:** **If static code 200(is_success = true):** print "Successfully added the following IPs to the IP List Asset {0} in Tenable Security Center:\\n{1}".format(name, entity.identifier) **If no IP entities:** No IP addresses were added to the IP List Asset {0}.format(name) **The action should fail and stop a playbook execution:** **if fatal error, like wrong credentials, no connection to server, other:** print "Error executing action "Add IP to IP List Asset". Reason: {0}''.format(error.Stacktrace) <br /> **If asset not found:** print "Error executing action "Add IP to IP List Asset". Reason: Asset {0} was not found in Tenable Security Center. **''.format(error.Stacktrace)** **If not static code 200 (is_success = false):** print "Error executing action "Add IP to IP List Asset". Reason: {0}''.format(error_msg) | General |

### Create IP List Asset

Create an IP list asset in Tenable Security Center. Requires at least one IP
entity for a successful execution.

#### Parameters

| **Parameter Display Name** | **Type** | **Default Value** | **Is Mandatory** | **Description** |
|---|---|---|---|---|
| Name | String | N/A | Yes | Specify the name for the IP list asset. |
| Description | String | N/A | No | Specify the description of the IP list asset. |
| Tag | String | N/A | No | Specify the tag of the IP list asset. |

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    {
        "type": "regular",
        "response": {
            "id": "41",
            "name": "api_test_5",
            "type": "static",
            "description": "",
            "tags": "qweqwe",
            "context": "",
            "status": "0",
            "createdTime": "1606129689",
            "modifiedTime": "1606129689",
            "ioSyncStatus": "Not Synced",
            "ioFirstSyncTime": "-1",
            "ioLastSyncSuccess": "-1",
            "ioLastSyncFailure": "-1",
            "ioSyncErrorDetails": null,
            "typeFields": {
                "definedIPs": "203.0.113.1,203.0.113.10"
            },
            "repositories": [
                {
                    "ipCount": "-1",
                    "repository": {
                        "id": "1",
                        "name": "Example-Repository",
                        "description": ""
                    }
                }
            ],
            "ipCount": -1,
            "groups": [],
            "assetDataFields": [],
            "canUse": "true",
            "canManage": "true",
            "creator": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "owner": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "ownerGroup": {
                "id": "0",
                "name": "Full Access",
                "description": "Full Access group"
            },
            "targetGroup": {
                "id": -1,
                "name": "",
                "description": ""
            },
            "template": {
                "id": -1,
                "name": "",
                "description": ""
            }
        },
        "error_code": 0,
        "error_msg": "",
        "warnings": [],
        "timestamp": 1606129688
    }

##### Case wall

| **Result type** | **Value/Description** | **Type** |
|---|---|---|
| Output message\* | **The action should not fail nor stop a playbook execution:** **If static code 200(is_success = true):** print "Successfully created new IP List Asset {0} with the following IPs in Tenable Security Center:\\n{1}".format(name, entity.identifier) **If no IP entities:** print "At least 1 IP entity should be available in order to create an IP List Asset'. <br /> **The action should fail and stop a playbook execution:** **if fatal error, like wrong credentials, no connection to server, other:** print "Error executing action "Create IP List Asset". Reason: {0}''.format(error.Stacktrace) **If not static code 200 (is_success = false):** print "Error executing action "Create IP List Asset". Reason: {0}''.format(error_msg) | General |

### Enrich IP

Get information about IP addresses and enrich them.

#### Parameters

| Parameter | Type | Default Value | Description |
|---|---|---|---|
| Repository Name | String | N/A | The repository name. |

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Entity enrichment

| Enrichment Field Name | Logic-When to apply |
|---|---|
| macAddress | Returns if it exists in JSON result |
| severityLow | Returns if it exists in JSON result |
| links | Returns if it exists in JSON result |
| ip | Returns if it exists in JSON result |
| last scan | Returns if it exists in JSON result |
| severityCritical | Returns if it exists in JSON result |
| total | Returns if it exists in JSON result |
| severityAll | Returns if it exists in JSON result |
| mcafeeGUID | Returns if it exists in JSON result |
| policyName | Returns if it exists in JSON result |
| uuid | Returns if it exists in JSON result |
| lastAuthRun | Returns if it exists in JSON result |
| severityInfo | Returns if it exists in JSON result |
| osCPE | Returns if it exists in JSON result |
| uniqueness | Returns if it exists in JSON result |
| dnsName | Returns if it exists in JSON result |
| repository | Returns if it exists in JSON result |
| ip | Returns if it exists in JSON result |
| description | Returns if it exists in JSON result |
| name | Returns if it exists in JSON result |
| lastUnauthRun | Returns if it exists in JSON result |
| biosGUID | Returns if it exists in JSON result |
| tpmID | Returns if it exists in JSON result |
| score | Returns if it exists in JSON result |
| hasPassive | Returns if it exists in JSON result |
| pluginSet | Returns if it exists in JSON result |
| hasCompliance | Returns if it exists in JSON result |
| severityHigh | Returns if it exists in JSON result |
| netbiosName | Returns if it exists in JSON result |
| severityMedium | Returns if it exists in JSON result |
| os | Returns if it exists in JSON result |

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    [
    {
    "EntityResult":
    {
    "macAddress": "",
    "severityLow": "0",
    "links": [],
    "ip": "203.0.113.1",
    "lastScan": "1549425224",
    "severityCritical": "0",
    "total": "2",
    "severityAll": "0,0,0,0,2",
    "mcafeeGUID": "",
    "policyName": "1e2e4247-0de7-56d5-8026-34ab1f3150ef-1130313/Basic Discovery Scan",
    "uuid": "",
    "lastAuthRun": "",
    "severityInfo": "2",
    "osCPE": "",
    "uniqueness": "repositoryID,ip,dnsName",
     "dnsName": "example.com",
    "repository":
              {
    "id": "1",
    "description": "",
    "name": "repository"
              },
    "lastUnauthRun": "1549363419",
    "biosGUID": "",
    "tpmID": "",
    "score": "0",
    "hasPassive": "No",
    "pluginSet": "201902020242",
    "hasCompliance": "No",
    "severityHigh": "0",
    "netbiosName": "",
    "severityMedium": "0",
    "os": ""
    },
    "Entity": "203.0.113.1"
    }
    ]

### Get Related Assets

Get assets that are related to an IP address.

#### Parameters

| Parameter | Type | Default Value | Description |
|---|---|---|---|
| Repository Name | String | N/A | The repository name. |

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Entity enrichment

| Enrichment Field Name | Logic-When to apply |
|---|---|
| id | Returns if it exists in JSON result |
| name | Returns if it exists in JSON result |

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    [
    {
    "EntityResult":
    [
    {
    "id": "0",
    "description": "All defining ranges of the Group in whose context this Asset is being evaluated.",
    "name": "All Defined Ranges"
    }, {
    "id": "2",
    "description": "This asset uses the Scan Summary plugin to detect if a host has been scanned by Nessus. The Scan Summary plugin contains the list of tests conducted during the most recent scan.",
    "name": "Systems that have been Scanned"
    }, {
    "id": "13",
    "description": "Leverage Nessus plugin 10180 (Ping the remote host) and Nessus plugin 12503 (Host Fully Qualified Domain Name (FQDN) Resolution) to find hosts that don't have a resolvable FQDN in DNS.",
    "name": "Scanned Hosts Not in DNS"
    }
    ],
    "Entity": "203.0.113.1"
    }
    ]

### Get Report

Get report content by ID or name.

#### Parameters

| **Parameter** | Type | Default Value | Description |
|---|---|---|---|
| Report ID | String | N/A | Report ID number.Can be found at the report URL. |

#### Run On

This action runs on all entities.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    {
    "pubSites":
    [
    "https://example.com",
    "https://example.net"
    ]
    }

### Get Scan Results

Wait for scan to complete and get results of the scan.

#### Parameters

| **Parameter** | Type | Default Value | Description |
|---|---|---|---|
| Scan Result ID | String | N/A | The scan results ID. |

#### Run on

This action runs on all entities.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result


    {
    "severity_summary":
    [
    {
    "count": "0",
    "severity":
    {
    "id": "4",
    "name": "Critical",
    "description": "Critical Severity"
    }
    }, {
    "count": "0",
    "severity":
    {
    "id": "3",
    "name": "High",
    "description": "High Severity"
    }
    }, {
    "count": "3",
    "severity":
    {"id": "2",
    "name": "Medium",
    "description": "Medium Severity"
    }}
    ],
    "results":
    [
    {
    "name": "DNS Server Recursive Query Cache Poisoning Weakness",
    "family": "DNS",
    "hostTotal": "1",
    "pluginID": "10539",
    "total": "1",
    "severity": "Medium"
    }, {
    "name": "DNS Server Spoofed Request Amplification DDoS",
    "family": "DNS",
    "hostTotal": "1",
    "pluginID": "35450",
    "total": "1",
    "severity": "Medium"
    }, {
    "name": "SSL Medium Strength Cipher Suites Supported",
    "family": "General",
    "hostTotal": "1",
    "pluginID": "42873",
    "total": "1",
    "severity": "Medium"
    }
    ]
    }

### Get Vulnerabilities for IP

Get vulnerabilities and severity summary for an IP address.

#### Parameters

N/A

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Entity enrichment

| Enrichment Field Name | Logic-When to apply |
|---|---|
| macAddress | Returns if it exists in JSON result |
| protocol | Returns if it exists in JSON result |
| uuid | Returns if it exists in JSON result |
| family | Returns if it exists in JSON result |
| pluginInfo | Returns if it exists in JSON result |
| ip | Returns if it exists in JSON result |
| pluginID | Returns if it exists in JSON result |
| severity | Returns if it exists in JSON result |
| repository | Returns if it exists in JSON result |
| uniqueness | Returns if it exists in JSON result |
| dnsName | Returns if it exists in JSON result |
| port | Returns if it exists in JSON result |
| netbiosName | Returns if it exists in JSON result |
| name | Returns if it exists in JSON result |

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    [
    {
    "EntityResult":
    [
    {
    "macAddress": "",
    "protocol": "TCP",
    "uuid": "",
    "family": "Web Servers",
    "pluginInfo": "10107 (443/6) HTTP Server Type and Version",
    "ip": "203.0.113.1",
    "pluginID": "10107",
    "severity": "Info",
    "repository": "repo",
    "uniqueness": "repositoryID,ip,dnsName",
    "dnsName": "example.com",
    "port": "443",
    "netbiosName": "",
    "name": "HTTP Server Type and Version"
    }, {
    "macAddress": "",
    "protocol": "UDP",
    "uuid": "",
    "family": "DNS",
    "pluginInfo": "10539 (53/17) DNS Server Recursive Query Cache Poisoning Weakness",
    "ip": "203.0.113.1",
    "pluginID": "10539",
    "severity": "Medium",
    "repository": "repo",
    "uniqueness": "repositoryID,ip,dnsName",
    "dnsName": "exaample.com",
    "port": "53",
    "netbiosName": "",
    "name": "DNS Server Recursive Query Cache Poisoning Weakness"
    }, {
    "macAddress": "",
    "protocol": "TCP",
    "uuid": "",
    "family": "General",
    "pluginInfo": "10863 (443/6) SSL Certificate Information",
    "ip": "203.0.113.1",
    "pluginID": "10863",
    "severity": "Info",
    "repository": "repo",
    "uniqueness": "repositoryID,ip,dnsName",
    "dnsName": "example.com",
    "port": "443",
    "netbiosName": "",
    "name": "SSL Certificate Information"
    }
    ],
    "Entity": "203.0.113.1"
    }
    ]

### Ping

Test connectivity.

#### Run on

This action runs on all entities.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| null | N/A | N/A |

### Scan IPs

Initiate a scan of IP addresses.

#### Parameters

| Parameter | Type | Default Value | Description |
|---|---|---|---|
| Scan name | String | N/A | The name of the scan to create. |
| Policy Name | String | N/A | The name of the policy. |

#### Run on

This action runs on the IP Address entity.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| scan_result_id | N/A | N/A |

### Run Asset Scan

Execute Asset Scan in Tenable Security Center.

#### Where To Find Policy ID And Repository ID

**For Policy ID:**

1. Navigate to `https://INSTANCE_IP_ADDRESS/#policies`.
2. Select the policy that you want to use in action.
3. In the URL, you will be able to see an ID of that policy.

**For Repository ID:**

1. Navigate to `https://INSTANCE_IP_ADDRESS/#repositories`.
2. Select the repository that you want to use in action.
3. In the URL, you will be able to see an ID of that repository.

> [!NOTE]
> **Note:** Repository should have a configured `Organization` attribute.

#### Parameters

| **Parameter Display Name** | **Type** | **Default Value** | **Is Mandatory** | **Description** |
|---|---|---|---|---|
| Scan Name |   | N/A | Yes | Specify the name for the scan. |
| Asset Name | String | N/A | Yes | Specify the name of the asset that should be scanned. |
| Policy ID | Integer | N/A | Yes | Specify the ID of the policy that should be used in the scan. |
| Repository ID | Integer | N/A | Yes | Specify the ID of the repository that should be used in the scan. |
| Description | String | N/A | No | Specify the description for the scan. |

#### Run on

This action doesn't run on entities.

#### Action results

##### Script result

| **Script Result Name** | **Value Options** | **Example** |
|---|---|---|
| is_success | True/False | is_success:False |

##### JSON result

    {
        "type": "regular",
        "response": {
            "id": "11",
            "name": "Scan Name",
            "description": "",
            "ipList": "",
            "type": "policy",
            "dhcpTracking": "false",
            "classifyMitigatedAge": "0",
            "emailOnLaunch": "false",
            "emailOnFinish": "false",
            "timeoutAction": "import",
            "scanningVirtualHosts": "false",
            "rolloverType": "template",
            "status": "0",
            "createdTime": "1606132784",
            "modifiedTime": "1606132784",
            "maxScanTime": "3600",
            "reports": [],
            "assets": [
                {
                    "id": "38",
                    "name": "api_test_1",
                    "description": ""
                }
            ],
            "credentials": [],
            "numDependents": "0",
            "schedule": {
                "id": -1,
                "objectType": -1,
                "type": "now",
                "start": "",
                "repeatRule": "",
                "enabled": "true",
                "nextRun": -1,
                "dependent": {
                    "id": -1,
                    "name": "",
                    "description": ""
                }
            },
            "policy": {
                "id": "1000002",
                "context": "",
                "name": "Host Discovery",
                "description": "",
                "tags": "",
                "owner": {
                    "id": "1",
                    "username": "security_manager",
                    "firstname": "Manager",
                    "lastname": "Security"
                },
                "ownerGroup": {
                    "id": "0",
                    "name": "Full Access",
                    "description": "Full Access group"
                }
            },
            "policyPrefs": [
                {
                    "name": "MODE|discovery",
                    "value": "host_enumeration"
                },
                {
                    "name": "description",
                    "value": ""
                },
                {
                    "name": "display_unreachable_hosts",
                    "value": "no"
                },
                {
                    "name": "log_live_hosts",
                    "value": "yes"
                },
                {
                    "name": "name",
                    "value": "Host Discovery"
                },
                {
                    "name": "reverse_lookup",
                    "value": "no"
                }
            ],
            "repository": {
                "id": "1",
                "name": "Example-Repository",
                "description": ""
            },
            "canUse": "true",
            "canManage": "true",
            "plugin": {
                "id": -1,
                "name": "",
                "description": ""
            },
            "zone": {
                "id": -1,
                "name": "",
                "description": ""
            },
            "ownerGroup": {
                "id": "0",
                "name": "Full Access",
                "description": "Full Access group"
            },
            "creator": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "owner": {
                "id": "1",
                "username": "security_manager",
                "firstname": "Manager",
                "lastname": "Security"
            },
            "scanResultID": "34"
        },
        "error_code": 0,
        "error_msg": "",
        "warnings": [],
        "timestamp": 1606132783
    }

##### Case wall

| **Result type** | **Value/Description** | **Type** |
|---|---|---|
| Output message\* | **The action should not fail nor stop a playbook execution:** **If static code 200(is_success = true):** print "Successfully started asset scan {0} in Tenable Security Center.".format(name) **The action should fail and stop a playbook execution:** **if fatal error, like wrong credentials, no connection to server, other:** print "Error executing action "Run Asset Scan". Reason: {0}''.format(error.Stacktrace) **If asset not found:** print "Error executing action "Run Asset Scan". Reason: Asset {0} was not found in Tenable Security Center. ''.format(name) **If not static code 200 (is_success = false):** print "Error executing action "Run Asset Scan". Reason:{0}".format(error_msg) | General |

## Connectors

### Tenable Security Center Connector

For detailed instructions on how to configure a connector in
Google SecOps, see [Configuring the
connector](https://docs.cloud.google.com/chronicle/docs/soar/ingest/connectors/ingest-your-data-connectors).

#### Connector parameters

Use the following parameters to configure the connector:

| Parameter | Type | Default Value | Description |
|---|---|---|---|
| DeviceProductField | String | device_product | The field name used to determine the device product. |
| EventClassId | String | name | The field name used to determine the event name (sub-type). |
| PythonProcessTimeout | String | 60 | The timeout limit (in seconds) for the python process running current script. |
| Server Address | String | null | N/A |
| Username | String | null | N/A |
| Password | Password | null | N/A |
| Access Key | String | null | *Optional* Access Key of the Tenable Security Center account. Both `Access Key` and `Secret Key` must be provided. |
| Secret Key | Password | null | *Optional* Secret Key of the Tenable Security Center account. Both `Access Key` and `Secret Key` must be provided. |
| Use SSL | Checkbox | Unchecked | N/A |
| Max Days Backwards | Integer | 1 | The amount of days back, from which you would like to fetch data. |
| Limit Per Cycle | Integer | 10 | The amount of alerts ingested into the connector in each execution cycle. |
| Proxy Server Address | String | null | The address of the proxy server to use. |
| Proxy Username | String | null | The proxy username to authenticate with. |
| Proxy Password | Password | null | The proxy password to authenticate with. |

#### Connector rules

The connector supports proxies.

**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/)