---
title: Vulcan Cyber
slug: connectors/vulcan-cyber
docTags: 
createdAt: 2026-06-09T16:30:12.023Z
---

The Vulcan Cyber connector facilitates the retrieval and management of vulnerability data, enabling enhanced security automation within the Swimlane ecosystem.

Vulcan Cyber is a vulnerability management platform that enables organizations to effectively prioritize and remediate vulnerabilities. The Vulcan Cyber connector for Swimlane Turbine allows users to retrieve detailed vulnerability data, apply custom search criteria, and streamline vulnerability management processes. By integrating with Vulcan Cyber, Swimlane Turbine users can enhance their security posture with targeted vulnerability insights and automated remediation workflows, ensuring that critical risks are addressed promptly and efficiently.

## Prerequisites

To integrate Vulcan Cyber with the Swimlane Turbine platform, ensure you have the following:

- HTTP Bearer Token Authentication with these parameters:
  - URL: Endpoint for Vulcan Cyber API access.
  - Token: A valid bearer token to authenticate API requests.

## Capabilities

The Vulcan Cyber connector has the following capabilities:

- Retrieve Vulnerabilities

API Documentation: [https://help.vulcancyber.com/en/articles/3438656-working-with-vulcan-api](https://help.vulcancyber.com/en/articles/3438656-working-with-vulcan-api)

# Configurations

## Vulcan Cyber API Token Authentication

Authenticates using bearer token.

### Configuration Parameters

| **Parameter** | **Description**                    | **Type** | **Required** |
| ------------- | ---------------------------------- | -------- | ------------ |
| url           | A URL to the target host.          | string   | Required     |
| token         | The API key, token, etc.           | string   | Required     |
| verify\_ssl   | Verify SSL certificate.            | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through. | string   | Optional     |

# Actions

## Retrieve Vulnerabilities

Retrieve a list of vulnerabilities from Vulcan Cyber using specified search criteria and return the results.

### Endpoint

- **URL:** `/api/v2/vulnerabilities`
- **Method:** `POST`

### Input

| **Argument Name**              | **Type** | **Required** | **Description**                                                                                            |
| ------------------------------ | -------- | ------------ | ---------------------------------------------------------------------------------------------------------- |
| `ruleset`                      | object   | Optional     | The set of rules to filter the search results.                                                             |
| `ruleset.operator`             | string   | Optional     | The operator that applies to the rules within the ruleset. This operator will be applied to all sub-rules. |
| `ruleset.rules`                | array    | Optional     | The list of all rules to apply on the returned output.                                                     |
| `ruleset.rules.category_name`  | string   | Optional     | The category name for the parameter.                                                                       |
| `ruleset.rules.parameter_name` | string   | Optional     | The parameter name or column name to which the rule applies.                                               |
| `ruleset.rules.parent_name`    | string   | Optional     | The parent category name, if applicable.                                                                   |
| `ruleset.rules.operator`       | string   | Optional     | The operator for the condition.                                                                            |
| `ruleset.rules.value`          | string   | Optional     | The value of the condition.                                                                                |
| `version`                      | number   | Optional     | The version to use.                                                                                        |
| `page_number`                  | number   | Optional     | The current page number in pagination. Default:- 1.                                                        |
| `page_size`                    | number   | Optional     | The number of results per page in pagination. Maximum: 10000, Minimum: 1.                                  |
| `order_by`                     | array    | Optional     | The column to order the results by.                                                                        |
| `order_by.parameter_name`      | string   | Optional     | The name of the parameter to order by.                                                                     |
| `order_by.order`               | string   | Optional     | The order type, either ascending (asc) or descending (desc).                                               |
| `columns`                      | array    | Optional     | The specific columns to include in the search results.                                                     |

### Input Example

`{"json_body":{"ruleset":{"operator":"and","rules":[{"category_name":"vulnerability","parameter_name":"category","operator":"in","value":"vulnerable"}]},"version":1,"page_number":1,"page_size":100,"columns":["id","max_risk","vulnerability_name"]}}`

### Output

| **Parameter**             | **Type** | **Description**                       |
| ------------------------- | -------- | ------------------------------------- |
| `data`                    | array    | Response data                         |
| `data.id`                 | number   | Response data                         |
| `data.max_risk`           | number   | Response data                         |
| `data.vulnerability_name` | string   | Response data                         |
| `pagination`              | object   | Output field: pagination              |
| `pagination.page`         | number   | Output field: pagination.page         |
| `pagination.limit`        | number   | Output field: pagination.limit        |
| `pagination.total_pages`  | number   | Output field: pagination.total\_pages |
| `pagination.total_items`  | number   | Output field: pagination.total\_items |
| `status`                  | object   | Status value                          |
| `status.code`             | number   | Status value                          |
| `status.message`          | string   | Status value                          |
| `status.details`          | object   | Status value                          |
| `status.timestamp`        | string   | Status value                          |

### Output Example

`{"data":[{"id":1,"max_risk":9.8,"vulnerability_name":"Vulnerability A"},{"id":2,"max_risk":9.5,"vulnerability_name":"Vulnerability B"}],"pagination":{"page":1,"limit":100,"total_pages":10,"total_items":1000},"status":{"code":200,"message":"success","details":null,"timestamp":"2024-05-23T14:52:00Z"}}`

# Response Headers

| **Header**   | **Description**                                       | **Example**                   |
| ------------ | ----------------------------------------------------- | ----------------------------- |
| Content-Type | The media type of the resource                        | application/json              |
| Date         | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |