{"uuid": "e6363372-e03d-4a1b-bfd6-3b26800e6533", "vulnerability_lookup_origin": "1a89b78e-f703-45f3-bb86-59eb712668bd", "author": "9f56dd64-161d-43a6-b9c3-555944290a09", "vulnerability": "CVE-0000-0001", "type": "seen", "source": "https://gist.github.com/tu-trinh-scale/f5f583f87afb3c9510fcd9d383f599b7", "content": "diff --git a/README.md b/README.md\nindex 57102d1..4b90ce0 100644\n--- a/README.md\n+++ b/README.md\n@@ -90,8 +90,9 @@ Vuls is a tool created to solve the problems listed above. It has the following\n   - [US-CERT](https://www.us-cert.gov/ncas/alerts)\n   - [JPCERT](http://www.jpcert.or.jp/at/2019.html)\n \n-- CISA(Cybersecurity & Infrastructure Security Agency)\n-  - [Known Exploited Vulnerabilities Catalog](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)\n+- CISA / VulnCheck KEV (Known Exploited Vulnerabilities)\n+  - [CISA Known Exploited Vulnerabilities Catalog](https://www.cisa.gov/known-exploited-vulnerabilities-catalog)\n+  - [VulnCheck KEV](https://vulncheck.com/kev)\n \n - Cyber Threat Intelligence(MITRE ATT&CK and CAPEC)\n   - [mitre/cti](https://github.com/mitre/cti)\n@@ -174,6 +175,13 @@ Vuls has some options to detect the vulnerabilities\n \n ----\n \n+## 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. To enable KEV\n+(Known Exploited Vulnerabilities) reporting from CISA and VulnCheck, configure\n+the `[kevuln]` section to point at your `go-kev` database.\n+\n ## Document\n \n For more information such as Installation, Tutorial, Usage, visit [vuls.io](https://vuls.io/)  \ndiff --git a/config.toml.example b/config.toml.example\nnew file mode 100644\nindex 0000000..db271e7\n--- /dev/null\n+++ b/config.toml.example\n@@ -0,0 +1,102 @@\n+# Vuls configuration example\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+# IMPORTANT: Do not commit your real config.toml \u2014 it may contain secrets\n+# (SSH passphrases, SMTP passwords, API tokens, webhook URLs, etc.).\n+\n+# https://vuls.io/docs/en/config.toml.html#database-section\n+[cveDict]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/cve.sqlite3\"\n+#url        = \"\"\n+\n+[ovalDict]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/oval.sqlite3\"\n+#url        = \"\"\n+\n+[gost]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/gost.sqlite3\"\n+#url        = \"\"\n+\n+[exploit]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/go-exploitdb.sqlite3\"\n+#url        = \"\"\n+\n+[metasploit]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/go-msfdb.sqlite3\"\n+#url        = \"\"\n+\n+# KEV (Known Exploited Vulnerabilities) database \u2014 enables the new first-class\n+# KEV field on each vulnerability (supports both CISA and VulnCheck sources).\n+[kevuln]\n+type = \"sqlite3\"\n+sqlite3Path = \"/path/to/go-kev.sqlite3\"\n+#url        = \"\"\n+\n+[cti]\n+#type = \"sqlite3\"\n+#sqlite3Path = \"/path/to/go-cti.sqlite3\"\n+#url        = \"\"\n+\n+# https://vuls.io/docs/en/config.toml.html#slack-section\n+#[slack]\n+#hookURL      = \"https://hooks.slack.com/services/XXXX/YYYY/ZZZZ\"\n+#channel      = \"#vuls-alerts\"\n+#iconEmoji    = \":ghost:\"\n+#authUser     = \"vuls-bot\"\n+#notifyUsers  = [\"@your-username\"]\n+\n+# https://vuls.io/docs/en/config.toml.html#email-section\n+#[email]\n+#smtpAddr              = \"smtp.example.com\"\n+#smtpPort              = \"587\"\n+#tlsMode               = \"STARTTLS\"\n+#tlsInsecureSkipVerify = false\n+#user                  = \"vuls@example.com\"\n+#password              = \"REPLACE_WITH_SMTP_PASSWORD\"\n+#from                  = \"vuls@example.com\"\n+#to                    = [\"security-team@example.com\"]\n+#cc                    = [\"ops@example.com\"]\n+#subjectPrefix         = \"[vuls]\"\n+\n+# https://vuls.io/docs/en/config.toml.html#http-section\n+#[http]\n+#url = \"http://localhost:11234\"\n+\n+# https://vuls.io/docs/en/config.toml.html#chatwork-section\n+#[chatwork]\n+#room     = \"REPLACE_WITH_ROOM_ID\"\n+#apiToken = \"REPLACE_WITH_CHATWORK_TOKEN\"\n+\n+# https://vuls.io/docs/en/config.toml.html#telegram-section\n+#[telegram]\n+#chatID = \"REPLACE_WITH_CHAT_ID\"\n+#token  = \"REPLACE_WITH_TELEGRAM_TOKEN\"\n+\n+# https://vuls.io/docs/en/config.toml.html#googlechat-section\n+#[googlechat]\n+#webHookURL = \"https://chat.googleapis.com/v1/spaces/XXXX/messages?key=YYYY&token=ZZZZ\"\n+\n+# https://vuls.io/docs/en/config.toml.html#default-section\n+[default]\n+#port    = \"22\"\n+#user    = \"vuls-scan\"\n+#keyPath = \"/home/vuls-scan/.ssh/id_rsa\"\n+\n+# https://vuls.io/docs/en/config.toml.html#servers-section\n+[servers]\n+\n+[servers.example-host]\n+host     = \"192.0.2.1\"\n+port     = \"22\"\n+user     = \"vuls-scan\"\n+keyPath  = \"/home/vuls-scan/.ssh/id_rsa\"\n+scanMode = [\"fast\"]\n+\n+#[servers.example-host.optional]\n+#department = \"example-department\"\ndiff --git a/models/scanresults.go b/models/scanresults.go\nindex 508b992..3e392ae 100644\n--- a/models/scanresults.go\n+++ b/models/scanresults.go\n@@ -197,13 +197,14 @@ 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.FormatExploitCveSummary(),\n \t\tr.FormatMetasploitCveSummary(),\n+\t\tr.FormatKEVCveSummary(),\n \t\tr.FormatAlertSummary(),\n \t\tpkgs)\n }\n@@ -251,15 +252,22 @@ func (r ScanResult) FormatMetasploitCveSummary() string {\n \treturn fmt.Sprintf(\"%d exploits\", nMetasploitCve)\n }\n \n+// FormatKEVCveSummary returns a summary of how many 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 // 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,12 @@ 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+\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/testdata/sample_kev_scanresult.json b/models/testdata/sample_kev_scanresult.json\nnew file mode 100644\nindex 0000000..672bc52\n--- /dev/null\n+++ b/models/testdata/sample_kev_scanresult.json\n@@ -0,0 +1,76 @@\n+{\n+  \"jsonVersion\": 4,\n+  \"serverName\": \"example-host\",\n+  \"family\": \"debian\",\n+  \"release\": \"12\",\n+  \"scannedAt\": \"2026-07-01T00:00:00Z\",\n+  \"scannedCves\": {\n+    \"CVE-0000-0000\": {\n+      \"cveID\": \"CVE-0000-0000\",\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"ExampleVendor\",\n+          \"product\": \"ExampleProduct\",\n+          \"vulnerabilityName\": \"ExampleVendor ExampleProduct Remote Code Execution Vulnerability\",\n+          \"shortDescription\": \"ExampleVendor ExampleProduct contains a vulnerability that allows remote code execution.\",\n+          \"requiredAction\": \"Apply mitigations per vendor instructions or discontinue use of the product if mitigations are unavailable.\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2026-01-15T00:00:00Z\",\n+          \"dueDate\": \"2026-02-05T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"https://example.com/advisory/CVE-0000-0000\"\n+          }\n+        },\n+        {\n+          \"type\": \"vulncheck\",\n+          \"vendorProject\": \"ExampleVendor\",\n+          \"product\": \"ExampleProduct\",\n+          \"vulnerabilityName\": \"ExampleVendor ExampleProduct Remote Code Execution Vulnerability\",\n+          \"shortDescription\": \"ExampleVendor ExampleProduct contains a vulnerability that allows remote code execution.\",\n+          \"requiredAction\": \"Apply mitigations per vendor instructions or discontinue use of the product if mitigations are unavailable.\",\n+          \"knownRansomwareCampaignUse\": \"Unknown\",\n+          \"dateAdded\": \"2026-01-10T00:00:00Z\",\n+          \"vulnCheck\": {\n+            \"xdb\": [\n+              {\n+                \"xdbID\": \"a1b2c3d4-0000-0000-0000-000000000000\",\n+                \"xdbURL\": \"https://vulncheck.com/xdb/a1b2c3d4-0000-0000-0000-000000000000\",\n+                \"dateAdded\": \"2026-01-10T00:00:00Z\",\n+                \"exploitType\": \"poc\",\n+                \"cloneSSHURL\": \"git@example.com:exploits/CVE-0000-0000.git\"\n+              }\n+            ],\n+            \"reportedExploitation\": [\n+              {\n+                \"url\": \"https://example.com/threat-intel/CVE-0000-0000\",\n+                \"dateAdded\": \"2026-01-12T00:00:00Z\"\n+              }\n+            ]\n+          }\n+        }\n+      ],\n+      \"alertDict\": {}\n+    },\n+    \"CVE-0000-0001\": {\n+      \"cveID\": \"CVE-0000-0001\",\n+      \"kevs\": [\n+        {\n+          \"type\": \"cisa\",\n+          \"vendorProject\": \"AnotherVendor\",\n+          \"product\": \"AnotherProduct\",\n+          \"vulnerabilityName\": \"AnotherVendor AnotherProduct Privilege Escalation Vulnerability\",\n+          \"shortDescription\": \"AnotherVendor AnotherProduct contains a privilege escalation vulnerability.\",\n+          \"requiredAction\": \"Apply updates per vendor instructions.\",\n+          \"knownRansomwareCampaignUse\": \"Known\",\n+          \"dateAdded\": \"2026-03-01T00:00:00Z\",\n+          \"dueDate\": \"2026-03-22T00:00:00Z\",\n+          \"cisa\": {\n+            \"note\": \"\"\n+          }\n+        }\n+      ],\n+      \"alertDict\": {}\n+    }\n+  }\n+}\ndiff --git a/models/vulninfos.go b/models/vulninfos.go\nindex 3e85e81..3a02dcf 100644\n--- a/models/vulninfos.go\n+++ b/models/vulninfos.go\n@@ -267,6 +267,7 @@ type VulnInfo struct {\n \tMetasploits          []Metasploit         `json:\"metasploits,omitempty\"`\n \tMitigations          []Mitigation         `json:\"mitigations,omitempty\"`\n \tCtis                 []string             `json:\"ctis,omitempty\"`\n+\tKEVs                 []KEV                `json:\"kevs,omitempty\"`\n \tAlertDict            AlertDict            `json:\"alertDict,omitempty\"`\n \tCpeURIs              []string             `json:\"cpeURIs,omitempty\"` // CpeURIs related to this CVE defined in config.toml\n \tGitHubSecurityAlerts GitHubSecurityAlerts `json:\"gitHubSecurityAlerts,omitempty\"`\n@@ -910,28 +911,74 @@ type Mitigation struct {\n \tURL            string         `json:\"url,omitempty\"`\n }\n \n-// AlertDict has target cve JPCERT, USCERT and CISA alert data\n+// KEVType is the type of KEV source\n+type KEVType string\n+\n+const (\n+\t// CISAKEVType is the KEV type for CISA\n+\tCISAKEVType KEVType = \"cisa\"\n+\t// VulnCheckKEVType is the KEV type for VulnCheck\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 and 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\treturn \"CERT\"\n \t}\n-\treturn strings.Join(s, \"/\")\n+\treturn \"\"\n }\n \n // Confidences is a list of Confidence\n", "creation_timestamp": "2026-07-08T21:20:51.995740Z"}