SSP Deployer
18 min
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 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 file array required swimlane solution content package, ssp file name string required name of the resource file string required parameter for import ssp output parameter type description status code number http status code of the response reason string response reason phrase 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 trackingid string required tracking id of the import process output parameter type description status code number http status code of the response reason string response reason phrase entities object output field entities additionalprop1 array output field additionalprop1 uid string unique identifier version number output field version id string unique identifier name string name of the resource disabled boolean output field disabled additionalprop2 array output field additionalprop2 uid string unique identifier version number output field version id string unique identifier name string name of the resource disabled boolean output field disabled additionalprop3 array output field additionalprop3 uid string unique identifier version number output field version id string unique identifier name string name of the resource disabled boolean output field disabled issues object output field issues additionalprop1 array output field additionalprop1 errorcode number error message if any message string response message 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" {}, "issues" {}, "errors" {}, "createddate" "string", "modifieddate" "string", "createdbyuser" {}, "modifiedbyuser" {}, "state" "incomplete", "images" {}, "swimlaneversion" "string", "relationshipgraph" {}, "id" "string", "name" "string", "disabled" true } } ] 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 file name string required name of the resource 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 output parameter type description results string result of the operation 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 notes to access swimlane ssp deploy api documentation link, click here to check https //us1 swimlane app/docs