{"type":"model","meta":{"id":"/apps/pubhub/media/cloud-security-gov/9ead083ce611c254ac9201d1e76003bd3d4b4b6b/d1093732-2fd9-3760-ac85-83910c4b7111","info":{"title":"Cisco Secure Access for Government Reporting API","description":"The Reporting API provides the data to generate the Secure Access reports.","version":"2.0.1","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Activity"},{"name":"Top Identities"},{"name":"Identity Distribution"},{"name":"Top Resources"},{"name":"Top Destinations"},{"name":"Top Categories"},{"name":"Top Event Types"},{"name":"Top DNS Query Types"},{"name":"Organization Requests by Hour"},{"name":"Organization Requests by Timerange"},{"name":"Organization Requests by Hour and Category"},{"name":"Organization Requests by Timerange and Category"},{"name":"Deployment Status"},{"name":"Bandwidth by Hour"},{"name":"Bandwidth by Timerange"},{"name":"Top Files"},{"name":"Total Requests"},{"name":"Top Threats"},{"name":"Top Threat Types"},{"name":"Utility"},{"name":"Top IPs"},{"name":"Summary"},{"name":"Summaries by Category"},{"name":"Summaries by Destination"},{"name":"Summaries by Rule"},{"name":"Remote Access"},{"name":"Private Resource"},{"name":"Requests Resource Connector"},{"name":"Requests Summary Resource Connector Groups"},{"name":"Resource Connectors"},{"name":"Rules Activity"},{"name":"Unique Resources"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/reports/reporting-overview.md","uri":"secure-access-api-reference-reporting-overview"}},"openapi":"3.0.1","servers":[{"url":"https://api.secureaccessfed.cisco.com/{basePath}","variables":{"basePath":{"default":"reports/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"client credential flow","flows":{"clientCredentials":{"tokenUrl":"https://api.secureaccessfed.cisco.com/auth/v2/token","scopes":{"reports.granularEvents:read":"Read reports granular events","reports.utilities:read":"Read reports utilities","reports.aggregations:read":"Read reports aggregations","reports.summariesByRule:read":"Read reports for the summaries of the rule","reports.privateResources:read":"Read reports for the private resources"}}}}}},"spec":{"type":"object","description":"The information about the Zero Trust Network Access (ZTNA) traffic in the Activity report.","properties":{"allapplications":{"type":"array","description":"The list of private applications that are connected through Zero Trust Access.","items":{"type":"object","description":"The properties of the private application.","properties":{"id":{"type":"integer","description":"The ID of the private application."},"label":{"type":"string","description":"The descriptive label for the application."},"type":{"type":"string","description":"The type of the application."},"category":{"type":"object","description":"The properties of the category for the application.","properties":{"id":{"type":"integer","description":"The ID of the category."},"label":{"type":"string","description":"The descriptive lable for the application category."}}}},"example":{"id":1,"label":"label","type":"NBAR","category":{"id":1,"label":"category"}}}},"date":{"type":"string","description":"The date from the timestamp based on the timezone parameter.","example":"2020-07-12","$$ref":"#/components/schemas/Date"},"destinationip":{"type":"string","description":"The resolved IP for Zero Trust Network Access (ZTNA) client-based events."},"clientfirewall":{"type":"string","description":"The type of the firewall that is used, either `SYS` or `NONE`.","enum":["SYS","NONE"]},"time":{"type":"string","description":"The time in 24-hour format based on the timezone parameter.","example":"12:34","$$ref":"#/components/schemas/Time"},"type":{"type":"string","description":"The type of the request.","enum":["ztna","ztna-clientbased"],"example":"ztna"},"diskencryption":{"type":"string","description":"Type of the disk encryption, either `SYS`, `THIRDPARTY`, `NONE`.","enum":["SYS","THIRDPARTY","NONE"],"example":"NONE"},"antimalwareagents":{"type":"array","description":"The list of anti-malware agents.","items":{"type":"string","description":"A label for an anti-malware agent."}},"policy":{"type":"object","description":"The properties of the Zero Trust Network Access (ZTNA) access rule in the Access policy.","required":["ruleset","privateapplicationgroup"],"properties":{"ruleset":{"type":"object","description":"The set of rules on the policy.","properties":{"id":{"type":"number","description":"The ID of the ruleset."},"label":{"type":"string","description":"The descriptive label for the ruleset."},"rule":{"type":"object","description":"The properties of the firewall rule.","properties":{"id":{"type":"number","description":"The ID of the rule."},"label":{"type":"string","description":"The name of the rule."},"privateapplicationgroup":{"type":"object","description":"The private application group.","properties":{"id":{"nullable":true,"type":"number","description":"The ID of application group."},"label":{"nullable":true,"type":"string","description":"The name of the application group."}},"$$ref":"#/components/schemas/PrivateApplicationGroup"}},"required":["id","label"],"$$ref":"#/components/schemas/Rule"}},"$$ref":"#/components/schemas/Ruleset"},"privateapplicationgroup":{"type":"object","description":"The private application group.","properties":{"id":{"nullable":true,"type":"number","description":"The ID of application group."},"label":{"nullable":true,"type":"string","description":"The name of the application group."}},"$$ref":"#/components/schemas/PrivateApplicationGroup"}},"$$ref":"#/components/schemas/PolicyZTNA"},"systempassword":{"type":"string","description":"The system password.","example":"xxxxxxxxx"},"verdict":{"type":"string","description":"The verdict for entry.","enum":["allowed","blocked","warn"],"example":"warn"},"device":{"type":"object","description":"The properties of the device.","properties":{"ip":{"type":"string","description":"The client's IP address."},"os":{"type":"string","description":"The operating system for the device."},"browser":{"type":"string","description":"The type of the web browser."},"location":{"type":"string","description":"The geolocation of the device."}},"$$ref":"#/components/schemas/Device"},"timestamp":{"type":"number","description":"The timestamp represented in milliseconds.","example":1594557263000,"$$ref":"#/components/schemas/Timestamp"},"identities":{"type":"array","description":"The list of identities for the entry.","items":{"type":"object","description":"The information about the identity.","properties":{"id":{"type":"number","description":"The ID of the identity."},"label":{"type":"string","description":"The descriptive label for the identity."},"type":{"type":"object","description":"The information about the identity including the type.","properties":{"id":{"type":"number","description":"The ID of the origin type for the identity."},"label":{"type":"string","description":"The label of the origin type for the identity."},"type":{"type":"string","description":"The name of the origin type for the identity."}},"$$ref":"#/components/schemas/IdentityType"},"deleted":{"type":"boolean","description":"Indicates whether the identity was deleted.","example":true}},"required":["id","label","type","deleted"],"example":{"id":1,"label":"Catch Rate Testing System","type":{"id":21,"label":"Sites","type":"site"},"deleted":false},"$$ref":"#/components/schemas/Identity"},"$$ref":"#/components/schemas/identities"}},"required":["date","identities","time","timestamp","type","verdict","policy"],"example":{"allapplications":[],"date":"2020-07-12","clientfirewall":"NONE","time":"12:34:25","type":"ztna","diskencryption":"THIRDPARTY","antimalwareagents":["Malware Agent 1","Malware Agent 2"],"policy":{"ruleset":{"id":4567,"label":"DEFAULT","rule":{"id":431556,"label":"UNKNOWN"}},"privateapplicationgroup":{"id":7,"label":"DEFAULT"}},"systempassword":"7994471ABB01112AFCP","verdict":"blocked","device":{"ip":"1.1.1.1","os":"MACOS","browser":"Firefox","location":"Vancouver"},"timestamp":1594557265000,"identities":[{"id":36661999,"type":{"id":48,"type":"saml_user","label":"Users"},"label":"BAP user","deleted":false}]},"$$ref":"#/components/schemas/ActivityZTNA","title":"ActivityZTNA"}}