{"uuid": "06e7b948-1962-4dc9-b9a7-0c431a03f67f", "vulnerability_lookup_origin": "1a89b78e-f703-45f3-bb86-59eb712668bd", "author": "9f56dd64-161d-43a6-b9c3-555944290a09", "vulnerability": "CVE-0000-0000", "type": "seen", "source": "https://gist.github.com/tu-trinh-scale/5e7a6ebc0d9d651c0c4ecdb7b58b9945", "content": "diff --git a/README.md b/README.md\nindex 57102d1..ee58981 100644\n--- a/README.md\n+++ b/README.md\n@@ -49,6 +49,53 @@ Vuls is a tool created to solve the problems listed above. It has the following\n \n [Supports major Linux/FreeBSD/Windows/macOS](https://vuls.io/docs/en/supported-os.html)\n \n+## Example Configuration\n+\n+Here is an example `config.toml` file. You can find this example as `config.toml.example` in the repository root.\n+\n+```toml\n+# vuls scanning configuration example\n+# Copy this file to config.toml and replace with your own values.\n+\n+[default]\n+port = \"22\"\n+\n+[servers.example-web01]\n+host        = \"192.168.0.10\"\n+port        = \"22\"\n+user        = \"vuls-user\"\n+keyPath     = \"/home/vuls-user/.ssh/id_rsa\"\n+keyPassword = \"your-ssh-passphrase-here\"\n+\n+[servers.example-db01]\n+host        = \"192.168.0.11\"\n+port        = \"22\"\n+user        = \"vuls-user\"\n+keyPath     = \"/home/vuls-user/.ssh/id_rsa\"\n+\n+[email]\n+smtpAddr = \"smtp.example.com\"\n+smtpPort = \"587\"\n+user     = \"vuls@example.com\"\n+password = \"your-smtp-password\"\n+from     = \"vuls@example.com\"\n+to       = [\"alerts@example.com\"]\n+\n+[slack]\n+hookURL  = \"https://hooks.slack.com/services/YOUR/WEBHOOK/URL\"\n+authUser = \"vuls\"\n+channel  = \"#vuls-alerts\"\n+\n+[chatWork]\n+apiToken = \"your-chatwork-api-token\"\n+room     = \"123456789\"\n+\n+[kevuln]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-kev.sqlite3\"\n+```\n+\n+\n - Alpine, Amazon Linux, CentOS, AlmaLinux, Rocky Linux, Debian, Oracle Linux, Raspbian, RHEL, openSUSE, openSUSE Leap, SUSE Enterprise Linux, Fedora, and Ubuntu\n - FreeBSD\n - Windows\ndiff --git a/config.toml.example b/config.toml.example\nnew file mode 100644\nindex 0000000..383e3b1\n--- /dev/null\n+++ b/config.toml.example\n@@ -0,0 +1,39 @@\n+# vuls scanning configuration example\n+# Copy this file to config.toml and replace with your own values.\n+\n+[default]\n+port = \"22\"\n+\n+[servers.example-web01]\n+host        = \"192.168.0.10\"\n+port        = \"22\"\n+user        = \"vuls-user\"\n+keyPath     = \"/home/vuls-user/.ssh/id_rsa\"\n+keyPassword = \"your-ssh-passphrase-here\"\n+\n+[servers.example-db01]\n+host        = \"192.168.0.11\"\n+port        = \"22\"\n+user        = \"vuls-user\"\n+keyPath     = \"/home/vuls-user/.ssh/id_rsa\"\n+\n+[email]\n+smtpAddr = \"smtp.example.com\"\n+smtpPort = \"587\"\n+user     = \"vuls@example.com\"\n+password = \"your-smtp-password\"\n+from     = \"vuls@example.com\"\n+to       = [\"alerts@example.com\"]\n+\n+[slack]\n+hookURL  = \"https://hooks.slack.com/services/YOUR/WEBHOOK/URL\"\n+authUser = \"vuls\"\n+channel  = \"#vuls-alerts\"\n+\n+[chatWork]\n+apiToken = \"your-chatwork-api-token\"\n+room     = \"123456789\"\n+\n+[kevuln]\n+type = \"sqlite3\"\n+SQLite3Path = \"/path/to/go-kev.sqlite3\"\ndiff --git a/detector/kevuln.go b/detector/kevuln.go\nindex 41afdfe..9d831b0 100644\n--- a/detector/kevuln.go\n+++ b/detector/kevuln.go\n@@ -90,7 +90,6 @@ func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging\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\tnKEV++\n \t\t\t}\n \t\t\tr.ScannedCves[res.request.cveID] = v\n@@ -117,7 +116,6 @@ func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging\n \t\t\t\t})\n \t\t\t}\n \n-\t\t\tvuln.AlertDict.CISA = alerts\n \t\t\tnKEV++\n \t\t\tr.ScannedCves[cveID] = vuln\n \t\t}\ndiff --git a/models/scanresults.go b/models/scanresults.go\nindex 508b992..22621df 100644\n--- a/models/scanresults.go\n+++ b/models/scanresults.go\n@@ -197,17 +197,29 @@ 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 \t\tr.ScannedCves.FormatFixedStatus(r.Packages),\n+\t\tr.FormatKEVCveSummary(),\n \t\tr.FormatExploitCveSummary(),\n \t\tr.FormatMetasploitCveSummary(),\n \t\tr.FormatAlertSummary(),\n \t\tpkgs)\n }\n \n+// FormatKEVCveSummary returns a summary of KEV cve\n+func (r ScanResult) FormatKEVCveSummary() string {\n+\tnKevCve := 0\n+\tfor _, vuln := range r.ScannedCves {\n+\t\tif 0 < len(vuln.KEVs) {\n+\t\t\tnKevCve++\n+\t\t}\n+\t}\n+\treturn fmt.Sprintf(\"%d kevs\", nKevCve)\n+}\n+\n // FormatUpdatablePkgsSummary returns a summary of updatable packages\n func (r ScanResult) FormatUpdatablePkgsSummary() string {\n \tmode := r.Config.Scan.Servers[r.ServerName].Mode\n@@ -253,13 +265,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 +275,7 @@ 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) isDisplayUpdatableNum(mode config.ScanMode) bool {\n@@ -434,8 +442,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/scanresults_test.go b/models/scanresults_test.go\nindex 3b4a34a..37ccd21 100644\n--- a/models/scanresults_test.go\n+++ b/models/scanresults_test.go\n@@ -347,6 +347,11 @@ func TestScanResult_Sort(t *testing.T) {\n \t\t\t\t\t\t\t\t{Title: \"a\"},\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t},\n+\t\t\t\t\t\tKEVs: []KEV{\n+\t\t\t\t\t\t\t{Type: VulnCheckKEVType, VulnerabilityName: \"b\"},\n+\t\t\t\t\t\t\t{Type: CISAKEVType, VulnerabilityName: \"z\"},\n+\t\t\t\t\t\t\t{Type: CISAKEVType, VulnerabilityName: \"a\"},\n+\t\t\t\t\t\t},\n \t\t\t\t\t},\n \t\t\t\t},\n \t\t\t},\n@@ -406,6 +411,11 @@ func TestScanResult_Sort(t *testing.T) {\n \t\t\t\t\t\t\t\t{Title: \"b\"},\n \t\t\t\t\t\t\t},\n \t\t\t\t\t\t},\n+\t\t\t\t\t\tKEVs: []KEV{\n+\t\t\t\t\t\t\t{Type: CISAKEVType, VulnerabilityName: \"a\"},\n+\t\t\t\t\t\t\t{Type: CISAKEVType, VulnerabilityName: \"z\"},\n+\t\t\t\t\t\t\t{Type: VulnCheckKEVType, VulnerabilityName: \"b\"},\n+\t\t\t\t\t\t},\n \t\t\t\t\t},\n \t\t\t\t},\n \t\t\t},\ndiff --git a/models/vulninfos.go b/models/vulninfos.go\nindex 3e85e81..bdf0db2 100644\n--- a/models/vulninfos.go\n+++ b/models/vulninfos.go\n@@ -275,6 +275,7 @@ 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 // Alert has CERT alert information\n@@ -910,24 +911,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}\n@@ -1089,3 +1086,47 @@ var (\n \t// FortinetVendorProductMatch is a ranking how confident the CVE-ID was detected correctly\n \tFortinetVendorProductMatch = Confidence{10, FortinetVendorProductMatchStr, 9}\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\n+\tVendorProject              string\n+\tProduct                    string\n+\tVulnerabilityName          string\n+\tShortDescription           string\n+\tRequiredAction             string\n+\tKnownRansomwareCampaignUse string\n+\tDateAdded                  time.Time\n+\tDueDate                    *time.Time\n+\tCISA                       *CISAKEV\n+\tVulnCheck                  *VulnCheckKEV\n+}\n+\n+type CISAKEV struct {\n+\tNote string\n+}\n+\n+type VulnCheckKEV struct {\n+\tXDB                  []VulnCheckXDB\n+\tReportedExploitation []VulnCheckReportedExploitation\n+}\n+\n+type VulnCheckXDB struct {\n+\tXDBID       string\n+\tXDBURL      string\n+\tDateAdded   time.Time\n+\tExploitType string\n+\tCloneSSHURL string\n+}\n+\n+type VulnCheckReportedExploitation struct {\n+\tURL       string\n+\tDateAdded time.Time\n+}\n+\ndiff --git a/reporter/util.go b/reporter/util.go\nindex d9cfdaa..703e9c8 100644\n--- a/reporter/util.go\n+++ b/reporter/util.go\n@@ -202,6 +202,7 @@ func formatOneLineSummary(rs ...models.ScanResult) string {\n \t\t\t\tr.ScannedCves.FormatCveSummary(),\n \t\t\t\tr.ScannedCves.FormatFixedStatus(r.Packages),\n \t\t\t\tr.FormatUpdatablePkgsSummary(),\n+\t\t\t\tr.FormatKEVCveSummary(),\n \t\t\t\tr.FormatExploitCveSummary(),\n \t\t\t\tr.FormatMetasploitCveSummary(),\n \t\t\t\tr.FormatAlertSummary(),\n@@ -565,10 +566,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/sample-scan-result.json b/sample-scan-result.json\nnew file mode 100644\nindex 0000000..cd51415\n--- /dev/null\n+++ b/sample-scan-result.json\n@@ -0,0 +1,62 @@\n+{\n+  \"jsonVersion\": 4,\n+  \"serverName\": \"example-host\",\n+  \"family\": \"ubuntu\",\n+  \"release\": \"22.04\",\n+  \"serverUUID\": \"00000000-0000-0000-0000-000000000000\",\n+  \"config\": {\n+    \"host\": \"192.168.0.10\",\n+    \"port\": \"22\",\n+    \"user\": \"vuls-user\"\n+  },\n+  \"scannedAt\": \"2024-06-03T02:00:11Z\",\n+  \"scannedIPv4Addrs\": [\"192.168.0.10\"],\n+  \"runningKernel\": { \"release\": \"5.15.0-105-generic\" },\n+  \"packages\": {\n+    \"openssl\": { \"name\": \"openssl\", \"version\": \"3.0.2\", \"release\": \"0ubuntu1.15\" }\n+  },\n+  \"scannedCves\": {\n+    \"CVE-0000-0000\": {\n+      \"cveID\": \"CVE-0000-0000\",\n+      \"affectedPackages\": [{ \"name\": \"openssl\", \"notFixedYet\": false }],\n+      \"kevs\": [\n+        {\n+          \"Type\": \"cisa\",\n+          \"VendorProject\": \"Example Vendor\",\n+          \"Product\": \"Example Product\",\n+          \"VulnerabilityName\": \"Example Vulnerability\",\n+          \"ShortDescription\": \"A test CVE for documentation.\",\n+          \"RequiredAction\": \"Apply updates per vendor instructions.\",\n+          \"DateAdded\": \"2024-06-03T02:00:11Z\",\n+          \"CISA\": {\n+            \"Note\": \"This is a documentation example.\"\n+          }\n+        },\n+        {\n+          \"Type\": \"vulncheck\",\n+          \"VendorProject\": \"Example Vendor\",\n+          \"Product\": \"Example Product\",\n+          \"VulnerabilityName\": \"Example Vulnerability\",\n+          \"ShortDescription\": \"A test CVE for documentation.\",\n+          \"DateAdded\": \"2024-06-03T02:00:11Z\",\n+          \"VulnCheck\": {\n+            \"XDB\": [\n+              {\n+                \"XDBID\": \"XDB-0000\",\n+                \"XDBURL\": \"https://example.com/xdb/0000\",\n+                \"DateAdded\": \"2024-06-03T02:00:11Z\",\n+                \"ExploitType\": \"RCE\"\n+              }\n+            ],\n+            \"ReportedExploitation\": [\n+              {\n+                \"URL\": \"https://example.com/report/0000\",\n+                \"DateAdded\": \"2024-06-03T02:00:11Z\"\n+              }\n+            ]\n+          }\n+        }\n+      ]\n+    }\n+  }\n+}\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-08T21:20:51.901124Z"}