{"uuid": "4b3fbc21-b18e-4a3a-9871-38c0a890412b", "vulnerability_lookup_origin": "1a89b78e-f703-45f3-bb86-59eb712668bd", "author": "9f56dd64-161d-43a6-b9c3-555944290a09", "vulnerability": "CVE-2024-0001", "type": "seen", "source": "https://gist.github.com/tu-trinh-scale/407158a8a009c0a59910fe93d5a691af", "content": "diff --git a/README.md b/README.md\nindex 57102d1..6350f4b 100644\n--- a/README.md\n+++ b/README.md\n@@ -93,6 +93,9 @@ Vuls is a tool created to solve the problems listed above. It has the following\n - CISA(Cybersecurity & Infrastructure Security Agency)\n   - [Known Exploited Vulnerabilities Catalog](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)\n \n+- KEV (Known Exploited Vulnerabilities)\n+  - CISA and VulnCheck KEV sources as first-class `kevs` field\n+\n - Cyber Threat Intelligence(MITRE ATT&CK and CAPEC)\n   - [mitre/cti](https://github.com/mitre/cti)\n \n@@ -166,6 +169,24 @@ Vuls has some options to detect the vulnerabilities\n - Email and Slack notification is possible (supports Japanese language)\n - Scan result is viewable on accessory software, TUI Viewer in a terminal or Web UI ([VulsRepo](https://github.com/ishiDACo/vulsrepo)).\n \n+### KEV (Known Exploited Vulnerabilities)\n+\n+- Supports CISA and VulnCheck KEV sources as first-class fields (`kevs`) on the vulnerability model\n+- Example scan result with KEV: [`example_kev_result.json`](example_kev_result.json)\n+\n+### Example Configuration\n+\n+A synthetic, redacted example is provided at [`config.toml.example`](config.toml.example) with placeholder values only (no secrets).\n+It includes the `[kevuln]` section to enable KEV reporting:\n+\n+```toml\n+[kevuln]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-kev.sqlite3\"\n+```\n+\n+See the example file for a full working setup.\n+\n ----\n \n ## What Vuls Doesn't Do\ndiff --git a/config.toml.example b/config.toml.example\nnew file mode 100644\nindex 0000000..906a8e0\n--- /dev/null\n+++ b/config.toml.example\n@@ -0,0 +1,60 @@\n+# Example Vuls configuration (synthetic/redacted)\n+# This is a placeholder example based on the structure of config.toml.\n+# All values are dummy and safe to publish. Replace with your own settings.\n+# See https://vuls.io/docs/en/config.html for details.\n+\n+[default]\n+port = \"22\"\n+\n+[cveDict]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/cve.sqlite3\"\n+\n+[ovalDict]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/oval.sqlite3\"\n+\n+[gost]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/gost.sqlite3\"\n+\n+[exploit]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-exploitdb.sqlite3\"\n+\n+[metasploit]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-msfdb.sqlite3\"\n+\n+# Enable KEV (Known Exploited Vulnerabilities) reporting\n+[kevuln]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-kev.sqlite3\"\n+\n+[cti]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-cti.sqlite3\"\n+\n+[servers.example-host]\n+host = \"192.0.2.10\"\n+port = \"22\"\n+user = \"vuls-user\"\n+keyPath = \"/home/vuls-user/.ssh/id_rsa\"\n+# keyPassword = \"key_password_placeholder\"\n+\n+[email]\n+smtpAddr = \"smtp.example.com\"\n+smtpPort = \"587\"\n+user = \"vuls@example.com\"\n+password = \"email_password_placeholder\"\n+from = \"vuls@example.com\"\n+to = [\"security@example.com\"]\n+\n+[slack]\n+hookURL = \"https://hooks.slack.com/services/EXAMPLE/WEBHOOK/PLACEHOLDER\"\n+authUser = \"vuls\"\n+channel = \"#vuls-alerts\"\n+\n+[chatWork]\n+apiToken = \"chatwork_api_token_placeholder\"\n+room = \"000000000\"\ndiff --git a/detector/kevuln.go b/detector/kevuln.go\nindex 41afdfe..9d53be6 100644\n--- a/detector/kevuln.go\n+++ b/detector/kevuln.go\n@@ -47,6 +47,28 @@ func newGoKEVulnDBClient(cnf config.VulnDictInterface, o logging.LogOpts) (*goKE\n \treturn &goKEVulnDBClient{driver: db, baseURL: cnf.GetURL()}, nil\n }\n \n+func toModelsKEV(k kevulnmodels.KEVuln) models.KEV {\n+\tvar due *time.Time\n+\tif !k.DueDate.IsZero() {\n+\t\tt := k.DueDate\n+\t\tdue = &t\n+\t}\n+\treturn models.KEV{\n+\t\tType:                       models.CISAKEVType,\n+\t\tVendorProject:              k.VendorProject,\n+\t\tProduct:                    k.Product,\n+\t\tVulnerabilityName:          k.VulnerabilityName,\n+\t\tShortDescription:           k.ShortDescription,\n+\t\tRequiredAction:             k.RequiredAction,\n+\t\tKnownRansomwareCampaignUse: k.KnownRansomwareCampaignUse,\n+\t\tDateAdded:                  k.DateAdded,\n+\t\tDueDate:                    due,\n+\t\tCISA: &models.CISAKEV{\n+\t\t\tNote: k.Notes,\n+\t\t},\n+\t}\n+}\n+\n // FillWithKEVuln :\n func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging.LogOpts) error {\n \tclient, err := newGoKEVulnDBClient(&cnf, logOpts)\n@@ -79,18 +101,17 @@ func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging\n \t\t\t\treturn err\n \t\t\t}\n \n-\t\t\talerts := []models.Alert{}\n-\t\t\tif len(kevulns) > 0 {\n-\t\t\t\talerts = append(alerts, models.Alert{\n-\t\t\t\t\tTitle: \"Known Exploited Vulnerabilities Catalog\",\n-\t\t\t\t\tURL:   \"https://www.cisa.gov/known-exploited-vulnerabilities-catalog\",\n-\t\t\t\t\tTeam:  \"cisa\",\n-\t\t\t\t})\n+\t\t\tif len(kevulns) == 0 {\n+\t\t\t\tcontinue\n+\t\t\t}\n+\t\t\tkevs := []models.KEV{}\n+\t\t\tfor _, k := range kevulns {\n+\t\t\t\tkevs = append(kevs, toModelsKEV(k))\n \t\t\t}\n \n \t\t\tv, ok := r.ScannedCves[res.request.cveID]\n \t\t\tif ok {\n-\t\t\t\tv.AlertDict.CISA = alerts\n+\t\t\t\tv.KEVs = kevs\n \t\t\t\tnKEV++\n \t\t\t}\n \t\t\tr.ScannedCves[res.request.cveID] = v\n@@ -108,16 +129,12 @@ func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging\n \t\t\t\tcontinue\n \t\t\t}\n \n-\t\t\talerts := []models.Alert{}\n-\t\t\tif len(kevulns) > 0 {\n-\t\t\t\talerts = append(alerts, models.Alert{\n-\t\t\t\t\tTitle: \"Known Exploited Vulnerabilities Catalog\",\n-\t\t\t\t\tURL:   \"https://www.cisa.gov/known-exploited-vulnerabilities-catalog\",\n-\t\t\t\t\tTeam:  \"cisa\",\n-\t\t\t\t})\n+\t\t\tkevs := []models.KEV{}\n+\t\t\tfor _, k := range kevulns {\n+\t\t\t\tkevs = append(kevs, toModelsKEV(k))\n \t\t\t}\n \n-\t\t\tvuln.AlertDict.CISA = alerts\n+\t\t\tvuln.KEVs = kevs\n \t\t\tnKEV++\n \t\t\tr.ScannedCves[cveID] = vuln\n \t\t}\ndiff --git a/example_kev_result.json b/example_kev_result.json\nnew file mode 100644\nindex 0000000..b7e31af\n--- /dev/null\n+++ b/example_kev_result.json\n@@ -0,0 +1,95 @@\n+{\n+  \"jsonVersion\": 4,\n+  \"serverName\": \"example-host\",\n+  \"family\": \"ubuntu\",\n+  \"release\": \"22.04\",\n+  \"scannedAt\": \"2024-06-03T02:00:00Z\",\n+  \"scannedCves\": {\n+    \"CVE-2024-0001\": {\n+      \"cveID\": \"CVE-2024-0001\",\n+      \"affectedPackages\": [\n+        {\n+          \"name\": \"example-pkg\",\n+          \"notFixedYet\": false,\n+          \"fixedIn\": \"1.2.3\"\n+        }\n+      ],\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"ExampleVendor\",\n+          \"product\": \"ExampleProduct\",\n+          \"vulnerabilityName\": \"Example Vulnerability 1\",\n+          \"shortDescription\": \"Example short description for CVE-2024-0001\",\n+          \"requiredAction\": \"Apply updates per vendor instructions\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2024-01-15T00:00:00Z\",\n+          \"dueDate\": \"2024-02-05T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"Example CISA note\"\n+          }\n+        }\n+      ]\n+    },\n+    \"CVE-2024-0002\": {\n+      \"cveID\": \"CVE-2024-0002\",\n+      \"affectedPackages\": [\n+        {\n+          \"name\": \"example-lib\",\n+          \"notFixedYet\": true\n+        }\n+      ],\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"AnotherVendor\",\n+          \"product\": \"AnotherProduct\",\n+          \"vulnerabilityName\": \"Another Vuln\",\n+          \"shortDescription\": \"Another example description\",\n+          \"requiredAction\": \"Apply mitigations\",\n+          \"knownRansomwareCampaignUse\": \"Known\",\n+          \"dateAdded\": \"2024-02-01T00:00:00Z\",\n+          \"dueDate\": \"2024-02-22T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"Another CISA note\"\n+          }\n+        },\n+        {\n+          \"type\": \"vulncheck\",\n+          \"vendorProject\": \"VulnCheckVendor\",\n+          \"product\": \"VulnCheckProduct\",\n+          \"vulnerabilityName\": \"VulnCheck Vuln\",\n+          \"shortDescription\": \"VulnCheck short description\",\n+          \"requiredAction\": \"Apply patch\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2024-03-10T00:00:00Z\",\n+          \"dueDate\": \"2024-03-31T00:00:00Z\",\n+          \"vulnCheck\": {\n+            \"xdb\": [\n+              {\n+                \"xdbId\": \"XDB-12345\",\n+                \"xdbUrl\": \"https://example.com/xdb/12345\",\n+                \"dateAdded\": \"2024-03-11T00:00:00Z\",\n+                \"exploitType\": \"remote\",\n+                \"cloneSshUrl\": \"ssh://example.com/xdb/12345.git\"\n+              }\n+            ],\n+            \"reportedExploitation\": [\n+              {\n+                \"url\": \"https://example.com/report/1\",\n+                \"dateAdded\": \"2024-03-12T00:00:00Z\"\n+              }\n+            ]\n+          }\n+        }\n+      ]\n+    }\n+  },\n+  \"packages\": {\n+    \"example-pkg\": {\n+      \"name\": \"example-pkg\",\n+      \"version\": \"1.2.2\",\n+      \"release\": \"1\"\n+    }\n+  }\n+}\ndiff --git a/models/scanresults.go b/models/scanresults.go\nindex 508b992..bf2eea5 100644\n--- a/models/scanresults.go\n+++ b/models/scanresults.go\n@@ -197,7 +197,7 @@ func (r ScanResult) FormatTextReportHeader() string {\n \t\tpkgs = fmt.Sprintf(\"%s, %d libs\", pkgs, r.LibraryScanners.Total())\n \t}\n \n-\treturn fmt.Sprintf(\"%s\\n%s\\n%s\\n%s, %s, %s, %s\\n%s\\n\",\n+\treturn fmt.Sprintf(\"%s\\n%s\\n%s\\n%s, %s, %s, %s, %s\\n%s\\n\",\n \t\tr.ServerInfo(),\n \t\tbuf.String(),\n \t\tr.ScannedCves.FormatCveSummary(),\n@@ -205,6 +205,7 @@ func (r ScanResult) FormatTextReportHeader() string {\n \t\tr.FormatExploitCveSummary(),\n \t\tr.FormatMetasploitCveSummary(),\n \t\tr.FormatAlertSummary(),\n+\t\tr.FormatKEVCveSummary(),\n \t\tpkgs)\n }\n \n@@ -253,13 +254,9 @@ func (r ScanResult) FormatMetasploitCveSummary() string {\n \n // FormatAlertSummary returns a summary of CERT alerts\n func (r ScanResult) FormatAlertSummary() string {\n-\tcisaCnt := 0\n \tuscertCnt := 0\n \tjpcertCnt := 0\n \tfor _, vuln := range r.ScannedCves {\n-\t\tif len(vuln.AlertDict.CISA) > 0 {\n-\t\t\tcisaCnt += len(vuln.AlertDict.CISA)\n-\t\t}\n \t\tif len(vuln.AlertDict.USCERT) > 0 {\n \t\t\tuscertCnt += len(vuln.AlertDict.USCERT)\n \t\t}\n@@ -267,7 +264,17 @@ func (r ScanResult) FormatAlertSummary() string {\n \t\t\tjpcertCnt += len(vuln.AlertDict.JPCERT)\n \t\t}\n \t}\n-\treturn fmt.Sprintf(\"cisa: %d, uscert: %d, jpcert: %d alerts\", cisaCnt, uscertCnt, jpcertCnt)\n+\treturn fmt.Sprintf(\"uscert: %d, jpcert: %d alerts\", uscertCnt, jpcertCnt)\n+}\n+\n+func (r ScanResult) FormatKEVCveSummary() string {\n+\tnKEV := 0\n+\tfor _, vuln := range r.ScannedCves {\n+\t\tif 0 < len(vuln.KEVs) {\n+\t\t\tnKEV++\n+\t\t}\n+\t}\n+\treturn fmt.Sprintf(\"%d kevs\", nKEV)\n }\n \n func (r ScanResult) isDisplayUpdatableNum(mode config.ScanMode) bool {\n@@ -434,8 +441,11 @@ func (r *ScanResult) SortForJSONOutput() {\n \t\tsort.Slice(v.AlertDict.JPCERT, func(i, j int) bool {\n \t\t\treturn v.AlertDict.JPCERT[i].Title < v.AlertDict.JPCERT[j].Title\n \t\t})\n-\t\tsort.Slice(v.AlertDict.CISA, func(i, j int) bool {\n-\t\t\treturn v.AlertDict.CISA[i].Title < v.AlertDict.CISA[j].Title\n+\t\tsort.Slice(v.KEVs, func(i, j int) bool {\n+\t\t\tif v.KEVs[i].Type != v.KEVs[j].Type {\n+\t\t\t\treturn v.KEVs[i].Type < v.KEVs[j].Type\n+\t\t\t}\n+\t\t\treturn v.KEVs[i].VulnerabilityName < v.KEVs[j].VulnerabilityName\n \t\t})\n \t\tr.ScannedCves[k] = v\n \t}\ndiff --git a/models/vulninfos.go b/models/vulninfos.go\nindex 3e85e81..c8098a2 100644\n--- a/models/vulninfos.go\n+++ b/models/vulninfos.go\n@@ -275,6 +275,50 @@ type VulnInfo struct {\n \tWindowsKBFixedIns    []string             `json:\"windowsKBFixedIns,omitempty\"`\n \tVulnType             string               `json:\"vulnType,omitempty\"`\n \tDiffStatus           DiffStatus           `json:\"diffStatus,omitempty\"`\n+\tKEVs                 []KEV                `json:\"kevs,omitempty\"`\n+}\n+\n+type KEVType string\n+\n+const (\n+\tCISAKEVType      KEVType = \"cisa\"\n+\tVulnCheckKEVType KEVType = \"vulncheck\"\n+)\n+\n+type KEV struct {\n+\tType                         KEVType    `json:\"type,omitempty\"`\n+\tVendorProject                string     `json:\"vendorProject,omitempty\"`\n+\tProduct                      string     `json:\"product,omitempty\"`\n+\tVulnerabilityName            string     `json:\"vulnerabilityName,omitempty\"`\n+\tShortDescription             string     `json:\"shortDescription,omitempty\"`\n+\tRequiredAction               string     `json:\"requiredAction,omitempty\"`\n+\tKnownRansomwareCampaignUse   string     `json:\"knownRansomwareCampaignUse,omitempty\"`\n+\tDateAdded                    time.Time  `json:\"dateAdded,omitempty\"`\n+\tDueDate                      *time.Time `json:\"dueDate,omitempty\"`\n+\tCISA                         *CISAKEV   `json:\"cisa,omitempty\"`\n+\tVulnCheck                    *VulnCheckKEV `json:\"vulnCheck,omitempty\"`\n+}\n+\n+type CISAKEV struct {\n+\tNote string `json:\"note,omitempty\"`\n+}\n+\n+type VulnCheckKEV struct {\n+\tXDB                    []VulnCheckXDB                `json:\"xdb,omitempty\"`\n+\tReportedExploitation   []VulnCheckReportedExploitation `json:\"reportedExploitation,omitempty\"`\n+}\n+\n+type VulnCheckXDB struct {\n+\tXDBID        string    `json:\"xdbId,omitempty\"`\n+\tXDBURL       string    `json:\"xdbUrl,omitempty\"`\n+\tDateAdded    time.Time `json:\"dateAdded,omitempty\"`\n+\tExploitType  string    `json:\"exploitType,omitempty\"`\n+\tCloneSSHURL  string    `json:\"cloneSshUrl,omitempty\"`\n+}\n+\n+type VulnCheckReportedExploitation struct {\n+\tURL       string    `json:\"url,omitempty\"`\n+\tDateAdded time.Time `json:\"dateAdded,omitempty\"`\n }\n \n // Alert has CERT alert information\n@@ -910,24 +954,20 @@ type Mitigation struct {\n \tURL            string         `json:\"url,omitempty\"`\n }\n \n-// AlertDict has target cve JPCERT, USCERT and CISA alert data\n+// AlertDict has target cve JPCERT, USCERT alert data\n type AlertDict struct {\n-\tCISA   []Alert `json:\"cisa\"`\n \tJPCERT []Alert `json:\"jpcert\"`\n \tUSCERT []Alert `json:\"uscert\"`\n }\n \n // IsEmpty checks if the content of AlertDict is empty\n func (a AlertDict) IsEmpty() bool {\n-\treturn len(a.CISA) == 0 && len(a.JPCERT) == 0 && len(a.USCERT) == 0\n+\treturn len(a.JPCERT) == 0 && len(a.USCERT) == 0\n }\n \n // FormatSource returns which source has this alert\n func (a AlertDict) FormatSource() string {\n \tvar s []string\n-\tif len(a.CISA) != 0 {\n-\t\ts = append(s, \"CISA\")\n-\t}\n \tif len(a.USCERT) != 0 || len(a.JPCERT) != 0 {\n \t\ts = append(s, \"CERT\")\n \t}\ndiff --git a/reporter/util.go b/reporter/util.go\nindex d9cfdaa..a44ae57 100644\n--- a/reporter/util.go\n+++ b/reporter/util.go\n@@ -565,10 +565,6 @@ No CVE-IDs are found in updatable packages.\n \t\t})\n \t\tdata = append(data, ds...)\n \n-\t\tfor _, alert := range vuln.AlertDict.CISA {\n-\t\t\tdata = append(data, []string{\"CISA Alert\", alert.URL})\n-\t\t}\n-\n \t\tfor _, alert := range vuln.AlertDict.JPCERT {\n \t\t\tdata = append(data, []string{\"JPCERT Alert\", alert.URL})\n \t\t}\ndiff --git a/tui/tui.go b/tui/tui.go\nindex 4407f56..80afe95 100644\n--- a/tui/tui.go\n+++ b/tui/tui.go\n@@ -812,16 +812,6 @@ func setChangelogLayout(g *gocui.Gui) error {\n \t\t\t}\n \t\t}\n \n-\t\tif len(vinfo.AlertDict.CISA) > 0 {\n-\t\t\tlines = append(lines, \"\\n\",\n-\t\t\t\t\"CISA Alert\",\n-\t\t\t\t\"===========\",\n-\t\t\t)\n-\t\t\tfor _, alert := range vinfo.AlertDict.CISA {\n-\t\t\t\tlines = append(lines, fmt.Sprintf(\"* [%s](%s)\", alert.Title, alert.URL))\n-\t\t\t}\n-\t\t}\n-\n \t\tif len(vinfo.AlertDict.USCERT) > 0 {\n \t\t\tlines = append(lines, \"\\n\",\n \t\t\t\t\"USCERT Alert\",\n", "creation_timestamp": "2026-07-20T13:38:24.331056Z"}