Vulnerability Findings Database

एक स्थैतिक, क्लाइंट-साइड भेद्यता निष्कर्ष ट्रैकर जो Astro + React के साथ निर्मित है — इसे नेटिव Linux डेस्कटॉप ऐप (Tauri v2) के रूप में भी पैक किया गया है। सुरक्षा निष्कर्ष लॉग करें, उन्हें समन्वित प्रकटीकरण के माध्यम से ट्रैक करें, 11 लाइव भेद्यता डेटाबेस में समानांतर खोजें और नवीनतम CVE ब्राउज़ करें — अपने ब्राउज़र में या डेस्कटॉप ऐप के रूप में, बिना किसी बैकएंड की आवश्यकता के।

विषय-सूची

विशेषताएँ
पाँच दृश्य
डेटा मॉडल
भेद्यता डेटाबेस
टेक स्टैक
आरंभ करना
नेटिव डेस्कटॉप ऐप
वैकल्पिक API कुंजियाँ
डेटाबेस कॉन्फ़िगरेशन
खोज पाइपलाइन कैसे काम करती है
डेटा स्थायित्व
निर्यात
AI चैटबॉक्स
परीक्षण
प्रोजेक्ट संरचना
शोध नोट
डिज़ाइन एवं योजना कार्यप्रवाह
लाइसेंस

विशेषताएँ

निष्कर्ष प्रबंधन — गंभीरता, CVSS, CWE, CVE, स्थिति, तिथियाँ, टैग और संदर्भ लिंक के साथ निष्कर्ष बनाएँ, संपादित करें, देखें और हटाएँ

- **एडेप्टर** — प्रति स्रोत एक, प्रत्येक सामान्यीकृत `RawDbItem`s लौटाता है। कुंजी-आधारित एडेप्टर क्रेडेंशियल गायब होने पर स्पष्ट "no API key configured" त्रुटि फेंकते हैं। - **विलय** — कई स्रोतों में मिला एक ही CVE एक कार्ड बन जाता है; फ़ील्ड (summary, severity, CVSS, CWEs, refs, sources) सभी योगदानकर्ताओं से विलय किए जाते हैं। - **KEV बैज** — CISA कैटलॉग एक बार लाया जाता है और कैश किया जाता है; इसमें मौजूद आइटमों को "Known Exploited" बैज मिलता है। - **EPSS** — `api.first.org` पर बैच किया गया लुकअप; प्रत्येक कार्ड EPSS स्कोर और पर्सेंटाइल दिखाता है। - **विफलता अलगाव** — प्रत्येक एडेप्टर अपनी त्रुटियों को पकड़ता है और स्टेटस कॉलबैक के माध्यम से रिपोर्ट करता है; एक बंद स्रोत कभी भी दूसरों को अवरुद्ध नहीं करता। **Browse** पाइपलाइन चार ब्राउज़ स्रोतों पर वही merge/KEV/EPSS तंत्र है, साथ में पेजिनेशन (`hasMore` जब किसी स्रोत ने पूरा पेज लौटाया)। **ऑफ़लाइन मोड** लाइव पाइपलाइन को डाउनलोड किए गए स्नैपशॉट से बदल देता है: Search और Browse IndexedDB कैश (`src/tracker/lib/offline.ts`) पढ़ते हैं, EPSS एनरिचमेंट छोड़ देते हैं, और KEV बैज केवल तभी जोड़ते हैं जब CISA KEV फ़ीड भी डाउनलोड की गई हो। जिन स्रोतों के पास डाउनलोड किया गया स्नैपशॉट नहीं है, वे हैंग होने के बजाय "error / not downloaded" चिप रिपोर्ट करते हैं। **कस्टम डेटाबेस** उसी एडेप्टर इंटरफ़ेस के माध्यम से क्वेरी किए जाते हैं — URL का `{query}` प्लेसहोल्डर प्रतिस्थापित किया जाता है (या `?q=` जोड़ा जाता है), एक वैकल्पिक bearer key `Authorization` के रूप में भेजी जाती है, और प्रतिक्रियाओं को CVE JSON 5.0 या एक साधारण array से सामान्यीकृत किया जाता है। --- ## डेटा स्थायित्व Findings `localStorage` में `findings:all` कुंजी के अंतर्गत संग्रहीत होते हैं — कोई सर्वर नहीं, कोई खाता नहीं, ऑफ़लाइन काम करता है। - प्रति परिवर्तन लेखन डीबाउंस किए जाते हैं और स्वचालित रूप से सहेजे जाते हैं - यदि ब्राउज़र का storage API उपलब्ध नहीं है (या कोई होस्ट artifact-storage API मौजूद है), तो ऐप सुचारु रूप से फ़ॉलबैक करता है - भ्रष्ट पेलोड को क्रैश होने के बजाय खाली माना जाता है - सहेजने में विफलता पर **Retry** बटन के साथ एक बैनर दिखाई देता है > डेटा ब्राउज़र प्रोफ़ाइल में रहता है। साइट डेटा साफ़ करने से आपके Findings मिट जाते हैं — यदि आपको बैकअप चाहिए तो पहले CSV/Markdown में एक्सपोर्ट करें। **ऑफ़लाइन स्नैपशॉट** IndexedDB (डेटाबेस `vulnbook-offline`, `items` + `meta` स्टोर करता है) में रहते हैं — Settings टैब से प्रति स्रोत डाउनलोड किए जाते हैं और ऑफ़लाइन मोड चालू होने पर Search/Browse द्वारा उपयोग किए जाते हैं। वे रीलोड करने पर बने रहते हैं और केवल तब हटाए जाते हैं जब आप उस स्रोत के लिए **Remove** पर क्लिक करते हैं या साइट डेटा साफ़ करते हैं। --- ## एक्सपोर्ट Findings व्यू से, **वर्तमान में फ़िल्टर और सॉर्ट की गई** सूची एक्सपोर्ट करें: - **CSV** — 15 कॉलम (title, project, repo URL, severity, CVSS, status, CWE, CVE, affected versions, discovery/reported/disclosure dates, references, notes, tags)। कॉमा, उद्धरण और नई पंक्तियों के लिए उचित quoting/escaping। - **Markdown** — समान कॉलमों वाली एक GitHub-flavored तालिका। फ़ाइलों के नाम `findings-YYYY-MM-DD.csv` / `.md` होते हैं और वे स्वचालित रूप से डाउनलोड होती हैं। --- ## AI ChatBox ट्रैकर के अंदर बिल्ट-इन AI असिस्टेंट — एक **ओवरले साइडबार** जो कंटेंट के ऊपर स्लाइड होता है, बिना उसे रीफ्लो किए। पूर्ण गाइड के लिए **[docs/ai-chatbox.md](https://gitlab.com/t-beckett/vulnbook/-/blob/main/docs/ai-chatbox.md)** देखें (प्रोवाइडर सेटअप, सुरक्षा नोट्स, समस्या निवारण)। - **पाँच प्रोवाइडर** — OpenAI, Claude (Anthropic), Google Gemini, **Ollama** (लोकल, ऑफ़लाइन) और **OpenCode Zen** (फ्री-टियर मॉडल शामिल)। ऐप में कॉन्फ़िगर किए जाते हैं (key + model), `localStorage` (`chat:config`) में सहेजे जाते हैं, केवल प्रोवाइडर के अपने एंडपॉइंट पर भेजे जाते हैं - **प्रोजेक्ट-विशिष्ट** — हर बातचीत vulnbook (आर्किटेक्चर, डेटा मॉडल, डेटाबेस स्रोत, परंपराएँ) के बारे में बंडल किए गए **knowledge pack** पर आधारित होती है; कॉन्फ़िग पैनल में **Project context** के माध्यम से टॉगल करने योग्य - **स्ट्रीमिंग उत्तर** — **Stop** बटन के साथ लाइव markdown आउटपुट; एक गैर-स्ट्रीमिंग फ़ॉलबैक स्वचालित रूप से सक्रिय हो जाता है - **स्लैश कमांड** — कंपोज़र में `/` टाइप करें: `/mcp` और `/skill` AI Marketplace खोलते हैं, `/new` बातचीत शुरू करता है, `/clear` उसे खाली करता है, `/help` कमांड सूचीबद्ध करता है - **AI Marketplace** — एक साइडबार टैब जो उपलब्ध **MCP** और **Skill** प्रविष्टियों को ग्रिड में सूचीबद्ध करता है; **Connect** किसी प्रविष्टि को टॉगल करता है (सहेजा गया), **Download** रोडमैप पर है (Coming soon) - **चैट इतिहास** — बातचीत सहेजी जाती है (`chat:history`, सबसे पुराने-पहले ट्रिमिंग के साथ सीमित) > **सुरक्षा:** कुंजियाँ लोकल रहती हैं और केवल प्रोवाइडर के पास जाती हैं; सहायक markdown एक सख्त सैनिटाइज़र के माध्यम से रेंडर किया जाता है (कोई raw HTML नहीं); v1 में कनेक्टेड MCP/skill प्रविष्टियाँ केवल स्थिति-आधारित हैं — कुछ भी डाउनलोड या निष्पादित नहीं किया जाता। --- ## परीक्षण प्रोजेक्ट में कोई यूनिट टेस्ट फ्रेमवर्क नहीं है (स्थापित निर्णय) — सत्यापन एक तीन-चरणीय गेट है:```bash # 1. Type-check npm run check # 2. Build npm run build # 3. E2E smoke test (Playwright, 16 checks) npx http-server dist -p 8899 -a 127.0.0.1 & NODE_PATH=<path-to-playwright-node_modules> node scripts/smoke.cjs

फ़ील्ड	विवरण
`id`	अद्वितीय पहचानकर्ता
`projectName`	वह प्रोजेक्ट जिससे निष्कर्ष संबंधित है (आवश्यक)
`repoUrl`	रिपॉज़िटरी URL (आवश्यक, एक मान्य URL होना चाहिए)
`title`	संक्षिप्त शीर्षक (आवश्यक)
`description`	विस्तृत विवरण (आवश्यक, ≥ 10 अक्षर)
`severity`	`Critical` / `High` / `Medium` / `Low`
`cvssScore`	CVSS स्कोर 0–10 (वैकल्पिक)
`cweId`	CWE पहचानकर्ता, जैसे `CWE-79`
`cveId`	CVE पहचानकर्ता, जैसे `CVE-2021-44228`
`affectedVersions`	प्रभावित संस्करण श्रेणियाँ
`status`	`New` / `Reported` / `Acknowledged` / `Fixed` / `Disclosed`
`discoveryDate`	आपने इसे कब खोजा
`reportedDate`	आपने इसे विक्रेता को कब सूचित किया
`disclosureDeadline`	समन्वित-प्रकटीकरण समय-सीमा (डैशबोर्ड अलर्ट को संचालित करती है)
`referenceLinks`	संदर्भ URL की सूची
`notes`	स्वतंत्र-रूप टिप्पणियाँ
`tags`	टैग की सूची (फ़िल्टरिंग के लिए उपयोग)
`createdAt` / `updatedAt`	टाइमस्टैम्प

#	स्रोत	पहुँच	खोज	ब्राउज़	नोट्स
1	NVD (NIST)	सीधा	✅	✅	NVD API 2.0; Browse में 30-दिवसीय विंडो
2	CIRCL	सीधा	✅	✅	CVE खोज + "last" फ़ीड (OSV/CSAF आकृतियाँ)
3	GitHub Advisories	सीधा	✅	✅	GHSA API
4	OSV (Google)	सीधा	✅	—	ओपन-सोर्स इकोसिस्टम भेद्यताएँ
5	CISA KEV	सीधा	✅	✅	Known Exploited Vulnerabilities कैटलॉग
6	Red Hat	सीधा	✅	—	Red Hat CVE डेटाबेस
7	EUVD (ENISA)	सीधा	✅	—	यूरोपीय भेद्यता डेटाबेस
8	Vulners	`.env` कुंजी	✅	—	`PUBLIC_VULNERS_API_KEY`
9	MEND	`.env` टोकन	✅	—	`PUBLIC_MEND_API_TOKEN` (CVE ID लुकअप)
10	VulDB	`.env` कुंजी	✅	—	`PUBLIC_VULDB_API_KEY` (क्रेडिट-आधारित)
11	OpenCVE	`.env` टोकन	✅	—	`PUBLIC_OPENCVE_API_TOKEN`
—	EPSS (FIRST)	सीधा	—	—

परत	विकल्प
फ्रेमवर्क	Astro 6 (स्थैतिक आउटपुट)
UI	React 19 islands
स्टाइलिंग	Tailwind CSS 4 (टोकन-संचालित क्लास)
चार्ट	Recharts
आइकन	lucide-react
मोशन	framer-motion
डेस्कटॉप	Tauri v2 (Linux: deb / rpm / AppImage; Windows: देखें Windows 11 विकास; macOS: देखें macOS विकास)
मोबाइल	Tauri v2 के माध्यम से Android — देखें Android विकास
AI चैट	बिल्ट-इन चैटबॉक्स — OpenAI / Claude / Gemini / Ollama / OpenCode Zen (देखें AI चैटबॉक्स)
भाषा	TypeScript (सख्त)

स्रोत	वेरिएबल	कहाँ से प्राप्त करें
Vulners	`PUBLIC_VULNERS_API_KEY`	Vulners खाता → API कुंजियाँ
MEND	`PUBLIC_MEND_API_TOKEN`	MEND SCA API 2.0 (JWT बियरर टोकन)
VulDB	`PUBLIC_VULDB_API_KEY`	VulDB खाता → API कुंजी (क्रेडिट-आधारित)
OpenCVE	`PUBLIC_OPENCVE_API_TOKEN`	OpenCVE संगठन → API टोकन

Vulnerability Database -- VulnBook

सबसे लोकप्रिय

पाँच दृश्य

1. Dashboard

2. Findings

3. Search

4. Browse

5. Settings

डेटा मॉडल

भेद्यता डेटाबेस

टेक स्टैक

आरंभ करना

Install dependencies

Start the dev server (http://localhost:4321)

Type-check (Astro + TypeScript)

Production build (outputs to dist/)

Preview the production build

macOS

Windows 11

Android

वैकल्पिक API कुंजियाँ

डेटाबेस कॉन्फ़िगरेशन

खोज पाइपलाइन कैसे काम करती है

परियोजना संरचना```