Update Security Profile - Cloud Security API

{"type":"api","title":"Update Security Profile","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/73390bb1-ff0a-387e-9a8f-4e95641829f2","info":{"title":"Cisco Secure Access Security Profiles API","version":"1.0.1","description":"View and manage the Security profiles in the Secure Access organization.","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Security Profiles","description":"The Security profiles in the organization."},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/policies/security-profiles-overview.md","uri":"secure-access-api-reference-security-profiles-overview"}},"openapi":"3.1.0","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"policies/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"The client credential flow.","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"policies.securityProfiles:read":"Read Security Profiles","policies.securityProfiles:write":"Write Security Profiles"}}}}}},"spec":{"summary":"Update Security Profile","description":"Update a Security profile.","tags":["Security Profiles","Secure Access"],"operationId":"updateSecurityProfile","parameters":[{"in":"path","name":"profileId","description":"The ID of the Security profile.","required":true,"schema":{"type":"integer"},"$$ref":"#/components/parameters/profileId"}],"requestBody":{"description":"The properties used to update the Security profile.","required":true,"content":{"application/json":{"schema":{"description":"The properties used to update a security profile.","type":"object","required":["name","aupSettingGroupId","landerSettingGroupId","securitySettingGroupId"],"properties":{"name":{"type":"string","description":"The name of the Security profile.","example":"System Provided - Private Access","$$ref":"#/components/schemas/name"},"aupSettingGroupId":{"type":"integer","nullable":true,"example":9,"description":"The group ID of the Category setting.","$$ref":"#/components/schemas/aupSettingGroupId"},"applicationAupSettingGroupId":{"type":"integer","nullable":true,"example":1139310,"description":"The group ID of the Application setting.","$$ref":"#/components/schemas/applicationAupSettingGroupId"},"fileInspectionSettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the File Inspection setting.","$$ref":"#/components/schemas/fileInspectionSettingGroupId"},"landerSettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Notification setting.","$$ref":"#/components/schemas/landerSettingGroupId"},"policySettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Policy setting.","$$ref":"#/components/schemas/policySettingGroupId"},"securitySettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Security setting.","$$ref":"#/components/schemas/securitySettingGroupId"},"settingGroupBypassInspectionGroupId":{"type":"integer","nullable":true,"example":1139310,"description":"The group ID of the Bypass Inspection setting.","$$ref":"#/components/schemas/settingGroupBypassInspectionGroupId"},"priority":{"type":"integer","description":"The priority of the Security profile.","example":1139310,"$$ref":"#/components/schemas/priority"},"reporting":{"type":"string","description":"Specifies whether the system enables or disables the reporting of the Security profile setting.","enum":["enabled","disabled"],"example":"enabled","$$ref":"#/components/schemas/reporting"},"fileEngines":{"description":"Specifies whether file inspection engines is enabled for the profile.","type":"boolean","example":true,"$$ref":"#/components/schemas/fileEngines"},"tgSandbox":{"description":"Specifies whether Cisco Secure Malware Analytics is enabled for the profile.","type":"boolean","example":false,"$$ref":"#/components/schemas/tgSandbox"},"fileTypeControlStatus":{"description":"Specifies whether file type control should be enabled for the profile.","type":"boolean","example":true,"$$ref":"#/components/schemas/fileTypeControlStatus"},"saml":{"description":"Specifies if the SAML mode flag is exposed at the root request level.","type":"integer","enum":[0,1],"example":1,"$$ref":"#/components/schemas/saml"},"safeSearch":{"description":"Specifies whether Safe Search is enabled for the Security profile.","type":"boolean","example":true,"$$ref":"#/components/schemas/safeSearch"},"aiSupplyChainCategories":{"description":"The encoded AI supply chain category bitmask value applied at the root request level.\nSample values include 0 and encoded values such as C00000000000000000000000000000000000000000000000000000.","type":"string","example":"C00000000000000000000000000000000000000000000000000000","$$ref":"#/components/schemas/aiSupplyChainCategories"},"fileTypeBlockedForDownload":{"description":"The list of identifiers for the file types blocked from downloads at the root request level.","type":"array","items":{"type":"integer","description":"The identifier of the file type for blocking downloads.","minimum":0},"example":[16,17,18],"$$ref":"#/components/schemas/fileTypeBlockedForDownload"},"fileTypeBlockedForUpload":{"description":"The list of identifiers for the file types blocked from uploads at the root request level.","type":"array","items":{"type":"integer","description":"The identifier of the file type.","minimum":0},"example":[18,20,22],"$$ref":"#/components/schemas/fileTypeBlockedForUpload"},"restrictionSettingId":{"description":"The identifier of the restriction setting associated with the profile.","type":"integer","example":1,"$$ref":"#/components/schemas/restrictionSettingId"},"swgDisplayBlockPage":{"description":"Option to control the display of the block page by the Secure Web Gateway (SWG).","type":"integer","example":0,"$$ref":"#/components/schemas/swgDisplayBlockPage"}},"$$ref":"#/components/schemas/securityProfileUpdateRequest"},"example":{"name":"Security Profile for Internet Access","aupSettingGroupId":9,"applicationAupSettingGroupId":1139310,"fileInspectionSettingGroupId":1139311,"landerSettingGroupId":1139312,"policySettingGroupId":1139313,"securitySettingGroupId":1139314,"settingGroupBypassInspectionGroupId":1139315,"priority":1,"reporting":"enabled","restrictionSettingId":1,"fileEngines":true,"tgSandbox":false,"fileTypeControlStatus":true,"saml":1,"safeSearch":true,"aiSupplyChainCategories":"C00000000000000000000000000000000000000000000000000000","fileTypeBlockedForDownload":[16,17,18],"fileTypeBlockedForUpload":[18,20,22],"swgDisplayBlockPage":0}}},"$$ref":"#/components/requestBodies/securityProfileUpdateRequestBody"},"security":[{"oauthFlow":["policies.securityProfiles:write"]}],"responses":{"200":{"description":"OK","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"The properties of the Security profile.","required":["id","organizationId","isDefault","name","isFwaasDefault","isSwgDefault","createdAt","modifiedAt","applicationAupSettingGroupId","aupSettingGroupId","bundleTypeId"],"properties":{"id":{"type":"integer","description":"The ID of the Security profile.","example":1234567,"$$ref":"#/components/schemas/id"},"organizationId":{"type":"integer","description":"The ID of the organization.","example":2345678,"$$ref":"#/components/schemas/organizationId"},"isDefault":{"type":"boolean","example":true,"description":"Specifies whether the setting is the default setting.","$$ref":"#/components/schemas/isDefault"},"name":{"type":"string","description":"The name of the Security profile.","example":"System Provided - Private Access","$$ref":"#/components/schemas/name"},"aupSettingGroupId":{"type":"integer","nullable":true,"example":9,"description":"The group ID of the Category setting.","$$ref":"#/components/schemas/aupSettingGroupId"},"applicationAupSettingGroupId":{"type":"integer","nullable":true,"example":1139310,"description":"The group ID of the Application setting.","$$ref":"#/components/schemas/applicationAupSettingGroupId"},"landerSettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Notification setting.","$$ref":"#/components/schemas/landerSettingGroupId"},"securitySettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Security setting.","$$ref":"#/components/schemas/securitySettingGroupId"},"policySettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the Policy setting.","$$ref":"#/components/schemas/policySettingGroupId"},"settingGroupBypassInspectionGroupId":{"type":"integer","nullable":true,"example":1139310,"description":"The group ID of the Bypass Inspection setting.","$$ref":"#/components/schemas/settingGroupBypassInspectionGroupId"},"fileInspectionSettingGroupId":{"type":"integer","example":1139310,"description":"The group ID of the File Inspection setting.","$$ref":"#/components/schemas/fileInspectionSettingGroupId"},"frontendModifiedAt":{"type":"integer","description":"The date and time (in seconds since the Unix Epoch) when the system modified the dashboard.","example":1139310,"$$ref":"#/components/schemas/frontendModifiedAt"},"createdAt":{"type":"integer","description":"The date and time (in seconds since the Unix Epoch) when the system created the Security profile setting.","example":1490206249,"$$ref":"#/components/schemas/securityProfileCreatedAt"},"modifiedAt":{"type":"integer","description":"The date and time (in seconds since the Unix Epoch) when the system created the Security profile setting.","example":1490206249,"$$ref":"#/components/schemas/securityProfileModifiedAt"},"priority":{"type":"integer","description":"The priority of the Security profile.","example":1139310,"$$ref":"#/components/schemas/priority"},"reporting":{"type":"string","description":"Specifies whether the system enables or disables the reporting of the Security profile setting.","enum":["enabled","disabled"],"example":"enabled","$$ref":"#/components/schemas/reporting"},"bundleTypeId":{"type":"integer","enum":[1,2,3,4],"example":2,"description":"The ID of the bundle type.","$$ref":"#/components/schemas/bundleTypeId"},"isSwgDefault":{"type":"boolean","nullable":true,"description":"Specifies whether the Security profile for the secure web gateway (SWG) is the default Security profile.","example":true,"$$ref":"#/components/schemas/isSwgDefault"},"isFwaasDefault":{"type":"boolean","nullable":true,"description":"Specifies whether the Security profile for the cloud-delivered firewall is the default Security profile.","example":true,"$$ref":"#/components/schemas/isFwaasDefault"},"categorySetting":{"type":"object","description":"The properties of the Content Category setting.","properties":{},"example":{"id":14758855,"organizationId":1,"isDefault":true,"name":"content category setting one","categoryBits":"fffffffffffff000fffffffff8800000000000090106049004c46","type":"mixed","createdAt":1520476127,"modifiedAt":1520476129,"markedForDeletion":false,"bundleTypeId":1,"isSwgDefault":false,"warnCategoryBits":"0"}},"fileInspectionSetting":{"type":"object","description":"The properties of the File Inspection setting.","properties":{},"example":{}},"policySetting":{"type":"object","description":"The properties of the Policy setting.","properties":{},"example":{"id":14657488,"organizationId":8287715,"isDefault":false,"name":"Security Profile for Internet Access 1","intelligentProxy":true,"intelligentProxyHttps":false,"ipFiltering":false,"fileInspectionId":0,"reporting":"enabled","safeSearch":false,"createdAt":"2024-10-30 22:54:28","modifiedAt":"2024-10-30 22:54:28","markedForDeletion":false,"decryptExceptionCategories":"0","exceptiondomainlistId":0,"saml":0,"swgDisplayBlockPage":0}},"securitySetting":{"type":"object","description":"The properties of the Security settings.","properties":{},"example":{"id":14946279,"organizationId":8287715,"isDefault":false,"name":"Default Web Settings","botnetProtection":true,"malwareProtection":true,"superBotnet":true,"superMalware":true,"phishingProtection":true,"suspiciousResponseFiltering":false,"malwareUrlProxy":false,"urlProxyHttps":false,"ipFiltering":false,"fileInspection":true,"ampScan":false,"createdAt":"2024-10-30 22:35:34","modifiedAt":"2024-10-30 22:35:34","categoryPrefs":"0000000000000000","categoryPrefsHigh":"0000000000000000","categoryBits":"0","markedForDeletion":false,"bundleTypeId":2,"isSwgDefault":true}},"identityCount":{"type":"integer","description":"The number of resources in the organization.","example":100,"$$ref":"#/components/schemas/identityCount"},"domainlists":{"type":"array","description":"The list of destination lists in the organization.","items":{},"example":[{"id":18120197,"organizationId":8287715,"access":"allow","isGlobal":true,"name":"Global Allow List","thirdpartyCategoryId":null,"createdAt":"2024-10-30 22:35:34","modifiedAt":"2024-10-30 22:35:34","isMspDefault":false,"markedForDeletion":false,"bundleTypeId":1}]},"restriction":{"type":"object","description":"The properties of the Tenant Control.","properties":{"id":{"type":"integer","description":"The ID of the Tenant Control setting.","example":17764},"name":{"type":"string","description":"The name of the Tenant Control setting.","example":"Global Tenant Controls"},"domains":{"type":"array","description":"The list of destinations.","items":{"type":"object","description":"The properties of the destination.","properties":{}}},"restrictions":{"type":"array","description":"The list of Tenant Control restrictions.","items":{"type":"object","description":"The properties of the Tenant Control restriction.","properties":{}}}},"$$ref":"#/components/schemas/tenantControlsRestriction"}},"example":{"id":13725886,"organizationId":8053787,"isDefault":false,"name":"System Provided - Internet Access","aupSettingGroupId":14758856,"applicationAupSettingGroupId":1139310,"landerSettingGroupId":6556912,"securitySettingGroupId":14168795,"policySettingGroupId":13704136,"settingGroupBypassInspectionGroupId":6497268,"fileInspectionSettingGroupId":13658923,"frontendModifiedAt":1668574861,"createdAt":1668574861,"modifiedAt":1748620055,"priority":10,"reporting":"enabled","bundleTypeId":2,"isSwgDefault":true,"isFwaasDefault":false,"restriction":{"id":17764,"name":"Global Tenant Controls","domains":[],"restrictions":[]}},"$$ref":"#/components/schemas/SecurityProfileResponse"},"example":{"id":13966021,"organizationId":8099167,"isDefault":false,"name":"security profile three","aupSettingGroupId":9,"applicationAupSettingGroupId":1139310,"landerSettingGroupId":4,"securitySettingGroupId":14310706,"policySettingGroupId":13971019,"settingGroupBypassInspectionGroupId":null,"fileInspectionSettingGroupId":13901616,"frontendModifiedAt":1603850002,"createdAt":1681167005,"modifiedAt":1776810230,"priority":70,"reporting":"enabled","bundleTypeId":2,"isSwgDefault":null,"isFwaasDefault":null,"disableReporting":0,"disableLogging":0}}}},"400":{"description":"Bad Request","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Bad Request","properties":{"statusCode":{"type":"integer","example":400,"description":"HTTP status code"},"error":{"type":"string","example":"Bad Request","description":"A brief description of the error"},"message":{"type":"string","example":"Validation Error"},"txId":{"type":"string","example":"d479k9i2b723"}},"$$ref":"#/components/schemas/BadRequestError"},"examples":{"example_bad_request":{"summary":"Bad Request Example Response","value":{"statusCode":400,"error":"Bad Request","message":"Validation Error","txId":"d479k9i2b723-abdj1-672635-45362"},"$$ref":"#/components/examples/400BadRequestExample"}}}},"$$ref":"#/components/responses/BadRequest"},"401":{"description":"Unauthorized","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Unauthorized","properties":{"statusCode":{"type":"integer","example":401,"description":"HTTP status code"},"error":{"type":"string","example":"Unauthorized","description":"The authorization header is missing or the token is unauthorized."},"message":{"type":"string","example":"Error"},"txId":{"type":"string","example":"a478k9i2b723"}},"$$ref":"#/components/schemas/UnauthorizedError"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"Forbidden","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Forbidden","properties":{"statusCode":{"type":"integer","example":403,"description":"HTTP status code"},"error":{"type":"string","example":"Forbidden","description":"The token is invalid."},"message":{"type":"string","example":"Error"},"txId":{"type":"string","example":"a478k9i2b723"}},"$$ref":"#/components/schemas/ForbiddenError"}}},"$$ref":"#/components/responses/Forbidden"},"404":{"description":"Not Found","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Not Found","properties":{"statusCode":{"type":"integer","example":404,"description":"HTTP status code"},"error":{"type":"string","example":"Not Found","description":"A resource specified in the URL was not found."},"message":{"type":"string","example":"Error"},"txId":{"type":"string","example":"a478k9i2b723"}},"$$ref":"#/components/schemas/NotFoundError"}}},"$$ref":"#/components/responses/NotFound"},"500":{"description":"Internal Server Error","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The timestamp of the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"Internal Server Error","properties":{"statusCode":{"type":"integer","example":500,"description":"HTTP status code"},"error":{"type":"string","example":"Internal Server Error","description":"The server can not process the request."},"message":{"type":"string","example":"An internal server error occurred"},"txId":{"type":"string","example":"l477k9i2b893"}},"$$ref":"#/components/schemas/ServerError"}}},"$$ref":"#/components/responses/ServerErr"}},"method":"put","path":"/securityProfiles/{profileId}"}}