Device42

the device42 connector facilitates seamless integration of device42's robust it asset management capabilities with swimlane's automation platform device42 is a comprehensive data center and network management solution that provides it asset management, ip address tracking, and dependency mapping the device42 connector for swimlane turbine enables users to automate the retrieval of server relationships, contact details, and server information directly within their security workflows by integrating with device42, swimlane turbine users can enhance infrastructure visibility, streamline asset management, and ensure that critical asset information is always at their fingertips for informed decision making and rapid response to security incidents limitations none to date supported versions this connector supports the latest version 1 of the device42 api additional docs device42 api docs https //docs aws amazon com/sns/latest/api/welcome htmldevice42 authentication https //api device42 com/#api authentication configuration prerequisites to effectively utilize the device42 connector with swimlane turbine, ensure you have the following prerequisites http basic authentication with these parameters url the endpoint url for the device42 instance username your device42 username with sufficient permissions password the corresponding password for your device42 account custom authentication with these parameters url the endpoint url for the device42 instance client key a unique identifier for the client application secret key a secret key paired with the client key for authentication authentication methods to effectively utilize the device42 connector with swimlane turbine, ensure you have the following prerequisites custom authentication custom authentication with the following parameters url the endpoint url for the device42 instance client key he client key for the api secret key the secret key for the api http basic authentication http basic authentication with the following parameters url the endpoint url for the device42 instance username your device42 username credential password your device42 password credential capabilities this connector provides the following capabilities link servers to owners or pocs retrieve contact details retrieve server details link servers to owners or pocs retrieve relationships for a specific server, linking it to owners or pocs device42's documentation for this action can be found here https //api device42 com/#api info retrieve contact details fetch user contact information device42's documentation for this action can be found \[here] https //api device42 com/#api info https //api device42 com/#api info ) retrieve server details fetch all servers with detailed information device42's documentation for this action can be found here https //api device42 com/#!/devices/getdevices configurations device42 custom authentication authenticates using client key and secret key configuration parameters parameter description type required url a url to the target host string required client key the client key for the api string required secret key the secret key for the api string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional device42 http basic authentication authenticates using username and password configuration parameters parameter description type required url a url to the target host string required username username string required password password string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions link servers to owners or pocs retrieve and link server relationships to owners or points of contact in device42 using the specified device id endpoint url /api/1 0/device/relationships/{{device id}}/ method get input argument name type required description device id number required the id of the device to retrieve relationships for output parameter type description status code number http status code of the response reason string response reason phrase relationships array output field relationships device id number unique identifier relationship type string type of the resource related person object output field related person person id number unique identifier name string name of the resource email string output field email phone string output field phone department string output field department example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 2 may 2024 20 37 23 gmt" }, "reason" "ok", "json body" { "relationships" \[] } } ] retrieve contact details fetch user contact information from device42, including names, phone numbers, and email addresses endpoint url /api/1 0/people/ method get output parameter type description status code number http status code of the response reason string response reason phrase people array output field people person id number unique identifier name string name of the resource email string output field email phone string output field phone department string output field department example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 2 may 2024 20 37 23 gmt" }, "reason" "ok", "json body" { "people" \[] } } ] retrieve server details fetch detailed information for all servers within device42, including hardware specs, installed software, and network data endpoint url /api/1 0/devices/ method get input argument name type required description type string optional the type of device to filter by output parameter type description status code number http status code of the response reason string response reason phrase devices array output field devices device id number unique identifier name string name of the resource type string type of the resource asset no string output field asset no serial no string output field serial no primary ip string output field primary ip os string output field os cpucount number count value ram string output field ram storage string output field storage custom fields object output field custom fields rack location string output field rack location department string output field department example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 2 may 2024 20 37 23 gmt" }, "reason" "ok", "json body" { "devices" \[] } } ] 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 thu, 2 may 2024 20 37 23 gmt