AttackForge Enterprise

GetVulnerabilityLibraryIssues

This method can be used for the following functionality: Get details for all vulnerabilities in the library. This method can be used with optional filter.

Parameters

The following URL, Headers and Parameters are required for requests to this API endpoint. Where a parameter is optional, it will be indicated. Otherwise treat all parameters as mandatory.

Headers

GET /api/ss/library HTTP/1.1
Host: demo.attackforge.com
X-SSAPI-KEY: APIKey
Content-Type: application/json
Connection: close

Query

name (string) (optional)

Name of the vulnerability.

Example:

GET /api/ss/library?name=SQL%20Injection HTTP/1.1

reference_id (string) (optional)

Reference Id of the vulnerability in the library (15-digit number).

Example:

GET /api/ss/library?reference_id=754483619065784 HTTP/1.1

created_from (string) (optional)

Start date to query vulnerabilities from, based on creation date. String in YYYY-MM-DD format.

Example:

GET /api/ss/library?created_from=2020-01-01 HTTP/1.1

created_to (string) (optional)

End date to query vulnerabilities to, based on creation date. String in YYYY-MM-DD format.

Example:

GET /api/ss/library?created_to=2020-12-31 HTTP/1.1

Example

The following example is a cURL request to get all SQL Injection vulnerabilities in the library created between 1st January 2018 to 31st December 2020.

Request

Include API Token instead of stars in 'X-SSAPI-KEY: ***************************************' parameter.

curl -X GET 'https://demo.attackforge.com/api/ss/library?created_from=2018-01-01&created_to=2020-12-31&name=SQL%20Injection' -H 'Host: demo.attackforge.com' -H 'X-SSAPI-KEY: ***************************************' -H 'Content-Type: application/json' -H 'Connection: close'

Response

Response contains an array of vulnerability objects.

{
"count": 999,
"vulnerabilities":[
{
"created": "...",
"last_modified": "...",
"reference_id": "...",
"category": "...",
"title": "...",
"description": "...",
"severity": "10",
"likelihood_of_exploitation": "10",
"priority": "Critical",
"attack_scenario": "...",
"remediation_recommendation": "...",
"impact_on_confidentiality": "High",
"impact_on_integrity": "Medium",
"impact_on_availability": "Low",
"tags": ["...", "..."],
"id": "...",
"created_by": "..."
}
]
}