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 https //docs aws amazon com/sns/latest/api/welcome html 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 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 ) retrieve server details fetch all servers with detailed information device42's documentation for this action can be found 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 path parameters device id number required the id of the device to retrieve relationships for input example {"path parameters" {"device id" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase relationships array output field relationships relationships device id number unique identifier relationships relationship type string type of the resource relationships related person object output field relationships related person relationships related person person id number unique identifier relationships related person name string name of the resource relationships related person email string output field relationships related person email relationships related person phone string output field relationships related person phone relationships related person department string output field relationships related person department output 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 people person id number unique identifier people name string name of the resource people email string output field people email people phone string output field people phone people department string output field people department output 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 parameters type string optional the type of device to filter by input example {"parameters" {"type" "server"}} output parameter type description status code number http status code of the response reason string response reason phrase devices array output field devices devices device id number unique identifier devices name string name of the resource devices type string type of the resource devices asset no string output field devices asset no devices serial no string output field devices serial no devices primary ip string output field devices primary ip devices os string output field devices os devices cpucount number count value devices ram string output field devices ram devices storage string output field devices storage devices custom fields object output field devices custom fields devices custom fields rack location string output field devices custom fields rack location devices custom fields department string output field devices custom fields department output 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