Cisco Umbrella Managed Service Providers

cisco umbrella managed service providers connector allows msps to manage customer environments and security policies efficiently cisco umbrella is a cloud delivered security service that provides comprehensive threat protection and internet security this connector enables seamless integration with cisco umbrella managed service providers, allowing swimlane turbine users to automate customer management tasks such as creating, updating, and deleting customer records by leveraging this integration, users can streamline operations, enhance threat response capabilities, and improve overall security posture through automated workflows prerequisites before you can use the cisco umbrella managed service providers connector for turbine, you'll need access to the cisco umbrella api this requires the following http basic authentication using the following parameters url the endpoint url for accessing cisco umbrella services username your cisco umbrella account username password the password associated with your cisco umbrella account capabilities the cisco umbrella management connector has the following capabilities create customer for provider get customer for provider update customer for provider delete customer for provider list customers for provider create customer for managed provider get customer for managed provider update customer for managed provider delete customer for managed provider list customers for managed provider create customer for provider create a customer for a provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/create customer for provider/ get customer for provider get a customer for the provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/get customer for provider/ update customer for provider update a customer for a provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/update customer for provider/ delete customer for provider delete a customer for a provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/delete customer for provider/ list customers for provider list the customers for the provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/list customers for provider/ create customer for managed provider create a customer for a managed provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/create customer for managed provider/ get customer for managed provider get a customer for the managed provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/get customer for managed provider/ update customer for managed provider update a customer for a managed provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/update customer for managed provider/ delete customer for managed provider delete a customer for the managed provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/delete customer for managed provider/ list customers for managed provider list the customers for the managed provider cisco umbrella's documentation for this action can be found here https //developer cisco com/docs/cloud security/list customers for managed provider/ 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 create customer for managed provider create a customer for a managed provider in cisco umbrella requires customername and seats in the json body endpoint url /managed/customers method post input argument name type required description customername string optional the name of the customer's organization seats number optional the number of users input example {"json body" {"customername" "cisco","seats" 100}} output parameter type description status code number http status code of the response reason string response reason phrase customerid number unique identifier customername string name of the resource seats number output field seats output example {"status code" 200,"reason" "ok","json body" {"customerid" 12929,"customername" "cisco","seats" 1000}} create customer for provider create a customer for a provider in cisco umbrella using details like packageid, seats, city, countrycode, customername, streetaddress, and adminemails endpoint url /providers/customers method post input argument name type required description customername string optional the name of the customer's organization seats number optional the number of users addonrbi string optional remote browser isolation add on dealid string optional the deal id licensetype string optional the customer's license type streetaddress string optional the street address for the customer streetaddress2 string optional the second street address for the customer zipcode string optional the zip code of the customer's organization addoncdfwl7 boolean optional l7 cloud delivered firewall solution addondlp boolean optional data loss prevention add on istrial boolean optional specify whether the customer is a trial with an mssp with spla (msla) license city string optional the name of the city where the customer's organization is located state string optional the name of the customer's state countrycode string optional the country code of the customer's organization packageid number optional the id of the umbrella package adminemails array optional parameter for create customer for provider ccwdealowneremails array optional parameter for create customer for provider input example {"json body" {"customername" "cisco","seats" 1000,"addonrbi" "0","dealid" "1234567890","licensetype" "msla","streetaddress" "123 customer way","streetaddress2" "123a mystreet2 place","zipcode" "12345","addoncdfwl7"\ true,"addondlp"\ true,"istrial"\ true,"city" "san jose","state" "ca","countrycode" "1a","packageid" 250,"adminemails" \["company\@cisco com"],"ccwdealowneremails" \["dealowner\@acmetech com"]}} output parameter type description status code number http status code of the response reason string response reason phrase customerid number unique identifier customername string name of the resource licensetype string type of the resource packagename string name of the resource seats number output field seats streetaddress string output field streetaddress streetaddress2 string output field streetaddress2 city string output field city state string output field state countrycode string output field countrycode zipcode string output field zipcode packageid number unique identifier dealid string unique identifier adminemails array output field adminemails output example {"status code" 200,"reason" "ok","json body" {"customerid" 1234,"customername" "mycustomername","licensetype" "thelicensetype","packagename" "umbrella sig essentials","seats" 1000,"streetaddress" "123 mystreet rd ","streetaddress2" "123a mystreet2 place","city" "mycity","state" "ca","countrycode" "12a","zipcode" "12345a","packageid" 101,"dealid" "mydealid","adminemails" \["you\@myeamil com"]}} delete customer for managed provider delete a customer for the managed provider in cisco umbrella using the required customerid path parameter endpoint url /managed/customers/{{customerid}} method delete input argument name type required description path parameters customerid number required the id of the customer input example {"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"reason" "ok","json body" {}} delete customer for provider remove a customer from a provider in cisco umbrella managed service providers using the customerid path parameter endpoint url /providers/customers/{{customerid}} method delete input argument name type required description path parameters customerid number required the id of the customer input example {"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"reason" "ok","json body" {}} get customer for managed provider retrieve customer details for a managed provider in cisco umbrella using the customerid path parameter endpoint url /managed/customers/{{customerid}} method get input argument name type required description path parameters customerid number required the id of the customer input example {"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase message string response message output example {"status code" 200,"reason" "ok","json body" {"message" "customer retrieved successfully"}} get customer for provider get details of a specific customer for the provider in cisco umbrella using the customerid path parameter endpoint url /providers/customers/{{customerid}} method get input argument name type required description path parameters customerid number required the id of the customer input example {"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase customerid number unique identifier customername string name of the resource licensetype string type of the resource packagename string name of the resource seats number output field seats streetaddress string output field streetaddress streetaddress2 string output field streetaddress2 city string output field city state string output field state countrycode string output field countrycode zipcode string output field zipcode packageid number unique identifier dealid string unique identifier adminemails array output field adminemails output example {"status code" 200,"reason" "ok","json body" {"customerid" 1234,"customername" "mycustomername","licensetype" "thelicensetype","packagename" "umbrella sig essentials","seats" 1000,"streetaddress" "123 mystreet rd ","streetaddress2" "123a mystreet2 place","city" "mycity","state" "ca","countrycode" "12a","zipcode" "12345a","packageid" 101,"dealid" "mydealid","adminemails" \["you\@myeamil com"]}} list customers for managed provider list the customers associated with a managed provider in cisco umbrella endpoint url /managed/customers method get input argument name type required description parameters limit number optional the number of customers to return parameters page number optional the page number input example {"parameters" {"limit" 100,"page" 1}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"reason" "ok","json body" \[{"customerid" 12929,"customername" "cisco","seats" 1000}]} list customers for provider list all customers associated with a cisco umbrella managed service provider endpoint url /providers/customers method get input argument name type required description parameters limit number optional the number of customers to return parameters page number optional the page number to return input example {"parameters" {"limit" 100,"page" 1}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"reason" "ok","json body" \[{"customerid" 1234,"customername" "mycustomername","licensetype" "thelicensetype","packagename" "umbrella sig essentials","seats" 1000,"streetaddress" "123 mystreet rd ","streetaddress2" "123a mystreet2 place","city" "mycity","state" "ca","countrycode" "12a","zipcode" "12345a","packageid" 101,"dealid" "mydealid","adminemails" \[]}]} update customer for managed provider update customer details for a managed provider in cisco umbrella requires customerid as path parameter and customername, seats in json body endpoint url /managed/customers/{{customerid}} method put input argument name type required description path parameters customerid number required the id of the customer customername string optional the name of the customer's organization seats number optional the number of users input example {"json body" {"customername" "cisco","seats" 1000},"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase customerid number unique identifier customername string name of the resource seats number output field seats output example {"status code" 200,"reason" "ok","json body" {"customerid" 12929,"customername" "cisco","seats" 1000}} update customer for provider update customer information for a provider in cisco umbrella, requiring customerid, packageid, seats, city, countrycode, customername, streetaddress, and adminemails endpoint url /providers/customers/{{customerid}} method put input argument name type required description path parameters customerid number required the id of the customer customername string optional the name of the customer's organization seats number optional the number of users dealid string optional the deal id streetaddress string optional the street address for the customer streetaddress2 string optional the second street address for the customer zipcode string optional the zip code of the customer's organization city string optional the name of the city where the customer's organization is located state string optional the name of the state where the customer's organization is located countrycode string optional the country code of the customer's organization packageid number optional the id of the umbrella package adminemails array optional the email addresses of the customer's administrators ccwdealowneremails array optional the email addresses of the customer's ccw deal owner input example {"json body" {"customername" "cisco","seats" 1000,"dealid" "1234567890","streetaddress" "123 customer way","streetaddress2" "123a mystreet2 place","zipcode" "12345","city" "san jose","state" "ca","countrycode" "1a","packageid" 250,"adminemails" \["company\@cisco com"],"ccwdealowneremails" \["dealowner\@acmetech com"]},"path parameters" {"customerid" 1234}} output parameter type description status code number http status code of the response reason string response reason phrase customerid number unique identifier customername string name of the resource licensetype string type of the resource packagename string name of the resource seats number output field seats streetaddress string output field streetaddress streetaddress2 string output field streetaddress2 city string output field city state string output field state countrycode string output field countrycode zipcode string output field zipcode packageid number unique identifier dealid string unique identifier adminemails array output field adminemails output example {"status code" 200,"reason" "ok","json body" {"customerid" 1234,"customername" "mycustomername","licensetype" "thelicensetype","packagename" "umbrella sig essentials","seats" 1000,"streetaddress" "123 mystreet rd ","streetaddress2" "123a mystreet2 place","city" "mycity","state" "ca","countrycode" "12a","zipcode" "12345a","packageid" 101,"dealid" "mydealid","adminemails" \["you\@myeamil com"]}} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt