{"type":"model","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/d2a1854d5c0ed9069a7f0bc54a9b813f3075ddc9/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":{"type":"object","required":["id","name","sources","firstDetected","lastDetected"],"description":"The application identity information.","properties":{"id":{"type":"integer","description":"The ID of the identity.","example":10000},"name":{"type":"string","description":"The name of the identity.","example":"My Identity"},"sources":{"type":"array","description":"The list of app sources where the sources are DNS, Web (Secure Web Gateway), and cloud-delivered firewall (CDFW) traffic events.\nThe list can contain one or more of the source types.","items":{"anyOf":[{"type":"object","description":"The properties of the app's DNS requests.","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["dns"],"example":"dns"},"requests":{"type":"integer","description":"The number of DNS requests for this app.","example":100},"blockedRequests":{"type":"integer","description":"The number of DNS requests blocked, which is based on the policy configurations.","example":50}},"example":{"name":"dns","requests":100,"blockedRequests":35},"$$ref":"#/components/schemas/DnsSource"},{"type":"object","description":"The properties of the app's web requests.","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["swg"],"example":"swg"},"totalTraffic":{"type":"integer","description":"The total number of bytes inbound and outbound for this app in your environment.","example":150},"bytesIn":{"type":"integer","description":"The number of bytes received (inbound).","example":50},"bytesOut":{"type":"integer","description":"The number of bytes sent (outbound).","example":100},"blockedBytesOut":{"type":"integer","description":"The number of bytes of outbound traffic that are blocked.","example":90}},"example":{"name":"swg","totalTraffic":200,"bytesIn":100,"bytesOut":100,"blockedBytesOut":49},"$$ref":"#/components/schemas/SwgSource"},{"type":"object","description":"The properties of the app's requests that are managed by the cloud-delivered firewall (CDFW).","properties":{"name":{"type":"string","description":"The type of traffic associated with the source.","enum":["cdfw"],"example":"cdfw"},"events":{"type":"integer","description":"The number of CDFW L7 events for this app.","example":100},"blockedEvents":{"type":"integer","description":"The number of CDFW L7 events that are blocked.","example":50}},"example":{"name":"cdfw","events":50,"blockedEvents":25},"$$ref":"#/components/schemas/CdfwSource"}]},"example":[{"name":"cdfw","events":50,"blockedEvents":25}],"$$ref":"#/components/schemas/Sources"},"firstDetected":{"type":"string","format":"date-time","description":"The date and time (ISO 8601 timestamp) when the identity was first detected for the application.","example":"2022-01-01T00:00:00.000Z"},"lastDetected":{"type":"string","format":"date-time","description":"The date and time (ISO 8601 timestamp) when the identity was last detected for the application.","example":"2022-01-01T00:00:00.000Z"}},"example":{"id":10000,"name":"My identity","sources":[{"name":"dns","requests":100,"blockedRequests":100}],"firstDetected":"2022-01-01T00:00:00.000Z","lastDetected":"2022-01-01T00:00:00.000Z"},"$$ref":"#/components/schemas/ApplicationIdentity","title":"ApplicationIdentity"}}