{"type":"api","title":"Get Application Risk","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/9d37d008417d562ab46d4b67547a68457ce288d2/5477656b-8124-3422-839e-4b90bc91faa4","info":{"title":"Cisco Secure Access App Discovery API","description":"The App Discovery API provides an overall view of application and protocol activity in your environment\nand the potential risk indicated by this network traffic.","version":"2.0.2","contact":{"name":"Cloud Security Developer Community"}},"tags":[{"name":"Applications"},{"name":"Application Categories"},{"name":"Protocols"},{"name":"Identities"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/reports/app-discovery-overview.md","uri":"secure-access-api-reference-app-discovery-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"reports/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"reports.appDiscovery:write":"Write reports app discovery","reports.appDiscovery:read":"Read reports app discovery"}}}}}},"spec":{"tags":["Applications","Secure Access"],"summary":"Get Application Risk","description":"Get the risk for the application.","operationId":"getApplicationRisk","parameters":[{"in":"path","name":"applicationId","description":"The ID of the application.","required":true,"schema":{"type":"string"},"$$ref":"#/components/parameters/applicationId"}],"security":[{"oauthFlow":["reports.appDiscovery:read"]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","description":"The information about the application risk.","properties":{"id":{"type":"string","description":"The ID of app.","example":"eaqYExba"},"name":{"type":"string","description":"The name of the app.","example":"Secure Access"},"weightedRisk":{"type":"string","description":"The risk the app poses to the environment.","enum":["veryLow","low","medium","high","veryHigh"],"example":"low","$$ref":"#/components/schemas/WeightedRisk"},"businessRisk":{"type":"string","description":"The business risk of the app.","enum":["veryLow","low","medium","high","veryHigh","na"],"example":"na","$$ref":"#/components/schemas/BusinessRisk"},"usageType":{"type":"string","description":"The type of usage. Valid values are: `personal`, `corporate` (higher risk), or\n`indirect` (lower risk, e.g. content delivery network).","enum":["indirect","personal","corporate","na"],"example":"na","$$ref":"#/components/schemas/UsageType"},"webReputation":{"type":"integer","description":"Provides accurate conclusions about a given host by tracking a broad set\nof attributes and using sophisticated security modeling.\nPowered by Talos Security Intelligence.","example":50},"financialViability":{"type":"string","description":"Financial risk to the service provider, based on Dun & Bradstreet's Dynamic Risk Score.","enum":["low","medium","high","veryHigh","na"],"example":"high","$$ref":"#/components/schemas/FinancialViability"},"dataStorage":{"type":"string","description":"The form of the stored data.\nValid values are: `noStorage`, `structured`, `unstructured`, or `na`.","enum":["noStorage","structured","unstructured","na"],"example":"noStorage","$$ref":"#/components/schemas/DataStorage"},"vendorCompliance":{"type":"array","description":"The list of compliance information for the vendor.","items":{"type":"object","properties":{"name":{"type":"string","description":"The name of the certificate.","enum":["PCI_DSS","HIPAA","FEDRAMP","ISO 27001 / 27002","COBIT","SP800_53","BITS","GAPP"]},"description":{"type":"string","description":"The description of the certificate.","example":"The Payment Card Industry Data Security Standard (PCI DSS)\nis a widely accepted set of policies and procedures intended to optimize\nthe security of credit, debit and cash card transactions and protect\ncardholders against misuse of their personal information."},"status":{"type":"boolean","description":"Specifies whether the certificate is verified.","example":true}}}}},"$$ref":"#/components/schemas/ApplicationRisk"},"example":{"id":"eaqYExba","name":"Secure Access","weightedRisk":"veryLow","businessRisk":"low","usageType":"indirect","webReputation":50,"financialViability":"medium","dataStorage":"structured","vendorCompliance":[{"name":"PCI_DSS","description":"The Payment Card Industry Data Security Standard (PCI DSS)\nis a widely accepted set of policies and procedures intended\nto optimize the security of credit, debit, and cash card transactions\nand protect cardholders against misuse of their personal information.","status":true}]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/InvalidRequest"},"401":{"description":"Unauthorized request","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Unauthorized"},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/NotFound"},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","description":"The error message returned in the response.","properties":{"message":{"type":"string"}},"$$ref":"#/components/schemas/Error"}}},"$$ref":"#/components/responses/ServerError"}},"__originalOperationId":"getApplicationRisk","method":"get","path":"/appDiscovery/applications/{applicationId}/risk"}}