{"uuid": "1285638a-333f-4385-adb0-2c6f3e236b70", "vulnerability_lookup_origin": "1a89b78e-f703-45f3-bb86-59eb712668bd", "author": "9f56dd64-161d-43a6-b9c3-555944290a09", "vulnerability": "CVE-2024-5678", "type": "seen", "source": "https://gist.github.com/tu-trinh-scale/a5f0ef646141d1377a60896f1cac3b24", "content": "diff --git a/README.md b/README.md\nindex 57102d1..b85e8e9 100644\n--- a/README.md\n+++ b/README.md\n@@ -166,6 +166,18 @@ 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+## Example Configuration\n+\n+An example configuration file is provided at [`config.toml.example`](config.toml.example).\n+Copy it to `config.toml` and edit to match your environment:\n+\n+```bash\n+cp config.toml.example config.toml\n+vi config.toml\n+```\n+\n+The example includes the `[kevuln]` section for enabling CISA/VulnCheck Known Exploited Vulnerabilities (KEV) reporting.\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..b619d2a\n--- /dev/null\n+++ b/config.toml.example\n@@ -0,0 +1,66 @@\n+# Vuls - Example Configuration\n+#\n+# Copy this file to config.toml and edit to match your environment.\n+# See https://vuls.io/docs/en/config.toml.html for full documentation.\n+\n+# HTTP proxy (optional)\n+# httpProxy = \"http://proxy.example.com:8080\"\n+\n+# Directory to store scan results (default: current directory)\n+# resultsDir = \"/opt/vuls/results\"\n+\n+# Default settings applied to all servers unless overridden\n+[default]\n+port = \"22\"\n+user = \"vuls\"\n+keyPath = \"/home/vuls/.ssh/id_rsa\"\n+# scanMode = [\"fast\"]\n+\n+# Define scan target servers\n+[servers.web-server]\n+host = \"192.168.1.10\"\n+# port = \"2222\"\n+# user = \"admin\"\n+# scanMode = [\"fast-root\"]\n+\n+[servers.db-server]\n+host = \"192.168.1.20\"\n+# scanMode = [\"deep\"]\n+\n+# --- Vulnerability Dictionary Configuration ---\n+\n+# NVD / JVN vulnerability dictionary\n+[cveDict]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/cve.sqlite3\"\n+\n+# OVAL definitions\n+[ovalDict]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/oval.sqlite3\"\n+\n+# Security tracker (gost)\n+[gost]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/gost.sqlite3\"\n+\n+# Exploit database (go-exploitdb)\n+[exploit]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/go-exploitdb.sqlite3\"\n+\n+# Metasploit database (go-msfdb)\n+[metasploit]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/go-msfdb.sqlite3\"\n+\n+# CISA Known Exploited Vulnerabilities catalog (go-kev)\n+# Enable this to get KEV data as a first-class field on each vulnerability.\n+[kevuln]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/go-kev.sqlite3\"\n+\n+# MITRE ATT&CK / CAPEC Cyber Threat Intelligence (go-cti)\n+[cti]\n+type = \"sqlite3\"\n+SQLite3Path = \"/opt/vuls/go-cti.sqlite3\"\ndiff --git a/detector/kevuln.go b/detector/kevuln.go\nindex 41afdfe..f5cc2f7 100644\n--- a/detector/kevuln.go\n+++ b/detector/kevuln.go\n@@ -79,18 +79,13 @@ 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 \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 = convertToKEVs(kevulns)\n \t\t\t\tnKEV++\n \t\t\t}\n \t\t\tr.ScannedCves[res.request.cveID] = v\n@@ -108,16 +103,7 @@ 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\t}\n-\n-\t\t\tvuln.AlertDict.CISA = alerts\n+\t\t\tvuln.KEVs = convertToKEVs(kevulns)\n \t\t\tnKEV++\n \t\t\tr.ScannedCves[cveID] = vuln\n \t\t}\n@@ -127,6 +113,31 @@ func FillWithKEVuln(r *models.ScanResult, cnf config.KEVulnConf, logOpts logging\n \treturn nil\n }\n \n+func convertToKEVs(kevulns []kevulnmodels.KEVuln) []models.KEV {\n+\tkevs := make([]models.KEV, 0, len(kevulns))\n+\tfor _, k := range kevulns {\n+\t\tkev := models.KEV{\n+\t\t\tType:                       models.CISAKEVType,\n+\t\t\tVendorProject:              k.VendorProject,\n+\t\t\tProduct:                    k.Product,\n+\t\t\tVulnerabilityName:          k.VulnerabilityName,\n+\t\t\tShortDescription:           k.ShortDescription,\n+\t\t\tRequiredAction:             k.RequiredAction,\n+\t\t\tKnownRansomwareCampaignUse: k.KnownRansomwareCampaignUse,\n+\t\t\tDateAdded:                  k.DateAdded,\n+\t\t\tCISA: &models.CISAKEV{\n+\t\t\t\tNote: k.Notes,\n+\t\t\t},\n+\t\t}\n+\t\tif !k.DueDate.IsZero() {\n+\t\t\tdueDate := k.DueDate\n+\t\t\tkev.DueDate = &dueDate\n+\t\t}\n+\t\tkevs = append(kevs, kev)\n+\t}\n+\treturn kevs\n+}\n+\n type kevulnResponse struct {\n \trequest kevulnRequest\n \tjson    string\ndiff --git a/models/scanresults.go b/models/scanresults.go\nindex 508b992..ac2c419 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,18 @@ 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+// FormatKEVCveSummary returns a summary of how many scanned CVEs have KEV entries\n+func (r ScanResult) FormatKEVCveSummary() string {\n+\tnKEVCve := 0\n+\tfor _, vuln := range r.ScannedCves {\n+\t\tif len(vuln.KEVs) > 0 {\n+\t\t\tnKEVCve++\n+\t\t}\n+\t}\n+\treturn fmt.Sprintf(\"%d kevs\", nKEVCve)\n }\n \n func (r ScanResult) isDisplayUpdatableNum(mode config.ScanMode) bool {\n@@ -437,6 +445,12 @@ func (r *ScanResult) SortForJSONOutput() {\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\t})\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}\n }\ndiff --git a/models/vulninfos.go b/models/vulninfos.go\nindex 3e85e81..307b41b 100644\n--- a/models/vulninfos.go\n+++ b/models/vulninfos.go\n@@ -268,6 +268,7 @@ type VulnInfo struct {\n \tMitigations          []Mitigation         `json:\"mitigations,omitempty\"`\n \tCtis                 []string             `json:\"ctis,omitempty\"`\n \tAlertDict            AlertDict            `json:\"alertDict,omitempty\"`\n+\tKEVs                 []KEV                `json:\"kevs,omitempty\"`\n \tCpeURIs              []string             `json:\"cpeURIs,omitempty\"` // CpeURIs related to this CVE defined in config.toml\n \tGitHubSecurityAlerts GitHubSecurityAlerts `json:\"gitHubSecurityAlerts,omitempty\"`\n \tWpPackageFixStats    WpPackageFixStats    `json:\"wpPackageFixStats,omitempty\"`\n@@ -910,6 +911,58 @@ type Mitigation struct {\n \tURL            string         `json:\"url,omitempty\"`\n }\n \n+// KEVType represents the source of a Known Exploited Vulnerability entry\n+type KEVType string\n+\n+const (\n+\t// CISAKEVType is the CISA KEV catalog source\n+\tCISAKEVType KEVType = \"cisa\"\n+\n+\t// VulnCheckKEVType is the VulnCheck KEV source\n+\tVulnCheckKEVType KEVType = \"vulncheck\"\n+)\n+\n+// KEV has Known Exploited Vulnerability information\n+type KEV struct {\n+\tType                        KEVType       `json:\"type\"`\n+\tVendorProject               string        `json:\"vendorProject\"`\n+\tProduct                     string        `json:\"product\"`\n+\tVulnerabilityName           string        `json:\"vulnerabilityName\"`\n+\tShortDescription            string        `json:\"shortDescription\"`\n+\tRequiredAction              string        `json:\"requiredAction\"`\n+\tKnownRansomwareCampaignUse  string        `json:\"knownRansomwareCampaignUse\"`\n+\tDateAdded                   time.Time     `json:\"dateAdded\"`\n+\tDueDate                     *time.Time    `json:\"dueDate,omitempty\"`\n+\tCISA                        *CISAKEV      `json:\"cisa,omitempty\"`\n+\tVulnCheck                   *VulnCheckKEV `json:\"vulnCheck,omitempty\"`\n+}\n+\n+// CISAKEV has CISA-specific KEV fields\n+type CISAKEV struct {\n+\tNote string `json:\"note\"`\n+}\n+\n+// VulnCheckKEV has VulnCheck-specific KEV fields\n+type VulnCheckKEV struct {\n+\tXDB                    []VulnCheckXDB                    `json:\"xdb,omitempty\"`\n+\tReportedExploitation   []VulnCheckReportedExploitation   `json:\"reportedExploitation,omitempty\"`\n+}\n+\n+// VulnCheckXDB has VulnCheck exploit database information\n+type VulnCheckXDB struct {\n+\tXDBID       string    `json:\"xdbID\"`\n+\tXDBURL      string    `json:\"xdbURL\"`\n+\tDateAdded   time.Time `json:\"dateAdded\"`\n+\tExploitType string    `json:\"exploitType\"`\n+\tCloneSSHURL string    `json:\"cloneSSHURL\"`\n+}\n+\n+// VulnCheckReportedExploitation has VulnCheck reported exploitation information\n+type VulnCheckReportedExploitation struct {\n+\tURL       string    `json:\"url\"`\n+\tDateAdded time.Time `json:\"dateAdded\"`\n+}\n+\n // AlertDict has target cve JPCERT, USCERT and CISA alert data\n type AlertDict struct {\n \tCISA   []Alert `json:\"cisa\"`\n@@ -919,15 +972,12 @@ type AlertDict struct {\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..5b8697f 100644\n--- a/reporter/util.go\n+++ b/reporter/util.go\n@@ -205,6 +205,7 @@ func formatOneLineSummary(rs ...models.ScanResult) string {\n \t\t\t\tr.FormatExploitCveSummary(),\n \t\t\t\tr.FormatMetasploitCveSummary(),\n \t\t\t\tr.FormatAlertSummary(),\n+\t\t\t\tr.FormatKEVCveSummary(),\n \t\t\t}\n \t\t} else {\n \t\t\tcols = []interface{}{\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..fcbce9f\n--- /dev/null\n+++ b/sample_scan_result.json\n@@ -0,0 +1,133 @@\n+{\n+  \"jsonVersion\": 4,\n+  \"lang\": \"en\",\n+  \"serverName\": \"web-server\",\n+  \"family\": \"ubuntu\",\n+  \"release\": \"22.04\",\n+  \"scannedAt\": \"2026-07-03T12:00:00Z\",\n+  \"scannedCves\": {\n+    \"CVE-2024-1234\": {\n+      \"cveID\": \"CVE-2024-1234\",\n+      \"confidences\": [\n+        {\n+          \"score\": 100,\n+          \"detectionMethod\": \"OvalMatch\"\n+        }\n+      ],\n+      \"affectedPackages\": [\n+        {\n+          \"name\": \"openssl\",\n+          \"fixedIn\": \"3.0.2-0ubuntu1.16\"\n+        }\n+      ],\n+      \"cveContents\": {\n+        \"nvd\": [\n+          {\n+            \"cvss3Score\": 9.8,\n+            \"cvss3Vector\": \"CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H\",\n+            \"cvss3Severity\": \"CRITICAL\",\n+            \"summary\": \"A critical vulnerability in OpenSSL allows remote code execution.\",\n+            \"sourceLink\": \"https://nvd.nist.gov/vuln/detail/CVE-2024-1234\"\n+          }\n+        ]\n+      },\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"OpenSSL\",\n+          \"product\": \"OpenSSL\",\n+          \"vulnerabilityName\": \"OpenSSL Remote Code Execution Vulnerability\",\n+          \"shortDescription\": \"OpenSSL contains a vulnerability that allows a remote attacker to execute arbitrary code on the target system.\",\n+          \"requiredAction\": \"Apply mitigations per vendor instructions or discontinue use of the product if mitigations are unavailable.\",\n+          \"knownRansomwareCampaignUse\": \"Known\",\n+          \"dateAdded\": \"2024-06-15T00:00:00Z\",\n+          \"dueDate\": \"2024-07-06T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"https://nvd.nist.gov/vuln/detail/CVE-2024-1234\"\n+          }\n+        }\n+      ],\n+      \"alertDict\": {}\n+    },\n+    \"CVE-2024-5678\": {\n+      \"cveID\": \"CVE-2024-5678\",\n+      \"confidences\": [\n+        {\n+          \"score\": 100,\n+          \"detectionMethod\": \"OvalMatch\"\n+        }\n+      ],\n+      \"affectedPackages\": [\n+        {\n+          \"name\": \"curl\",\n+          \"fixedIn\": \"7.81.0-1ubuntu1.17\"\n+        }\n+      ],\n+      \"cveContents\": {\n+        \"nvd\": [\n+          {\n+            \"cvss3Score\": 7.5,\n+            \"cvss3Vector\": \"CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N\",\n+            \"cvss3Severity\": \"HIGH\",\n+            \"summary\": \"A vulnerability in curl allows information disclosure.\",\n+            \"sourceLink\": \"https://nvd.nist.gov/vuln/detail/CVE-2024-5678\"\n+          }\n+        ]\n+      },\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"Haxx\",\n+          \"product\": \"curl\",\n+          \"vulnerabilityName\": \"curl Information Disclosure Vulnerability\",\n+          \"shortDescription\": \"curl contains a vulnerability that allows a remote attacker to obtain sensitive information.\",\n+          \"requiredAction\": \"Apply mitigations per vendor instructions or discontinue use of the product if mitigations are unavailable.\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2024-07-01T00:00:00Z\",\n+          \"dueDate\": \"2024-07-22T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"\"\n+          }\n+        },\n+        {\n+          \"type\": \"vulncheck\",\n+          \"vendorProject\": \"Haxx\",\n+          \"product\": \"curl\",\n+          \"vulnerabilityName\": \"curl Information Disclosure Vulnerability\",\n+          \"shortDescription\": \"curl contains a vulnerability that allows a remote attacker to obtain sensitive information.\",\n+          \"requiredAction\": \"Apply mitigations per vendor instructions.\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2024-06-28T00:00:00Z\",\n+          \"vulnCheck\": {\n+            \"xdb\": [\n+              {\n+                \"xdbID\": \"XDB-2024-001\",\n+                \"xdbURL\": \"https://vulncheck.com/xdb/XDB-2024-001\",\n+                \"dateAdded\": \"2024-06-28T00:00:00Z\",\n+                \"exploitType\": \"client-side\",\n+                \"cloneSSHURL\": \"git@github.com:example/poc-CVE-2024-5678.git\"\n+              }\n+            ],\n+            \"reportedExploitation\": [\n+              {\n+                \"url\": \"https://example.com/exploitation-report\",\n+                \"dateAdded\": \"2024-06-30T00:00:00Z\"\n+              }\n+            ]\n+          }\n+        }\n+      ],\n+      \"alertDict\": {}\n+    }\n+  },\n+  \"packages\": {\n+    \"openssl\": {\n+      \"name\": \"openssl\",\n+      \"version\": \"3.0.2-0ubuntu1.15\"\n+    },\n+    \"curl\": {\n+      \"name\": \"curl\",\n+      \"version\": \"7.81.0-1ubuntu1.16\"\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-03T19:59:58.152306Z"}