--- title: SSP Deployer slug: connectors/ssp-deployer docTags: createdAt: 2026-06-09T16:30:32.106Z --- The SSP Deployer connector facilitates the automated import, validation, and deployment of SSP configurations, enhancing the efficiency of security service management. The SSP Deployer Connector bridges Swimlane Turbine with the SSP (Swimlane Solution Package) deployment process, enabling seamless import, status tracking, and deployment of SSP configurations. Users can validate SSPs through dry runs, track import statuses using unique tracking IDs, and upload SSPs to specified tenants with options for background processing and entity overwrites. This integration streamlines the management of solution packages, significantly reducing manual effort and enhancing operational efficiency within the Swimlane ecosystem. This connector integrates with Swimlane Turbine to deploy SSP packages to tenants. ## Asset Setup or Prerequisites To effectively utilize the SSP Deployer connector, ensure you have the following prerequisites in place: - Username and password authentication with the following parameters: - Hostname: The address of the server where SSP configurations are managed. - Username: The user account with permissions to access and manage SSP configurations. - Password: The corresponding password for the provided username. ## Capabilities This Connector provides the following capabilities: - Import SSP - Retrieve Status by Tracking ID - Upload SSP ## Notes - To access Swimlane SSP Deploy API Documentation Link, [click here to check](https://us1.swimlane.app/docs) # Configurations ## Swimlane SSP Deployer Authentication Authenticates using username and password. ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | ------------------------- | -------- | ------------ | | url | Turbine Hostname | string | Required | | username | Turbine Username | string | Required | | password | Turbine Password | string | Required | | http\_proxy | Optional HTTP/HTTPS proxy | string | Optional | | verify\_ssl | Verify SSL certificate | boolean | Optional | # Actions ## Import SSP Executes a dry run import of SSP configurations using provided form data to validate the process. ### Endpoint - **URL:** `/content/import/try` - **Method:** `POST` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | -------------------------- | -------- | ------------ | --------------------------------------- | | `form_data` | object | Required | Response data | | `form_data.file` | array | Required | Swimlane solution content package, ssp. | | `form_data.file.file_name` | string | Required | Response data | | `form_data.file.file` | string | Required | Response data | ### Input Example `{"form_data":{"file":[{"file_name":"TEST_IMPORT.ssp","file":"TEST_IMPORT.ssp"}]}}` ### Output | **Parameter** | **Type** | **Description** | | ------------- | -------- | -------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | ### Output Example `{"status_code":200,"response_headers":{"content-length":"140","content-type":"application/json","Date":"Mon, 19 Feb 2023 20:37:23 GMT"},"reason":"OK","json_body":{}}` ## Retrieve Status by Tracking ID Retrieve the current status and results of a content exchange import using a specific tracking ID. ### Endpoint - **URL:** `/content/import/{{trackingId}}/status` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ---------------------------- | -------- | ------------ | ---------------------------------- | | `path_parameters.trackingId` | string | Required | Tracking ID of the import process. | ### Input Example `{"path_parameters":{"trackingId":"aEHnIq9sUH6xOEwUa"}}` ### Output | **Parameter** | **Type** | **Description** | | ----------------------------------- | -------- | ----------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `entities` | object | Output field: entities | | `entities.additionalProp1` | array | Output field: entities.additionalProp1 | | `entities.additionalProp1.uid` | string | Unique identifier | | `entities.additionalProp1.version` | number | Output field: entities.additionalProp1.version | | `entities.additionalProp1.id` | string | Unique identifier | | `entities.additionalProp1.name` | string | Name of the resource | | `entities.additionalProp1.disabled` | boolean | Output field: entities.additionalProp1.disabled | | `entities.additionalProp2` | array | Output field: entities.additionalProp2 | | `entities.additionalProp2.uid` | string | Unique identifier | | `entities.additionalProp2.version` | number | Output field: entities.additionalProp2.version | | `entities.additionalProp2.id` | string | Unique identifier | | `entities.additionalProp2.name` | string | Name of the resource | | `entities.additionalProp2.disabled` | boolean | Output field: entities.additionalProp2.disabled | | `entities.additionalProp3` | array | Output field: entities.additionalProp3 | | `entities.additionalProp3.uid` | string | Unique identifier | | `entities.additionalProp3.version` | number | Output field: entities.additionalProp3.version | | `entities.additionalProp3.id` | string | Unique identifier | | `entities.additionalProp3.name` | string | Name of the resource | | `entities.additionalProp3.disabled` | boolean | Output field: entities.additionalProp3.disabled | | `issues` | object | Output field: issues | | `issues.additionalProp1` | array | Output field: issues.additionalProp1 | | `issues.additionalProp1.errorCode` | number | Error message if any | | `issues.additionalProp1.message` | string | Response message | ### Output Example `{"status_code":200,"response_headers":{"content-length":"140","content-type":"application/json","Date":"Mon, 19 Feb 2023 20:37:23 GMT"},"reason":"OK","json_body":{"entities":{"additionalProp1":[],"additionalProp2":[],"additionalProp3":[]},"issues":{"additionalProp1":[],"additionalProp2":[],"additionalProp3":[]},"errors":{"additionalProp1":[],"additionalProp2":[],"additionalProp3":[]},"createdDate":"string","modifiedDate":"string","createdByUser":{"id":"string","name":"string"},"modifiedByUser":{...` ## Upload SSP Upload and deploy SSP packages to specified tenants, requiring attachments, account, tenant, and entity IDs. ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------------- | -------- | ------------ | ------------------------------------------------------------------------------- | | `attachments` | array | Required | Swimlane solution content package, ssp. | | `attachments.file_name` | string | Required | Name of the resource | | `attachments.file` | string | Required | Parameter for Upload SSP | | `account` | string | Required | Count value | | `tenant` | string | Required | Parameter for Upload SSP | | `overwrite` | string | Optional | Determines if import process overwrites existing entities. Defaults to false. | | `background` | string | Optional | Determines if import process should run as a background task. Defaults to true. | | `entity_ids` | array | Required | IDs of the entities in the SSP which should be imported. | ### Input Example `{"attachments":[{"file_name":"TEST_IMPORT.ssp","file":"TEST_IMPORT.ssp"}],"overwrite":"true","background":"true"}` ### Output | **Parameter** | **Type** | **Description** | | ------------- | -------- | ----------------------- | | `results` | string | Result of the operation | ### Output Example `{"results":"\"aEHnIq9sUH6xOEwUa\""}` # Response Headers | **Header** | **Description** | **Example** | | -------------- | ----------------------------------------------------- | ----------------------------- | | content-length | The length of the response body in bytes | 140 | | content-type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Mon, 19 Feb 2023 20:37:23 GMT |