Cisco Umbrella Managed Service Providers
9 min
the cisco umbrella managed service providers connector integrates with turbine to manage msps prerequisites the msps (msp and multi org consoles) endpoints require a msp id (mspid) use your umbrella management api key and secret to authorize an api request for more information about creating a legacy umbrella api key, see authentication https //developer cisco com/docs/cloud security/#!umbrella legacy authentication capabilities the cisco umbrella management connector has the following capabilities find the customers for the msp configurations 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 list customers list the msp customers endpoint url v1/msps/{{mspid}}/customers method get input argument name type required description mspid number required unique identifier page number optional parameter for list customers limit number optional parameter for list customers output parameter type description status code number http status code of the response reason string response reason phrase example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "transfer encoding" "chunked", "connection" "keep alive", "x ratelimit limit second" "5", "x ratelimit remaining second" "4", "x ratelimit limit minute" "14", "x ratelimit remaining minute" "13", "x ratelimit limit 1800" "350", "x ratelimit remaining 1800" "349", "ratelimit limit" "5", "ratelimit remaining" "4", "ratelimit reset" "1", "date" "thu, 23 feb 2023 20 07 12 gmt", "cache control" "no cache", "vary" "accept encoding" }, "reason" "ok", "json body" \[ {} ] } ] response headers header description example cache control directives for caching mechanisms no cache connection http response header connection keep alive content encoding http response header content encoding gzip content type the media type of the resource application/json; charset=utf 8 date the date and time at which the message was originated thu, 23 feb 2023 20 07 12 gmt ratelimit limit http response header ratelimit limit 5 ratelimit remaining http response header ratelimit remaining 4 ratelimit reset http response header ratelimit reset 1 strict transport security http response header strict transport security max age=31536000; includesubdomains transfer encoding http response header transfer encoding chunked vary http response header vary accept encoding x content type options http response header x content type options nosniff x frame options http response header x frame options sameorigin x ratelimit limit 1800 http response header x ratelimit limit 1800 350 x ratelimit limit minute http response header x ratelimit limit minute 14 x ratelimit limit second http response header x ratelimit limit second 5 x ratelimit remaining 1800 http response header x ratelimit remaining 1800 349 x ratelimit remaining minute http response header x ratelimit remaining minute 13 x ratelimit remaining second http response header x ratelimit remaining second 4 x xss protection http response header x xss protection 1; mode=block