◈ ProjView
← todos os projetos

cvematic

Python Defensiva GitHub ↗

Cruza inventário de software com base local de CVEs (offline).

2 testes · 2 passou · 0 falhou · 0 skip

Entrypoints (CLI)

Módulos e funções principais

src/cvematic/__init__.py
src/cvematic/cli.py
  • main()
src/cvematic/core.py
  • load_cves()
  • match()
  • main()

Estrutura de arquivos

README

# cvematic Cruza inventário de software com base local de CVEs (offline). ## O que faz Esta ferramenta de **defensiva** contra alvos que voce possui ou tem autorizacao. Cruza inventário de software com base local de CVEs (offline). O codigo e testavel localmente (sem dependencias de rede para os testes unitarios). > **Aviso etico:** uso exclusivo para fins educacionais e testes em ambientes > que voce **possui** ou tem **autorizacao expressa** para auditar. Nunca a > utilize contra sistemas de terceiros. O autor nao se responsabiliza por uso > indevido. ## Instalacao ```bash git clone https://github.com/Diogo-Damasceno/cvematic.git cd cvematic python3 -m venv .venv && . .venv/bin/activate pip install -e . ``` ## Uso Compare seu inventário com uma base CVE mantida localmente. ## Exemplos reais ```bash $ cve-matcher inventory.txt cves.json # [{"cve": "CVE-2026-1", ...}] ``` ## Como funciona (resumo) O modulo principal implementa a logica em funcoes puras e testaveis; a CLI e apenas a casca de argumentos. Os testes em `tests/` (Python) ou `CoreTest.java` (Java) cobrem os casos principais e rodam offline. ## O que NAO faz - Nao executa ataques contra terceiros. - Nao exfiltra dados. - Nao substitui uma solucao comercial de seguranca. ## Licenca MIT — ver `LICENSE`.

Diagrama de fluxo em breve.

Como rodar na prática (entrada → saída):

$ cvematic scan inventory.toml
VERIFICADO openssl 1.1.1 -> CVE-2023-2650 (HIGH)\nOK python 3.11 sem CVE