Cisco PSIRT openVuln API
The Cisco Product Security Incident Response Team (PSIRT) openVuln API is a RESTful API that allows customers to obtain Cisco Security Vulnerability…
Identity & security#openapi#security
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Cisco Product Security Incident Response Team (PSIRT) openVuln API is a RESTful API that allows customers to obtain Cisco Security Vulnerability information in different machine-consumable formats. APIs are important for customers because they allow their technical staff and programmers to build tools that help them do their job more effectively (in this case, to keep up with security vulnerability information).
For more information about the Cisco PSIRT openVuln API visit https://developer.cisco.com/site/PSIRT/discover/overview
For detail steps on how to use the API go to:https://developer.cisco.com/site/PSIRT/get-started/getting-started.gsp
This is a beta release of a swagger YAML for the Cisco PSIRT openVuln API
To access the API sign in with your Cisco CCO account at http://apiconsole.cisco.com and register an application
to recieve a client_id and a client_secret
You can then get your token using curl or any other method you prefer.
'curl -s -k -H "Content-Type: application/x-www-form-urlencoded" -X POST -d "client_id= " -d "client_secret= " -d "grant_type=client_credentials" https://cloudsso.cisco.com/as/token.oauth2'
You will receive an access token as demonstrated in the following example:
'{"access_token":"I7omWtBDAieSiUX3shOxNJfuy4J6","token_type":"Bearer","expires_in":3599}'
In Swagger, click on Change Authentication
enter the text "I7omWtBDAieSiUX3shOxNJfuy4J6" (which is the token you received)
then click on "Try this operation"
Endpoints 19
- GETGET /security/advisories/cvrf/advisory/{advisory_id}
/security/advisories/cvrf/advisory/:advisory_idUsed to obtain an advisory in CVRF format for a given advisory ID advisory_id (i.e., cisco-sa-20150819-pcp) - GETGET /security/advisories/cvrf/all
/security/advisories/cvrf/allUsed to obtain all advisories in Common Vulnerability Reporting Format (CVRF). For more information about CVRF go to… - GETGET /security/advisories/cvrf/cve/{cve_id}
/security/advisories/cvrf/cve/:cve_idUsed to obtain an advisory in CVRF format for a given Common Vulnerability Enumerator (CVE). The cve_id format is CVE-YYYY-NNNN. For more information about… - GETGET /security/advisories/cvrf/latest/{number}
/security/advisories/cvrf/latest/:numberUsed to obtain all the latest security advisories in CVRF format given an absolute number. For instance, the latest 10 or latest 5. - GETGET /security/advisories/cvrf/product
/security/advisories/cvrf/product?product=stringUsed to obtain all the advisories that affects the given product name. - GETGET /security/advisories/cvrf/severity/{severity}
/security/advisories/cvrf/severity/:severityUsed to obtain all security advisories for a given security impact rating (critical, high, medium, or low) in CVRF format. - GETGET /security/advisories/cvrf/severity/{severity}/firstpublished
/security/advisories/cvrf/severity/:severity/firstpublished?startDate=2024-01-01&endDate=2024-01-01Used to obtain all security advisories for a given security impact rating (critical, high, medium, or low) in CVRF format and additionally filter based of… - GETGET /security/advisories/cvrf/severity/{severity}/lastpublished
/security/advisories/cvrf/severity/:severity/lastpublished?startDate=2024-01-01&endDate=2024-01-01Used to obtain all security advisories for a given security impact rating (critical, high, medium, or low) in CVRF format. - GETGET /security/advisories/cvrf/year/{year}
/security/advisories/cvrf/year/:yearUsed to obtain all security advisories that have were orginally published in a specific year YYYY. - GETGET /security/advisories/ios
/security/advisories/ios?version=stringUsed to obtain all advisories that affects the given ios version - GETGET /security/advisories/iosxe
/security/advisories/iosxe?version=stringUsed to obtain all advisories that affects the given ios version - GETGET /security/advisories/oval/advisory/{advisory_id}
/security/advisories/oval/advisory/:advisory_idUsed to obtain OVAL definitions for a given advisory ID advisory_id (i.e., cisco-sa-20150819-pcp) - GETGET /security/advisories/oval/all
/security/advisories/oval/allUsed to obtain all Open Vulnerability and Assessment Language (OVAL) definitions available for Cisco security vulnerabilities. For more information about OVAL… - GETGET /security/advisories/oval/cve/{cve_id}
/security/advisories/oval/cve/:cve_idUsed to obtain OVAL definitions for a given CVE Identifier. The cve_id format is CVE-YYYY-NNNN. - GETGET /security/advisories/oval/latest/{number}
/security/advisories/oval/latest/:numberUsed to obtain all the latest OVAL definitions given an absolute number. For instance, the latest 10 or latest 5. - GETGET /security/advisories/oval/product
/security/advisories/oval/product?product=stringUsed to obtain all the oval advisories that affects the given product name. - GETGET /security/advisories/oval/severity/{severity}
/security/advisories/oval/severity/:severityUsed to obtain all OVAL definitions for a given security impact rating (critical, high, medium, or low). - GETGET /security/advisories/oval/severity/{severity}/firstpublished
/security/advisories/oval/severity/:severity/firstpublished?startDate=2024-01-01&endDate=2024-01-01Used to obtain all security advisories for a given security impact rating (critical, high, medium, or low) in OVAL format. - GETGET /security/advisories/oval/severity/{severity}/lastpublished
/security/advisories/oval/severity/:severity/lastpublished?startDate=2024-01-01&endDate=2024-01-01Used to obtain all security advisories for a given security impact rating (critical, high, medium, or low) in OVAL format.
API details
- Base URL
https://api.cisco.com- Authentication
- OAuth 2.0 (implicit flow) with 2 scopes
- Operations
- 19 operations on 19 pathsGET 19
- Response formats
application/json- Description format
- Swagger 2.0, API version
0.0.3 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Cisco PSIRT openVuln API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Cisco PSIRT openVuln API collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (implicit flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /security/advisories/cvrf/advisory/{advisory_id}” (GET /security/advisories/cvrf/advisory/:advisory_id), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Cisco PSIRT openVuln API?
The Cisco Product Security Incident Response Team (PSIRT) openVuln API is a RESTful API that allows customers to obtain Cisco Security Vulnerability… It is listed under Identity & security and has 19 endpoints.
Who publishes the Cisco PSIRT openVuln API?
It is listed from Cisco's public API description (an OpenAPI document), not published by Cisco on Swastik Codes. Anyone who controls cisco.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Cisco PSIRT openVuln API?
Requests go to https://api.cisco.com. Endpoint paths are added to this base URL.
How do I authenticate with the Cisco PSIRT openVuln API?
With OAuth 2.0 (implicit flow) with 2 scopes.
How many endpoints does the Cisco PSIRT openVuln API have?
19 operations on 19 paths (19 GET).
Is forking the Cisco PSIRT openVuln API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.