Zscaler Security

the zscaler security connector enables seamless integration of zscaler's cloud based security services with swimlane's automation capabilities, facilitating real time policy management and threat intelligence zscaler security is a cloud based information security platform that offers comprehensive protection against cyber threats this connector enables swimlane turbine users to automate zscaler policy management and threat response, streamlining security operations by integrating with zscaler security, users can instantly apply configuration changes, manage firewall rules, and update url categories, enhancing their security posture with minimal manual intervention prerequisites to effectively utilize the zscaler security connector within swimlane turbine, ensure you have the following prerequisites client credentials and tenant id authentication with these parameters url the endpoint url for zscaler api services client id your unique identifier for zscaler api access client secret a secret key associated with your client id for authentication tenant id the identifier for your specific zscaler tenant instance scope the scope of access requested for the api token api key authentication with these parameters url the endpoint url for zscaler api services username your zscaler account username password your zscaler account password api token a unique token generated for api access client credential flow authentication authentication uses zscaler's oauth 2 0 client credentials flow via the zidentity platform in order to set up the asset, you need the following url the base url for your zscaler tenant (e g https //zsapi zscaler net ) client id the client id generated in your zscaler zidentity admin portal client secret the client secret associated with your client id tenant id your zscaler tenant domain (e g example zslogin net ) scope the oauth scope required for api access (e g openid offline access ) for step by step setup instructions, see the https //docs swimlane com/authentication guides/zscaler security capabilities the zscaler connector has the following capabilities activate changes block urls unblock urls create url category get url category get md5 report update url category url lookup add url to category remove url from category get firewall filtering policy rules add firewall filtering policy rule update firewall filtering policy rule delete firewall filtering policy rule add ip source group and so on actions setup firewall and ip destination actions the following actions have enumerated inputs types add firewall filtering policy rule update firewall filtering policy rule add ip destination group update ip destination group you can find listed below all the possible values for the following inputs destination ip categories any none other adult material adult themes lingerie bikini nudity pornography sexuality adult sex education k 12 sex education social adult other threat phishing botnet malware site and so on destination countries any none country ad country ae country af country ag country ai country al country am country an country ao country aq country ar country as country at and so on network service actions below are listed all the possible values for enumerated inputs types for add network service and update network service actions tag icmp any udp any tcp any other network service dns netbios ftp gnutella h 323 http https ike imap ils ike nat and so on notes after modifying any configurations, you must activate the changes by using the activate changes action for more details, click https //help zscaler com/zia/getting started zia api#activatechanges https //help zscaler com/zia/api#/ configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required username username string required secret password string required api key api token string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional zscaler microsoft graph api asset tenant id authenticates using client credentials and tenant id configuration parameters parameter description type required url a url to the target host string required tenant id the tenant id string required client id the client id string required client secret the client secret string required scope list of permission scopes for this action array required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions activate configuration changes applies the latest configuration changes in zscaler security to ensure they take immediate effect endpoint url api/v1/status/activate method post output parameter type description status code number http status code of the response reason string response reason phrase status string status value output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","content disposition" "attachment; filename=\\"api json\\"","x zscaler mode" "read write","cache control" "no store, no cache","content type" "application/json","content length" "19","date" "wed, 13 mar 2024 18 34 56 gmt","server" "zscaler"},"reason" "","json body" {"status" "active"}} add firewall filtering policy rule create a new firewall filtering policy rule in zscaler security, specifying name, order, action, and rank endpoint url api/v1/firewallfilteringrules method post input argument name type required description name string optional name of the resource order number optional parameter for add firewall filtering policy rule rank number optional parameter for add firewall filtering policy rule defaultrule boolean optional parameter for add firewall filtering policy rule predefined boolean optional parameter for add firewall filtering policy rule action string optional parameter for add firewall filtering policy rule input example {"json body" {"name" "ip group source 711","order" 1,"rank" 0,"defaultrule"\ false,"predefined"\ false,"action" "allow"}} output parameter type description status code number http status code of the response reason string response reason phrase enablefulllogging boolean output field enablefulllogging id number unique identifier name string name of the resource order number output field order rank number output field rank action string output field action state string output field state destipcategories array output field destipcategories destcountries array output field destcountries destcountries file name string name of the resource destcountries file string output field destcountries file predefined boolean output field predefined defaultrule boolean output field defaultrule output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "207","date" "tue, 29 nov 2022 21 31 19 gmt","server" "zscaler"},"reason" "","json body" {"enablefulllogging"\ false,"id" add ip destination group adds a new ip destination group to zscaler security for efficient management of ip address collections endpoint url api/v1/ipdestinationgroups method post input argument name type required description name string optional name of the resource type string optional type of the resource addresses array optional parameter for add ip destination group description string optional parameter for add ip destination group ipcategories array optional parameter for add ip destination group countries array optional parameter for add ip destination group isnoneditable boolean optional parameter for add ip destination group input example {"json body" {"name" "test","type" "dstn ip","addresses" \["1 0 0 0"],"description" "string","ipcategories" \["custom 01"],"countries" \["country bd"],"isnoneditable"\ true}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource type string type of the resource addresses array output field addresses description string output field description ipcategories array output field ipcategories countries array output field countries isnoneditable boolean output field isnoneditable output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "170","date" "tue, 29 nov 2022 19 06 37 gmt","server" "zscaler"},"reason" "","json body" {"id" 17531270,"name" "test","ty add ip source group adds a new ip source group to zscaler security using the specified name in the json body endpoint url api/v1/ipsourcegroups method post input argument name type required description name string optional name of the resource ipaddresses array optional parameter for add ip source group description string optional parameter for add ip source group isnoneditable boolean optional parameter for add ip source group input example {"json body" {"name" "unique name in here","ipaddresses" \["1 0 0 0"],"description" "a description","isnoneditable"\ false}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource ipaddresses array output field ipaddresses description string output field description isnoneditable boolean output field isnoneditable output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "122","date" "tue, 29 nov 2022 20 13 49 gmt","server" "zscaler"},"reason" "","json body" {"id" 17531274,"name" "unique na add network service create a new network service in zscaler security by specifying at least one destination tcp or udp port endpoint url api/v1/networkservices method post input argument name type required description name string optional name of the resource srctcpports array optional parameter for add network service srctcpports file name string required name of the resource srctcpports file string required parameter for add network service desttcpports array optional parameter for add network service desttcpports start number optional parameter for add network service desttcpports end number optional parameter for add network service type string optional type of the resource creatorcontext string optional parameter for add network service isnamel10ntag boolean optional name of the resource srcudpports array optional parameter for add network service srcudpports start number optional parameter for add network service srcudpports end number optional parameter for add network service destudpports array optional parameter for add network service destudpports start number optional parameter for add network service destudpports end number optional parameter for add network service description string optional parameter for add network service input example {"json body" {"name" "renamed network service1234","srctcpports" \[],"desttcpports" \[{"start" 1,"end" 100},{"start" 200,"end" 666}],"type" "custom","creatorcontext" "zia","isnamel10ntag"\ false,"srcudpports" \[{"start" 1,"end" 2}],"destudpports" \[{"start" 1,"end" 2}],"description" "a description"}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource srctcpports array output field srctcpports srctcpports file name string name of the resource srctcpports file string output field srctcpports file desttcpports array output field desttcpports desttcpports start number output field desttcpports start desttcpports end number output field desttcpports end srcudpports array output field srcudpports srcudpports start number output field srcudpports start srcudpports end number output field srcudpports end destudpports array output field destudpports destudpports start number output field destudpports start destudpports end number output field destudpports end type string type of the resource description string output field description creatorcontext string output field creatorcontext isnamel10ntag boolean name of the resource output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "296","date" "tue, 29 nov 2022 14 22 17 gmt","server" "zscaler"},"reason" "","json body" {"id" 17531231,"name" "renamed n blacklist urls adds or removes urls from the zscaler denylist, requiring an 'action' parameter and a list of 'blacklisturls' endpoint url api/v1/security/advanced/blacklisturls method post input argument name type required description parameters action string required the action applied to the advanced threat protection policy’s denylist (i e , adding a url or removing a url) blacklisturls array optional urls on the denylist for your organization allow up to 25000 urls input example {"parameters" {"action" "add to list"},"json body" {"blacklisturls" \["www google com"]}} output parameter type description status code number http status code of the response reason string response reason phrase blacklisturls array url endpoint for the request output example {"status code" 200,"response headers" {"content type" "application/json","content length" "160","connection" "keep alive","strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","cache control" "no store, no cache","content disposition" "attachment; filename=\\"api json\\"","x zscaler mode" "read write","date" "fri, 13 sep 2024 13 39 32 gmt","server" "zscaler","x cache" "miss from create url category creates a new url category within zscaler security using the provided id in the json body input endpoint url api/v1/urlcategories method post input argument name type required description id string optional unique identifier supercategory string optional parameter for create url category configuredname string optional name of the resource keywords array optional parameter for create url category keywordsretainingparentcategory array optional parameter for create url category urls array optional url endpoint for the request dbcategorizedurls array optional url endpoint for the request customcategory boolean optional parameter for create url category editable boolean optional parameter for create url category description string optional parameter for create url category type string optional type of the resource urlkeywordcounts object optional url endpoint for the request urlkeywordcounts totalurlcount number optional url endpoint for the request urlkeywordcounts retainparenturlcount number optional url endpoint for the request urlkeywordcounts totalkeywordcount number optional url endpoint for the request urlkeywordcounts retainparentkeywordcount number optional url endpoint for the request customurlscount number optional url endpoint for the request input example {"json body" {"id" "any","supercategory" "news and media","configuredname" "string","keywords" \["string"],"keywordsretainingparentcategory" \["other adult material"],"urls" \["https //myurl com"],"dbcategorizedurls" \["string"],"customcategory"\ false,"editable"\ false,"description" "string","type" "url category","urlkeywordcounts" {"totalurlcount" 1,"retainparenturlcount" 1,"totalkeywordcount" 1,"retainparentkeywordcount" 1},"customurlscount" 0}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier configuredname string name of the resource supercategory string output field supercategory keywords array output field keywords keywords file name string name of the resource keywords file string output field keywords file keywordsretainingparentcategory array output field keywordsretainingparentcategory urls array url endpoint for the request urls file name string url endpoint for the request urls file string url endpoint for the request dbcategorizedurls array url endpoint for the request dbcategorizedurls file name string url endpoint for the request dbcategorizedurls file string url endpoint for the request customcategory boolean output field customcategory editable boolean output field editable description string output field description type string type of the resource val number output field val customurlscount number url endpoint for the request urlsretainingparentcategorycount number url endpoint for the request customiprangescount number count value iprangesretainingparentcategorycount number count value output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "407","date" "tue, 29 nov 2022 18 07 45 gmt","server" "zscaler"},"reason" "","json body" {"id" "custom 11","configurednam delete firewall filtering policy rule removes a specific firewall filtering policy rule from zscaler security using the provided rule id endpoint url api/v1/firewallfilteringrules/{{rule id}} method delete input argument name type required description path parameters rule id string required parameters for the delete firewall filtering policy rule action input example {"path parameters" {"rule id" "248300"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","date" "tue, 29 nov 2022 21 36 53 gmt","server" "zscaler"},"reason" "","response text" ""} delete ip destination group removes a specified ip destination group from zscaler security using the provided unique ip group id endpoint url api/v1/ipdestinationgroups/{{ip group id}} method delete input argument name type required description path parameters ip group id string required parameters for the delete ip destination group action input example {"path parameters" {"ip group id" "17478025"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","date" "tue, 29 nov 2022 19 40 10 gmt","server" "zscaler"},"reason" "","response text" ""} delete ip source group removes a specified ip source group from zscaler security using the unique ip group id provided endpoint url /api/v1/ipsourcegroups/{{ip group id}} method delete input argument name type required description path parameters ip group id string required parameters for the delete ip source group action input example {"path parameters" {"ip group id" "14570789"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","date" "tue, 29 nov 2022 20 18 10 gmt","server" "zscaler"},"reason" "","response text" ""} delete network service removes a specified network service from zscaler security using the provided network service id endpoint url api/v1/networkservices/{{network service id}} method delete input argument name type required description path parameters network service id string required parameters for the delete network service action input example {"path parameters" {"network service id" "14573795"}} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 204,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","date" "tue, 29 nov 2022 14 16 27 gmt","server" "zscaler"},"reason" "","response text" ""} get firewall filtering policy rules retrieves all rules within the firewall filtering policy for a specified rule id in zscaler security endpoint url api/v1/firewallfilteringrules/{{rule id}} method get input argument name type required description path parameters rule id string required parameters for the get firewall filtering policy rules action name string optional name of the resource input example {"json body" {"name" "ip group source 7"},"path parameters" {"rule id" "13055202"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","vary" "accept encoding","content type" "application/json","content length" "5462","date" "tue, 29 nov 2022 20 54 52 gmt","server" "zscaler"},"reason" "","json body" \[{"acc get ip destination groups retrieve details for a specific ip destination group in zscaler security using the provided unique group id endpoint url api/v1/ipdestinationgroups/{{ip group id}} method get input argument name type required description path parameters ip group id string required parameters for the get ip destination groups action input example {"path parameters" {"ip group id" "17478027"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","vary" "accept encoding","content type" "application/json","content length" "2503","date" "tue, 29 nov 2022 19 16 21 gmt","server" "zscaler"},"reason" "","json body" \[{"id" get ip source groups retrieves a list of ip source groups from zscaler security using the specified ip group id for targeted information endpoint url api/v1/ipsourcegroups/{{ip group id}} method get input argument name type required description path parameters ip group id string required parameters for the get ip source groups action input example {"path parameters" {"ip group id" "14570789"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","vary" "accept encoding","content type" "application/json","content length" "1461","date" "tue, 29 nov 2022 19 48 09 gmt","server" "zscaler"},"reason" "","json body" \[{"id" get network services retrieve a list of network services or specific service details from zscaler security, with optional filtering by service id endpoint url /api/v1/networkservices method get input argument name type required description network service id string optional unique identifier input example {"network service id" "13303217"} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","vary" "accept encoding","content type" "application/json","transfer encoding" "chunked","date" "mon, 28 nov 2022 20 35 40 gmt","server" "zscaler"},"reason" "","json body" get url categories retrieve and classify web content with a list of url categories from zscaler security endpoint url api/v1/urlcategories method get input argument name type required description data body object optional data body headers object optional request headers input example {"path parameters" {},"parameters" {},"data body" {},"headers" {}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","vary" "accept encoding","content type" "application/json","transfer encoding" "chunked","date" "tue, 29 nov 2022 15 41 09 gmt","server" "zscaler"},"reason" "","json body" sandbox get md5 report retrieve a detailed sandbox report for a given md5 hash from zscaler security, utilizing the 'md5' path parameter endpoint url api/v1/sandbox/report/{{md5}} method get input argument name type required description path parameters md5 string required parameters for the sandbox get md5 report action input example {"path parameters" {"md5" "1f3870be274f6c49b3e31a0c6728957f"}} output parameter type description status code number http status code of the response reason string response reason phrase summary string output field summary output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "90","date" "tue, 29 nov 2022 21 40 34 gmt","server" "zscaler"},"reason" "","json body" {"summary" "md5 is unknown or ana update firewall filtering policy rule updates a zscaler security firewall filtering policy rule using the provided rule id and parameters like name, action, order, and rank endpoint url api/v1/firewallfilteringrules/{{rule id}} method put input argument name type required description path parameters rule id string required parameters for the update firewall filtering policy rule action name string optional name of the resource order number optional parameter for update firewall filtering policy rule rank number optional parameter for update firewall filtering policy rule defaultrule boolean optional parameter for update firewall filtering policy rule predefined boolean optional parameter for update firewall filtering policy rule action string optional parameter for update firewall filtering policy rule input example {"json body" {"name" "ip group source 71","order" 1,"rank" 0,"defaultrule"\ false,"predefined"\ false,"action" "allow"},"path parameters" {"rule id" "248300"}} output parameter type description status code number http status code of the response reason string response reason phrase enablefulllogging boolean output field enablefulllogging id number unique identifier name string name of the resource order number output field order rank number output field rank action string output field action state string output field state destipcategories array output field destipcategories destcountries array output field destcountries destcountries file name string name of the resource destcountries file string output field destcountries file predefined boolean output field predefined defaultrule boolean output field defaultrule output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "206","date" "tue, 29 nov 2022 21 27 11 gmt","server" "zscaler"},"reason" "","json body" {"enablefulllogging"\ false,"id" update ip destination group updates an existing ip destination group in zscaler security using the specified group id endpoint url api/v1/ipdestinationgroups/{{ip group id}} method put input argument name type required description path parameters ip group id string required parameters for the update ip destination group action name string optional name of the resource type string optional type of the resource addresses array optional parameter for update ip destination group description string optional parameter for update ip destination group ipcategories array optional parameter for update ip destination group countries array optional parameter for update ip destination group isnoneditable boolean optional parameter for update ip destination group input example {"json body" {"name" "test","type" "dstn ip","addresses" \["1 0 0 0"],"description" "string","ipcategories" \["custom 01"],"countries" \["country bd"],"isnoneditable"\ true},"path parameters" {"ip group id" "17531270"}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource type string type of the resource addresses array output field addresses description string output field description creatorcontext string output field creatorcontext ipcategories array output field ipcategories countries array output field countries output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "172","date" "tue, 29 nov 2022 19 36 30 gmt","server" "zscaler"},"reason" "","json body" {"id" 17531270,"name" "test","ty update ip source group updates an existing ip source group in zscaler security using the specified ip group id endpoint url api/v1/ipsourcegroups/{{ip group id}} method put input argument name type required description path parameters ip group id string required parameters for the update ip source group action name string optional name of the resource ipaddresses array optional parameter for update ip source group description string optional parameter for update ip source group isnoneditable boolean optional parameter for update ip source group input example {"json body" {"name" "string","ipaddresses" \["1 0 0 0"],"description" "anythings","isnoneditable"\ false},"path parameters" {"ip group id" "14570789"}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource ipaddresses array output field ipaddresses description string output field description creatorcontext string output field creatorcontext output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "106","date" "tue, 29 nov 2022 20 07 11 gmt","server" "zscaler"},"reason" "","json body" {"id" 14570789,"name" "string"," update network service updates a specified network service in zscaler security using the provided network service id endpoint url api/v1/networkservices/{{network service id}} method put input argument name type required description path parameters network service id string required parameters for the update network service action name string optional name of the resource srctcpports array optional parameter for update network service srctcpports file name string required name of the resource srctcpports file string required parameter for update network service desttcpports array optional parameter for update network service desttcpports start number optional parameter for update network service desttcpports end number optional parameter for update network service type string optional type of the resource creatorcontext string optional parameter for update network service isnamel10ntag boolean optional name of the resource srcudpports array optional parameter for update network service srcudpports start number optional parameter for update network service srcudpports end number optional parameter for update network service destudpports array optional parameter for update network service destudpports start number optional parameter for update network service destudpports end number optional parameter for update network service description string optional parameter for update network service input example {"json body" {"name" "renamed this network service1234","srctcpports" \[],"desttcpports" \[{"start" 2,"end" 100},{"start" 201,"end" 666}],"type" "custom","creatorcontext" "zia","isnamel10ntag"\ false,"srcudpports" \[{"start" 2,"end" 3}],"destudpports" \[{"start" 2,"end" 3}],"description" "a description again"},"path parameters" {"network service id" "17531231"}} output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier name string name of the resource srctcpports array output field srctcpports srctcpports file name string name of the resource srctcpports file string output field srctcpports file desttcpports array output field desttcpports desttcpports start number output field desttcpports start desttcpports end number output field desttcpports end srcudpports array output field srcudpports srcudpports start number output field srcudpports start srcudpports end number output field srcudpports end destudpports array output field destudpports destudpports start number output field destudpports start destudpports end number output field destudpports end type string type of the resource description string output field description creatorcontext string output field creatorcontext isnamel10ntag boolean name of the resource output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "307","date" "tue, 29 nov 2022 15 37 27 gmt","server" "zscaler"},"reason" "","json body" {"id" 17531231,"name" "renamed t update url category updates a specified url category in zscaler security by adding or removing items, requiring the url category id and action parameters endpoint url api/v1/urlcategories/{{url category id}} method put input argument name type required description path parameters url category id string required parameters for the update url category action parameters action string required parameters for the update url category action configuredname string optional name of the resource keywords array optional parameter for update url category keywordsretainingparentcategory array optional parameter for update url category urls array optional url endpoint for the request dbcategorizedurls array optional url endpoint for the request customcategory boolean optional parameter for update url category editable boolean optional parameter for update url category description string optional parameter for update url category type string optional type of the resource urlkeywordcounts object optional url endpoint for the request urlkeywordcounts totalurlcount number optional url endpoint for the request urlkeywordcounts retainparenturlcount number optional url endpoint for the request urlkeywordcounts totalkeywordcount number optional url endpoint for the request urlkeywordcounts retainparentkeywordcount number optional url endpoint for the request customurlscount number optional url endpoint for the request urlsretainingparentcategorycount number optional url endpoint for the request iprangesretainingparentcategorycount number optional count value input example {"parameters" {"action" "add to list"},"json body" {"configuredname" "string","keywords" \["string"],"keywordsretainingparentcategory" \["string"],"urls" \["www google com"],"dbcategorizedurls" \["www google com"],"customcategory"\ false,"editable"\ false,"description" "string","type" "url category","urlkeywordcounts" {"totalurlcount" 0,"retainparenturlcount" 0,"totalkeywordcount" 0,"retainparentkeywordcount" 0},"customurlscount" 0,"urlsretainingparentcategorycount" 0,"iprangesretainingparentcategorycount" 0},"path parameters" {"url category id" "lingerie bikini"}} output parameter type description status code number http status code of the response reason string response reason phrase id string unique identifier keywords array output field keywords keywords file name string name of the resource keywords file string output field keywords file keywordsretainingparentcategory array output field keywordsretainingparentcategory urls array url endpoint for the request urls file name string url endpoint for the request urls file string url endpoint for the request dbcategorizedurls array url endpoint for the request customcategory boolean output field customcategory editable boolean output field editable description string output field description type string type of the resource val number output field val customurlscount number url endpoint for the request urlsretainingparentcategorycount number url endpoint for the request customiprangescount number count value iprangesretainingparentcategorycount number count value output example {"status code" 200,"response headers" {"strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","x zscaler mode" "read write","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store","content type" "application/json","content length" "360","date" "tue, 29 nov 2022 17 11 42 gmt","server" "zscaler"},"reason" "","json body" {"id" "lingerie bikini","keyword url lookup retrieve zscaler's default classification for a specified set of urls using the provided json body input endpoint url /api/v1/urllookup method post output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"content type" "application/json","content length" "233","connection" "keep alive","strict transport security" "max age=31622400;includesubdomains;preload","x frame options" "sameorigin","x content type options" "nosniff","x xss protection" "1; mode=block","content disposition" "attachment; filename=\\"api json\\"","cache control" "no store, no cache","x zscaler mode" "read write","date" "thu, 26 sep 2024 06 09 52 gmt","server" "zscaler","x cache" "miss from response headers header description example alt svc http response header alt svc h3=" 443 "; ma=86400 cache control directives for caching mechanisms no store, no cache connection http response header connection keep alive content disposition http response header content disposition attachment; filename="api json" content length the length of the response body in bytes 106 content type the media type of the resource application/json date the date and time at which the message was originated wed, 13 mar 2024 18 34 56 gmt server information about the software used by the origin server zscaler strict transport security http response header strict transport security max age=31622400;includesubdomains;preload transfer encoding http response header transfer encoding chunked vary http response header vary accept encoding via http response header via 1 1 dbae6b2ce4cce2f7c1803757a782b3e6 cloudfront net (cloudfront) x amz cf id http response header x amz cf id apyv1rzflmxmedmr8v2egobtfc3cz83hy mspezdulnbgfkq9v5xsg== x amz cf pop http response header x amz cf pop hyd57 p4 x cache http response header x cache miss from cloudfront x content type options http response header x content type options nosniff x frame options http response header x frame options sameorigin x xss protection http response header x xss protection 1; mode=block x zscaler mode http response header x zscaler mode read write