n8n-nodes-tenable 1.0.0

package/README.md

@@ -0,0 +1,137 @@
+# n8n-nodes-tenable
+
+This package provides n8n community nodes for interacting with Tenable APIs:
+
+- **Tenable Vulnerability Management** - Full-featured node for vulnerability scanning, asset management, and security assessments
+- **Tenable One** - Node for Tenable One Exposure Management platform
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings > Community Nodes**
+2. Select **Install**
+3. Enter `n8n-nodes-tenable`
+4. Agree to the risks and select **Install**
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-tenable
+```
+
+## Credentials
+
+Both nodes use the same Tenable API credentials:
+
+1. In n8n, go to **Credentials > New**
+2. Search for "Tenable API"
+3. Enter your Tenable API credentials:
+   - **Access Key**: Your Tenable API access key
+   - **Secret Key**: Your Tenable API secret key
+   - **Base URL**: Usually `https://cloud.tenable.com`
+
+To generate API keys, go to your Tenable.io account settings.
+
+## Tenable Vulnerability Management Node
+
+### Resources & Operations
+
+#### Scan
+- **Create** - Create a new scan configuration
+- **Delete** - Delete a scan
+- **Get** - Get scan details
+- **Get Many** - List all scans
+- **Launch** - Launch a scan
+- **Pause** - Pause a running scan
+- **Resume** - Resume a paused scan
+- **Stop** - Stop a running scan
+
+#### Asset
+- **Get** - Get asset details
+- **Get Many** - List all assets
+- **Import** - Import assets
+
+#### Export
+- **Start Assets Export** - Start an assets export job
+- **Start Vulnerabilities Export** - Start a vulnerabilities export job
+- **Start Compliance Export** - Start a compliance export job
+- **Get Status** - Get export job status
+- **Cancel** - Cancel an export job
+- **Download Chunk** - Download an export chunk
+
+#### Folder
+- **Create** - Create a folder
+- **Delete** - Delete a folder
+- **Get Many** - List all folders
+- **Update** - Rename a folder
+
+#### Plugin
+- **Get** - Get plugin details
+- **Get Families** - List all plugin families
+- **Get Family Plugins** - List plugins in a family
+
+#### Policy
+- **Copy** - Copy a policy
+- **Create** - Create a policy
+- **Delete** - Delete a policy
+- **Get** - Get policy details
+- **Get Many** - List all policies
+
+#### Vulnerability
+- **Get Many** - List vulnerabilities
+
+#### Workbench
+- **Get Assets** - Get assets from workbench
+- **Get Asset Info** - Get detailed asset information
+- **Get Asset Vulnerabilities** - Get vulnerabilities for an asset
+- **Get Vulnerabilities** - Get vulnerabilities from workbench
+
+## Tenable One Node
+
+### Resources & Operations
+
+#### Attack Path
+- **Search Attack Paths** - Search for top attack paths
+- **Search Attack Techniques** - Search for top attack techniques (MITRE ATT&CK)
+
+#### Exposure View
+- **Get Cards** - Get all exposure view cards
+- **Get Card** - Get a specific card
+
+#### Inventory
+- **Search Assets** - Search for assets
+- **Search Findings** - Search for findings
+- **Search Software** - Search for software
+- **Get Asset Properties** - Get available asset properties for filtering
+- **Get Finding Properties** - Get available finding properties
+- **Get Software Properties** - Get available software properties
+
+#### Inventory Export
+- **Start Assets Export** - Start an assets export
+- **Start Findings Export** - Start a findings export
+- **Get Status** - Get export status
+- **Get Export Status** - Get specific export status
+- **Download Chunk** - Download an export chunk
+
+#### Tag
+- **Search** - Search for tags
+- **Get Properties** - Get available tag properties
+
+## Query Examples
+
+### Tenable One Inventory Search (Advanced Mode)
+
+Find cloud assets with critical vulnerabilities:
+```
+Assets HAS sources = "CLOUD" WITH Weakness HAS severity = "Critical"
+```
+
+Find assets with high AES score:
+```
+Assets HAS aes >= 700
+```
+
+## License
+
+MIT

package/dist/credentials/TenableApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TenableApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/TenableApi.credentials.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenableApi = void 0;
+class TenableApi {
+    constructor() {
+        this.name = 'tenableApi';
+        this.displayName = 'Tenable API';
+        this.documentationUrl = 'https://developer.tenable.com/docs/authorization';
+        this.properties = [
+            {
+                displayName: 'Access Key',
+                name: 'accessKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Tenable API access key',
+            },
+            {
+                displayName: 'Secret Key',
+                name: 'secretKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Tenable API secret key',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://cloud.tenable.com',
+                description: 'The base URL for your Tenable instance',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-ApiKeys': '=accessKey={{$credentials.accessKey}};secretKey={{$credentials.secretKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/folders',
+            },
+        };
+    }
+}
+exports.TenableApi = TenableApi;

package/dist/nodes/Tenable/GenericFunctions.d.ts

@@ -0,0 +1,4 @@
+import type { IDataObject, IExecuteFunctions, IHttpRequestMethods, ILoadOptionsFunctions } from 'n8n-workflow';
+export declare function tenableApiRequest(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject | IDataObject[]>;
+export declare function tenableApiRequestAllItems(this: IExecuteFunctions | ILoadOptionsFunctions, method: IHttpRequestMethods, endpoint: string, propertyName: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject[]>;
+export declare function validateJSON(json: string | undefined): IDataObject | undefined;

package/dist/nodes/Tenable/GenericFunctions.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tenableApiRequest = tenableApiRequest;
+exports.tenableApiRequestAllItems = tenableApiRequestAllItems;
+exports.validateJSON = validateJSON;
+const n8n_workflow_1 = require("n8n-workflow");
+async function tenableApiRequest(method, endpoint, body = {}, qs = {}) {
+    const credentials = await this.getCredentials('tenableApi');
+    const options = {
+        method,
+        url: `${credentials.baseUrl}${endpoint}`,
+        headers: {
+            'Accept': 'application/json',
+            'Content-Type': 'application/json',
+        },
+        qs,
+        body,
+        json: true,
+    };
+    if (Object.keys(body).length === 0) {
+        delete options.body;
+    }
+    if (Object.keys(qs).length === 0) {
+        delete options.qs;
+    }
+    try {
+        const response = await this.helpers.httpRequestWithAuthentication.call(this, 'tenableApi', options);
+        return response;
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+    }
+}
+async function tenableApiRequestAllItems(method, endpoint, propertyName, body = {}, qs = {}) {
+    const returnData = [];
+    let responseData;
+    let offset = 0;
+    const limit = 100;
+    do {
+        qs.offset = offset;
+        qs.limit = limit;
+        responseData = (await tenableApiRequest.call(this, method, endpoint, body, qs));
+        const items = responseData[propertyName];
+        if (items) {
+            returnData.push(...items);
+        }
+        offset += limit;
+    } while (responseData[propertyName] &&
+        responseData[propertyName].length === limit);
+    return returnData;
+}
+function validateJSON(json) {
+    if (json === undefined || json === '') {
+        return undefined;
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/nodes/Tenable/TenableOne.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class TenableOne implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}