Huntress
13 min
this connector integrates huntress rest api with swimlane turbine prerequisites this connector requires the following input parameters to authenticate url api key api secret key capabilities this connector provides the following capabilities get agents get incident reports notes for more information on huntress https //api huntress io/docs#introduction configurations huntress 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 get agents the agents endpoint shows agents associated with your account endpoint url /v1/agents method get input argument name type required description parameters page number optional must be an integer greater than 0 parameters limit number optional must be an integer between 1 and 500 parameters created at min string optional must provide a date greater than january 1st, 2010 parameters created at max string optional must be greater than created at min parameters updated at min string optional must provide a date greater than january 1st, 2010 parameters updated at max string optional must be greater than updated at min parameters organization id number optional the unique identifier of an organization under the account associated with your api credentials will only select agents under this organization parameters platform string optional the platform of the host machine input example {"parameters" {"page" 1,"limit" 10,"created at min" "2022 03 01t18 54 02z","created at max" "2022 04 01t18 54 02z","updated at min" "2022 03 01t20 05 10z","updated at max" "2022 03 01t20 05 10z","organization id" 1,"platform" "windows"}} output parameter type description status code number http status code of the response reason string response reason phrase agents array output field agents agents file name string name of the resource agents file string output field agents file pagination object output field pagination pagination current page number output field pagination current page pagination current page count number count value pagination limit number output field pagination limit pagination total count number count value output example {"status code" 200,"response headers" {"date" "tue, 19 mar 2024 11 05 19 gmt","content type" "application/json","content length" "95","connection" "keep alive","server" "nginx","x huntress api call limit" "60","x huntress api call remaining" "59","etag" "w/\\"0a83153eb468c791fe137282160a7f05\\"","cache control" "max age=0, private, must revalidate","content security policy" "report uri /csp violation; default src 'self' https // huntress io https //hunt ","x request id" "2d70a247 4872 4537 81d8 get incident reports retrive the all the incident reports endpoint url /v1/incident reports method get input argument name type required description parameters page number optional must be an integer greater than 0 parameters limit number optional the number of elements to show per page must be an integer between 1 and 500 parameters updated at min string optional must provide a date greater than january 1st, 2010 parameters updated at max string optional must be greater than updated at min parameters indicator type string optional will return only incident reports whose indicator types include the specified value parameters status string optional will return only incident reports matching the status provided parameters severity string optional will return only incident reports matching the severity provided parameters platform string optional the platform of the host machine (darwin or windows or microsoft 365) parameters organization id number optional the unique identifier of an organization under the account associated with your api credentials will only select incident reports under this organization parameters agent id number optional the unique identifier of an agent under the account associated with your api credentials will only select incident reports under this organization input example {"parameters" {"page" 1,"limit" 10,"updated at min" "2022 03 01t20 05 10z","updated at max" "2022 03 01t20 05 10z","indicator type" "footholds","status" "sent","severity" "low","platform" "windows","organization id" 1,"agent id" 123}} output parameter type description status code number http status code of the response reason string response reason phrase incident reports array unique identifier incident reports file name string unique identifier incident reports file string unique identifier pagination object output field pagination pagination current page number output field pagination current page pagination current page count number count value pagination limit number output field pagination limit pagination total count number count value output example {"status code" 200,"response headers" {"date" "tue, 19 mar 2024 11 05 41 gmt","content type" "application/json","content length" "105","connection" "keep alive","server" "nginx","x huntress api call limit" "60","x huntress api call remaining" "58","etag" "w/\\"5d841252ca41b87733dbaa4b61b19b17\\"","cache control" "max age=0, private, must revalidate","content security policy" "report uri /csp violation; default src 'self' https // huntress io https //hunt ","x request id" "2e5f9f71 8cf9 4b56 8f4 response headers header description example cache control directives for caching mechanisms max age=0, private, must revalidate connection http response header connection keep alive content length the length of the response body in bytes 105 content security policy http response header content security policy report uri /csp violation; default src 'self' https // huntress io https //huntresscdn com ; font src 'self' data https //fonts gstatic com https //beacon v2 helpscout net https //huntresscdn com https //script hotjar com ; style src 'self' 'unsafe inline' https //fonts googleapis com https //beacon v2 helpscout net https //checkout stripe com https //huntresscdn com https //static hotjar com https //script hotjar com https //api canny io ; style src elem 'self' 'unsafe inline' https //fonts googleapis com https //checkout stripe com https //huntresscdn com ; script src 'self' 'unsafe inline' https //www google com https //www gstatic com https //www recaptcha net https //www google analytics com https //www googletagmanager com https //static hotjar com/ https //script hotjar com https //beacon v2 helpscout net https //d12wqas9hcki3z cloudfront net https //d33v4339jhl8k0 cloudfront net https //checkout stripe com https //js stripe com https //canny io https //api canny io https //assets canny io https //static zdassets com https //ekr zdassets com https //huntress zendesk com https //widget mediator zopim com https //api smooch io https //huntresscdn com ; connect src 'self' https // huntress io https //huntress user uploads s3 amazonaws com https // google analytics com https // hotjar com https // hotjar io wss\ // hotjar com https //d3hb14vkzrxvla cloudfront net https //beaconapi helpscout net https //chatapi helpscout net wss\ // pusher com https // sumologic com https //checkout stripe com https //canny io https // canny io wss\ // canny io https //static zdassets com https //ekr zdassets com https //ekr zendesk com https //huntress zendesk com https // zopim com https //api smooch io wss\ //huntress zendesk com wss\ // zopim com wss\ //api smooch io https //sessions bugsnag com https //notify bugsnag com https //huntresscdn com https //us autocomplete pro api smartystreets com https //international autocomplete api smarty com https //webhooks fivetran com ; frame src 'self' https //www google com https //www recaptcha net https //beacon v2 helpscout net https //checkout stripe com https //js stripe com https //canny io https //changelog widget canny io https //app datadoghq com ; object src 'self' https //beacon v2 helpscout net ; img src 'self' data https // huntress io https //huntress user uploads s3 amazonaws com https //www google analytics com https //static hotjar com/ https //script hotjar com https // gravatar com https //beacon v2 helpscout net https //d33v4339jhl8k0 cloudfront net https //linkmaker itunes apple com https // stripe com https //static zdassets com https //ekr zdassets com https //huntress zendesk com https // zopim io https // zdusercontent com https //media smooch io https //huntresscdn com https //s3 eu west 1 amazonaws com ; media src 'self' https //beacon v2 helpscout net https //static zdassets com https //ekr zdassets com https //huntress zendesk com https // zopim io https // zdusercontent com https //huntresscdn com content type the media type of the resource application/json date the date and time at which the message was originated tue, 19 mar 2024 11 05 19 gmt etag an identifier for a specific version of a resource w/"0a83153eb468c791fe137282160a7f05" server information about the software used by the origin server nginx strict transport security http response header strict transport security max age=0 x huntress api call limit http response header x huntress api call limit 60 x huntress api call remaining http response header x huntress api call remaining 58 x request id a unique identifier for the request 2d70a247 4872 4537 81d8 3f8b177f57b0 x runtime http response header x runtime 0 449081