KEVinGPT

KEVinGPT · GPT-Aktionen

KEV API

API for accessing Known Exploited Vulnerabilities (KEV) Database

  • GET /openai/kevGet a specific vulnerability by CVE ID using a query parameter
  • GET /kev/recentGet recent vulnerabilities by the number of days
  • GET /openai/vulnGet a specific vulnerability by CVE ID using a query parameter
  • GET /kev/existsCheck if a CVE exists in KEV

    Returns a JSON object indicating if the specified CVE exists in KEV.

Ursprüngliches API-Schema
{
  "openapi": "3.0.0",
  "info": {
    "title": "KEV API",
    "version": "1.0.0",
    "description": "API for accessing Known Exploited Vulnerabilities (KEV) Database"
  },
  "servers": [
    {
      "url": "https://kevin.gtfkd.com/",
      "description": "Local server"
    }
  ],
  "paths": {
    "/openai/kev": {
      "get": {
        "summary": "Get a specific vulnerability by CVE ID using a query parameter",
        "operationId": "getKevByCve",
        "tags": [
          "Vulnerability"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "cve",
            "required": true,
            "description": "CVE ID of the vulnerability to fetch",
            "schema": {
              "type": "string",
              "pattern": "^CVE-\\d{4}-\\d{4,7}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A JSON object representing the vulnerability",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vulnerability"
                }
              }
            }
          },
          "400": {
            "description": "Bad request when CVE ID is not provided"
          },
          "404": {
            "description": "Not found when the vulnerability does not exist in the database"
          }
        }
      }
    },
    "/kev/recent": {
      "get": {
        "summary": "Get recent vulnerabilities by the number of days",
        "operationId": "getRecentKevByDays",
        "tags": [
          "Vulnerability"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "days",
            "required": true,
            "description": "The number of days to look back for recent vulnerabilities",
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A JSON array of recent vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RecentVulnerability"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request when the days parameter is not provided or invalid"
          },
          "404": {
            "description": "Not found when no vulnerabilities are recent within the specified number of days"
          }
        }
      }
    },
    "/openai/vuln": {
      "get": {
        "summary": "Get a specific vulnerability by CVE ID using a query parameter",
        "operationId": "getAllVulnInfoByCve",
        "tags": [
          "Vulnerability"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "cve",
            "required": true,
            "description": "CVE ID of the vulnerability to fetch",
            "schema": {
              "type": "string",
              "pattern": "^CVE-\\d{4}-\\d{4,7}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A JSON object representing the vulnerability with extended details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExtendedVulnerability"
                }
              }
            }
          },
          "400": {
            "description": "Bad request when CVE ID is not provided"
          },
          "404": {
            "description": "Not found when the vulnerability does not exist in the database"
          }
        }
      }
    },
    "/kev/exists": {
      "get": {
        "summary": "Check if a CVE exists in KEV",
        "description": "Returns a JSON object indicating if the specified CVE exists in KEV.",
        "operationId": "checkCveExists",
        "parameters": [
          {
            "in": "query",
            "name": "cve",
            "required": true,
            "description": "The CVE identifier to check.",
            "schema": {
              "type": "string",
              "pattern": "^CVE-\\d{4}-\\d{4,7}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A JSON object indicating if the CVE exists in KEV",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InKEVResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request (e.g., missing or invalid CVE identifier)"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "InKEVResponse": {
        "type": "object",
        "properties": {
          "cve": {
            "type": "string"
          },
          "exists": {
            "type": "boolean"
          }
        }
      },
      "Vulnerability": {
        "type": "object",
        "properties": {
          "cveID": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "references": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "knownRansomwareCampaignUse": {
            "type": "string"
          }
        },
        "required": [
          "cveID",
          "description"
        ]
      },
      "ExtendedVulnerability": {
        "type": "object",
        "properties": {
          "cveID": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "references": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cisaData": {
            "type": "object",
            "additionalProperties": true
          },
          "cveOrg": {
            "type": "object",
            "additionalProperties": true
          },
          "nvdData": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "cveID",
          "description"
        ]
      },
      "RecentVulnerability": {
        "type": "object",
        "properties": {
          "_id": {
            "type": "string"
          },
          "cveID": {
            "type": "string"
          },
          "dateAdded": {
            "type": "string",
            "format": "date"
          },
          "dueDate": {
            "type": "string",
            "format": "date"
          },
          "githubPocs": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "type": "string"
          },
          "nvdData": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NVDData"
            }
          },
          "openThreatData": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OpenThreatData"
            }
          },
          "product": {
            "type": "string"
          },
          "requiredAction": {
            "type": "string"
          },
          "shortDescription": {
            "type": "string"
          },
          "vendorProject": {
            "type": "string"
          },
          "vulnerabilityName": {
            "type": "string"
          }
        },
        "required": [
          "cveID",
          "dateAdded",
          "dueDate",
          "product",
          "requiredAction",
          "shortDescription",
          "vendorProject",
          "vulnerabilityName"
        ]
      },
      "NVDData": {
        "type": "object",
        "properties": {
          "nvdReferences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NVDReference"
            }
          },
          "vulnStatus": {
            "type": "string"
          }
        }
      },
      "NVDReference": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      },
      "OpenThreatData": {
        "type": "object",
        "properties": {
          "adversaries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "affectedIndustries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "malwareFamiles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}