API desarrollada con FastAPI para realizar un escaneo de seguridad del sistema Linux, incluyendo:

  • Información del sistema (RAM, CPU, uptime, distro)
  • Servicios en ejecución
  • Binarios con permisos especiales (SUID/SGID)
  • Auditoría del servicio SSH

📦 Requisitos

  • Python 3.9+
  • venv activado
  • Linux con acceso a información del sistema

📁 Estructura del proyecto


secscope/
├── api.py
├── utils/
│ ├── sysinfo.py
│ ├── services.py
│ ├── permissions.py
│ └── ssh_audit.py
└── venv/

Instalación y ejecución

# 1. Crear entorno virtual si no existe
python3 -m venv venv

# 2. Activar entorno
source venv/bin/activate

# 3. Instalar dependencias
pip install -r requirements.txt
# o si no tienes requirements.txt:
pip install fastapi uvicorn psutil

# 4. Ejecutar la API
uvicorn api:app --reload

Una vez iniciada, accede a la documentación automática en:

Swagger UI: http://localhost:8000/docs

Redoc: http://localhost:8000/redoc

Configuracion de Grafana

Abre Grafana y ve a “Import dashboard”

Pega el contenido del archivo JSON o cárgalo directamente

Asocia el panel a tu fuente de datos

✅ ¿Qué deberías ver en Grafana?

  • El dashboard de Grafana mostrará paneles como:

  • Uso de CPU y RAM en tiempo real

  • Servicios en ejecución

  • Auditoría de configuración SSH

  • Detalles del sistema (hostname, arquitectura, etc.)

Vista previa del dashboard

Ejemplo del panel de control con métricas del sistema


Contribuciones

¡Bienvenidas las contribuciones!

  • Haz fork del proyecto
  • Crea una rama: git checkout -b feature/nueva-funcionalidad
  • Haz commit: git commit -am 'Añade nueva funcionalidad'
  • Haz push: git push origin feature/nueva-funcionalidad
  • Abre un Pull Request