Absolute
34 min
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 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 required the user defined, html coded freeze message in between 1 and 4000 characters name string required the user defined name of the freeze message shown on the device when the device is frozen output parameter type description status code number http status code of the response reason string response reason phrase data object response data messageuid string unique identifier metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" {}, "metadata" {} } } ] 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 nextpage string optional the pagination token for the next page of results pagesize string optional the number of records to be returned per page default 100 maximum 500 devicegroupuid string optional filters the results to include responses where devicegroupuid equals the given value devicegroupuidanyof string optional filters the results to include responses where devicegroupuid is any of the given comma separated values displayname string optional filters results to include responses where displayname equals the given value displaynamestartswith string optional filters results to include responses where displayname starts with the given value grouptype string optional filters results to include responses where grouptype equals the given value output parameter type description status code number http status code of the response reason string response reason phrase data array response data devicegroupuid string unique identifier grouptype string type of the resource displayname string name of the resource description string output field description metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" \[], "metadata" {} } } ] 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 requestuid string required the system defined unique identifier of the device action request output parameter type description status code number http status code of the response reason string response reason phrase data object response data totaldevices number output field totaldevices pending number output field pending processing number output field processing completed number output field completed canceled number output field canceled failed number output field failed requestid string unique identifier requestuid string unique identifier requeststatus string status value createddatetimeutc string output field createddatetimeutc updateddatetimeutc string output field updateddatetimeutc requester string output field requester excludemissingdevices boolean output field excludemissingdevices metadata object response data pagination object output field pagination example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" {}, "metadata" {} } } ] 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 sortby string optional the sorting field and the direction of sorting 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 nextpage string optional the pagination token for the next page of results pagesize string optional the number of records to be returned per page agentstatus string optional filters results to include responses where agentstatus equals the given value agentstatusempty boolean optional filters results to include responses where agentstatus is empty or null agentstatusnot string optional filters results to include responses where agentstatus does not equal the given value can be used multiple times with different values agentversion string optional filters results to include responses where agentversion equals the given value agentversionnot string optional filters results to include responses where agentversion does not equal the given value can be used multiple times with different values bootdevice string optional filters results to include responses where bootdevice equals the given value bootdevicenot string optional filters results to include responses where bootdevice does not equal the given value can be used multiple times with different values 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 bootdevicestartswith string optional filters results to include responses where bootdevice starts with the given value bssid string optional filters results to include responses where bssid equals the given value bssidnot string optional filters results to include responses where bssid does not equal the given value can be used multiple times with different values classification string optional filters results to include responses where classification equals the given value classificationnot string optional filters results to include responses where classification does not equal the given value can be used multiple times with different values ctesversion string optional filters results to include responses where ctesversion equals the given value ctesversionnot string optional filters results to include responses where ctesversion does not equal the given value can be used multiple times with different values currentnetworkname string optional filters results to include responses where currentnetworkname equals the given value currentnetworknameempty string optional filters results to include responses where currentnetworkname is empty or null currentnetworknamenot string optional filters results to include responses where currentnetworkname does not equal the given value currentusername string optional filters results to include responses where currentusername equals the given value currentusernamecontains string optional filters results to include responses where currentusername contains the given value currentusernameempty boolean optional filters results to include responses where currentusername is empty or null output parameter type description status code number http status code of the response reason string response reason phrase data array response data deviceuid string unique identifier accountuid string unique identifier policygroupname string name of the resource lastconnecteddatetimeutc string output field lastconnecteddatetimeutc dlpstatus object status value isenabled boolean output field isenabled featuretype string type of the resource espstatus object status value isenabled boolean output field isenabled featuretype string type of the resource metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "reason" "ok", "json body" { "data" \[], "metadata" {} } } ] 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 deviceuid string required the system defined unique identifier of the device output parameter type description status code number http status code of the response reason string response reason phrase data array response data devicegroupuid string unique identifier grouptype string type of the resource displayname string name of the resource description string output field description metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" \[], "metadata" {} } } ] 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 nextpage string optional the pagination token for the next page each page contains 100 records pagesize string optional the number of records to be returned per page default 100 maximum 500 output parameter type description status code number http status code of the response reason string response reason phrase data array response data name string name of the resource content string response content createdby string output field createdby changedby string output field changedby messageuid string unique identifier createddatetimeutc string output field createddatetimeutc changeddatetimeutc string output field changeddatetimeutc metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" \[], "metadata" {} } } ] 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 required unique identifier excludemissingdevices boolean optional indicates whether devices that have been reported missing should be excluded from the request output parameter type description status code number http status code of the response reason string response reason phrase data object response data requestuid string unique identifier metadata object response data pagination object output field pagination nextpage string output field nextpage example \[ { "status code" 200, "response headers" {}, "reason" "ok", "json body" { "data" {}, "metadata" {} } } ] 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 notes for more information on absolute absolute api documentation https //api absolute com/api doc/doc html#tag/freeze