seguridad-nacional 0.1.0

Librería de seguridad para monitoreo y protección de endpoints en aplicaciones Python

🔒 Seguridad Nacional - Librería de Seguridad

Protección automatizada de endpoints para aplicaciones Python

Una librería Python diseñada para proteger aplicaciones web salvadoreñas contra ciberataques masivos. Con más de 600,000 ciberataques registrados en El Salvador durante 2024, esta herramienta proporciona monitoreo continuo, detección de vulnerabilidades y bloqueo automático de amenazas.

🎯 Problema que Resuelve

El Salvador enfrenta:

• 600,000+ ciberataques en 2024 (Constella Intelligence, Mayo 2024)
• Solo ~300 profesionales certificados en ciberseguridad
• Brechas masivas de datos (5M ciudadanos, PGR, Movistar)
• Incapacidad de defender infraestructura crítica y datos personales

✨ Características

🔍 Monitoreo Continuo

• Monitoreo automático de todos los endpoints
• Análisis en tiempo real de requests y parámetros
• Detección de patrones sospechosos e inusuales

🛡️ Protección contra Ataques Comunes

• SQL Injection: Detección y bloqueo automático
• XSS (Cross-Site Scripting): Validación y sanitización
• Ataques por IP: Identificación de comportamientos anómalos
• Robo de datos: Detección de intentos de extracción masiva

🚫 Bloqueo Automático

• Bloqueo automático de IPs maliciosas
• Corte de conexiones sospechosas
• Reglas configurables de seguridad por severidad

📊 Dashboard de Visualización

• Mapa mundial de ataques (heatmap por IP/país)
• Endpoints más vulnerables
• Tipos de vulnerabilidades más frecuentes
• Estadísticas en tiempo real
• Historial de ataques con filtros

🚀 Instalación

pip install seguridad-nacional

💻 Uso Básico

FastAPI

from fastapi import FastAPI
import seguridad_nacional as sn

app = FastAPI()

# Proteger la aplicación (automático)
sn.monitor(app)

@app.get("/api/users")
async def get_users():
    return {"users": []}

Flask

from flask import Flask
import seguridad_nacional as sn

app = Flask(__name__)

# Proteger la aplicación (automático)
sn.monitor(app)

@app.route("/api/users")
def get_users():
    return {"users": []}

Django

En settings.py:

MIDDLEWARE = [
    # ... otros middlewares ...
    'seguridad_nacional.middleware.django_middleware.DjangoSecurityMiddleware',
]

O usar la función monitor():

# En tu archivo de configuración
import seguridad_nacional as sn
sn.monitor(framework='django')

Decorador Manual

También puedes usar decoradores manuales (FastAPI/Flask):

@sn.protect
@app.post("/api/data")
async def receive_data(data: dict):
    return {"status": "ok"}

Configuración

Crea un archivo .env:

SEGURIDAD_NACIONAL_ENABLED=true
SEGURIDAD_NACIONAL_DB_PATH=./seguridad.db
SEGURIDAD_NACIONAL_DASHBOARD_USER=admin
SEGURIDAD_NACIONAL_DASHBOARD_PASSWORD=admin123
SEGURIDAD_NACIONAL_BLOCK_THRESHOLD=25

O crea un archivo config.yaml:

seguridad:
  enabled: true
  db_path: ./seguridad.db
  block_threshold: 25
  dashboard:
    user: admin
    password: admin123
  whitelist:
    ips: []
    patterns: []

📋 Requisitos

• Python 3.8+
• Soporta múltiples frameworks:
  • ✅ FastAPI (completamente implementado)
  • ✅ Flask (completamente implementado)
  • ✅ Django (completamente implementado)

🏗️ Arquitectura

seguridad_nacional/
├── core/           # Núcleo de la librería
├── detectors/      # Detectores de vulnerabilidades
├── middleware/     # Middlewares para frameworks
├── dashboard/      # API y frontend del dashboard
├── storage/        # Persistencia (SQLite)
├── utils/          # Utilidades (geolocalización, etc.)
└── config/         # Configuración

📈 Roadmap

• Detección básica de SQL Injection
• Detección de XSS
• Bloqueo automático de IPs
• Dashboard completo
• Integración con normativas salvadoreñas
• Machine Learning para detección avanzada

📄 Licencia

MIT License

🤝 Contribuciones

Este proyecto es parte de un hackathon de Seguridad Nacional Inteligente auspiciado por Key Institute (El Salvador).

📞 Contacto

Para reportar vulnerabilidades o sugerencias, por favor abra un issue.

---

Desarrollado para fortalecer la ciberseguridad en El Salvador 🇸🇻