<Ángel De Cara Salas:=#

Documentación de
Minerva

Guía técnica y manual de despliegue para la herramienta de auditoría de redes.

01. Descripción

Minerva es una herramienta integral de seguridad de red diseñada para automatizar las fases de reconocimiento y evaluación de vulnerabilidades de una prueba de penetración o auditoría de seguridad.

Al envolver las capacidades principales de Nmap dentro de un backend moderno y asíncrono en FastAPI, Minerva proporciona un mapeo de red en tiempo real, fingerprinting de servicios y una correlación automática de los servicios descubiertos con la National Vulnerability Database (NVD).

02. Características principales

Descubrimiento Automático

Utiliza Nmap para identificar hosts activos, puertos abiertos, servicios en ejecución y sistemas operativos.

Correlación CVE

Mapea automáticamente los servicios descubiertos contra vulnerabilidades conocidas usando la API de NIST NVD.

Reportes Ejecutivos

Exporta reportes en formato PDF con métricas de severidad y topología de red listos para el cliente final.

Empaquetado Nativo

Distribuido mediante paquetes Debian (.deb) para instalaciones directas sin configuraciones complejas en entornos Linux.

03. Instalación (.deb)

Minerva se distribuye como un paquete .deb para un despliegue optimizado. El gestor de paquetes manejará automáticamente la instalación de las dependencias.

bash

# Descargar e instalar

visitor@host:~$ wget https://github.com/AngelDCS23/Minerva/releases/download/v1.0.0/minerva_1.0_amd64.deb

visitor@host:~$ sudo apt install ./minerva_1.0_amd64.deb

# Iniciar servicio

visitor@host:~$ sudo minerva

04. Configuración (API NVD)

Configura tu API Key del NIST editando el archivo de entorno en la ruta de instalación:

visitor@host:~$ sudo nano /opt/minerva/.env


NVD_API_KEY=tu_api_key_aqui

05. Interfaz y Capturas

Minerva cuenta con una interfaz web moderna, oscura y diseñada específicamente para facilitar la lectura de datos técnicos, topologías de red y listados de CVEs.

Dashboard Principal

Panel de Control General

Mapa de Topología

Perfil de Host y Vulnerabilidades

Reporte PDF y CVEs

Inicio