Absolute

the absolute connector enables automated interactions with absolute's endpoint security management platform, facilitating device and security management tasks absolute provides robust endpoint security and device management solutions this connector enables swimlane turbine users to manage device security by creating freeze messages, retrieving device details, managing device groups, and unenrolling devices by integrating with absolute, security teams can automate device management tasks, ensuring swift and consistent responses to security incidents and maintaining device compliance within the organization prerequisites to utilize the absolute connector within swimlane turbine, ensure you have the following prerequisites custom authentication with the following parameters url the endpoint url for the absolute api token id your unique identifier used for token based authentication token secret the secret key associated with your token id for secure access capabilities this connector provides the following capabilities create a freeze message get all device groups get an unenroll device request get device details get device groups by device get freeze messages unenroll devices notes for more information on absolute https //api absolute com/api doc/doc html#tag/freeze configurations absolute asset authentication authenticates using token id and token secret configuration parameters parameter description type required url a url to the target host string required token id token id string required token secret token secret string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions create a freeze message displays a full screen message on an absolute managed device, indicating it is frozen and inoperable, requiring 'content' and 'name' endpoint url /v3/actions/freeze/messages method post input argument name type required description content string optional the user defined, html coded freeze message in between 1 and 4000 characters name string optional the user defined name of the freeze message shown on the device when the device is frozen input example {"json body" {"content" "create a new content","name" "the user defined name of the freeze message"}} output parameter type description status code number http status code of the response reason string response reason phrase data object response data data messageuid string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" {"messageuid" "b4d60860 4b3b 41ba 83ab edd36717a834"},"metadata" {"pagination" {}}}} get all device groups retrieve details of all existing device groups within the absolute platform endpoint url /v3/configurations/device groups/groups method get input argument name type required description parameters nextpage string optional the pagination token for the next page of results parameters pagesize string optional the number of records to be returned per page default 100 maximum 500 parameters devicegroupuid string optional filters the results to include responses where devicegroupuid equals the given value parameters devicegroupuidanyof string optional filters the results to include responses where devicegroupuid is any of the given comma separated values parameters displayname string optional filters results to include responses where displayname equals the given value parameters displaynamestartswith string optional filters results to include responses where displayname starts with the given value parameters grouptype string optional filters results to include responses where grouptype equals the given value input example {"parameters" {"nextpage" "string","pagesize" "100","devicegroupuid" "01a3d36a 9f62 4092 8c48 6db4233ee99b","devicegroupuidanyof" "string","displayname" "string","displaynamestartswith" "string","grouptype" "string"}} output parameter type description status code number http status code of the response reason string response reason phrase data array response data data devicegroupuid string response data data grouptype string response data data displayname string response data data description string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" \[{}],"metadata" {"pagination" {}}}} get an unenroll device request retrieve details of an unenroll device request in absolute using the unique request identifier (requestuid) endpoint url /v3/actions/requests/unenroll/{{requestuid}} method get input argument name type required description path parameters requestuid string required the system defined unique identifier of the device action request input example {"path parameters" {"requestuid" "23dbd460 0547 466d a655 99d9340ff598"}} output parameter type description status code number http status code of the response reason string response reason phrase data object response data data totaldevices number response data data pending number response data data processing number response data data completed number response data data canceled number response data data failed number response data data requestid string response data data requestuid string response data data requeststatus string response data data createddatetimeutc string response data data updateddatetimeutc string response data data requester string response data data excludemissingdevices boolean response data metadata object response data metadata pagination object response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" {"totaldevices" 0,"pending" 0,"processing" 0,"completed" 0,"canceled" 0,"failed" 0,"requestid" "string","requestuid" "23dbd460 0547 466d a655 99d9340ff598","requeststatus" "string","createddatetimeutc" "2019 08 24t14 15 22z","updateddatetimeutc" "2019 08 24t14 15 22z","requester" "string","excludemissingdevices"\ true},"metadata" {"pagination" {}}}} get device details retrieve detailed information about devices registered in your absolute account endpoint url /v3/reporting/devices method get input argument name type required description parameters sortby string optional the sorting field and the direction of sorting parameters select string optional a comma delimited list of fields to be returned in the results, you cannot use both the top level object and nested parameters at the same time parameters nextpage string optional the pagination token for the next page of results parameters pagesize string optional the number of records to be returned per page parameters agentstatus string optional filters results to include responses where agentstatus equals the given value parameters agentstatusempty boolean optional filters results to include responses where agentstatus is empty or null parameters agentstatusnot string optional filters results to include responses where agentstatus does not equal the given value can be used multiple times with different values parameters agentversion string optional filters results to include responses where agentversion equals the given value parameters agentversionnot string optional filters results to include responses where agentversion does not equal the given value can be used multiple times with different values parameters bootdevice string optional filters results to include responses where bootdevice equals the given value parameters bootdevicenot string optional filters results to include responses where bootdevice does not equal the given value can be used multiple times with different values parameters bootdevicenotstartswith string optional filters results to include responses where bootdevice does not start with the given value can be used multiple times with different values parameters bootdevicestartswith string optional filters results to include responses where bootdevice starts with the given value parameters bssid string optional filters results to include responses where bssid equals the given value parameters bssidnot string optional filters results to include responses where bssid does not equal the given value can be used multiple times with different values parameters classification string optional filters results to include responses where classification equals the given value parameters classificationnot string optional filters results to include responses where classification does not equal the given value can be used multiple times with different values parameters ctesversion string optional filters results to include responses where ctesversion equals the given value parameters ctesversionnot string optional filters results to include responses where ctesversion does not equal the given value can be used multiple times with different values parameters currentnetworkname string optional filters results to include responses where currentnetworkname equals the given value parameters currentnetworknameempty string optional filters results to include responses where currentnetworkname is empty or null parameters currentnetworknamenot string optional filters results to include responses where currentnetworkname does not equal the given value parameters currentusername string optional filters results to include responses where currentusername equals the given value parameters currentusernamecontains string optional filters results to include responses where currentusername contains the given value parameters currentusernameempty boolean optional filters results to include responses where currentusername is empty or null input example {"parameters" {"sortby" "string","select" "string","nextpage" "string","pagesize" 10,"agentstatus" "active","agentstatusempty"\ true,"agentstatusnot" "active","agentversion" "string","agentversionnot" "string","bootdevice" "string","bootdevicenot" "string","bootdevicenotstartswith" "string","bootdevicestartswith" "string","bssid" "string","bssidnot" "string","classification" "string","classificationnot" "string","ctesversion" "string","ctesversionnot" "string","currentnetworkname" "example name","currentnetworknameempty" "example name","currentnetworknamenot" "example name","currentusername" "example name","currentusernamecontains" "example name","currentusernameempty"\ true,"currentusernameendswith" "example name","currentusernamenot" "example name","currentusernamenotstartswith" "example name","currentusernamestartswith" "example name","defaultgateway" "string","defaultgatewaynot" "string","defaultgatewaynotstartswith" "string","defaultgatewaystartswith" "string","devicefreezeactionstatusscore" 123,"devicefreezereportingstatusescontains" "active","devicefreezestatuscode" "active","devicename" "example name","devicenameempty"\ true,"devicenamenot" "example name","devicenamenotstartswith" "example name","devicenamestartswith" "example name","devicestatus" "active","devicestatusnot" "active","deviceuid" "string","deviceuidnot" "string","dfcalcstatus" "active","dfcalcstatusnot" "active","dfcomponentstatus" "active","dfcomponentstatusnot" "active","dfstatusenabled"\ true}} output parameter type description status code number http status code of the response reason string response reason phrase data array response data data deviceuid string response data data accountuid string response data data policygroupname string response data data lastconnecteddatetimeutc string response data data dlpstatus object response data data dlpstatus isenabled boolean response data data dlpstatus featuretype string response data data espstatus object response data data espstatus isenabled boolean response data data espstatus featuretype string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"reason" "ok","json body" {"data" \[{}],"metadata" {"pagination" {}}}} get device groups by device retrieve all device groups associated with a specific device in absolute using the unique identifier (deviceuid) endpoint url /v3/configurations/device groups/devices/{{deviceuid}}/groups method get input argument name type required description path parameters deviceuid string required the system defined unique identifier of the device input example {"path parameters" {"deviceuid" "01a3d36a 9f62 4092 8c48 6db4233ee99b"}} output parameter type description status code number http status code of the response reason string response reason phrase data array response data data devicegroupuid string response data data grouptype string response data data displayname string response data data description string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" \[{}],"metadata" {"pagination" {}}}} get freeze messages gathers all configured freeze messages from absolute, offering a comprehensive overview of system alerts endpoint url /v3/actions/freeze/messages method get input argument name type required description parameters nextpage string optional the pagination token for the next page each page contains 100 records parameters pagesize string optional the number of records to be returned per page default 100 maximum 500 input example {"parameters" {"nextpage" "100records","pagesize" "100"}} output parameter type description status code number http status code of the response reason string response reason phrase data array response data data name string response data data content string response data data createdby string response data data changedby string response data data messageuid string response data data createddatetimeutc string response data data changeddatetimeutc string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" \[{}],"metadata" {"pagination" {}}}} unenroll devices initiates the unenrollment of specified devices from absolute using their unique deviceuids endpoint url /v3/actions/requests/unenroll method post input argument name type required description deviceuids array optional unique identifier excludemissingdevices boolean optional indicates whether devices that have been reported missing should be excluded from the request input example {"json body" {"deviceuids" \["497f6eca 6276 4993 bfeb 53cbbbba6f08"],"excludemissingdevices"\ true}} output parameter type description status code number http status code of the response reason string response reason phrase data object response data data requestuid string response data metadata object response data metadata pagination object response data metadata pagination nextpage string response data output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"data" {"requestuid" "23dbd460 0547 466d a655 99d9340ff598"},"metadata" {"pagination" {}}}} response headers header description example cf cache status http response header cf cache status cf ray http response header cf ray connection http response header connection content encoding http response header content encoding content type the media type of the resource date the date and time at which the message was originated feature policy http response header feature policy link http response header link referrer policy http response header referrer policy server information about the software used by the origin server set cookie http response header set cookie strict transport security http response header strict transport security transfer encoding http response header transfer encoding vary http response header vary x content type options http response header x content type options x frame options http response header x frame options