🔗 Nexus

← Volver a notas
11 KB 25/05/2026 16:15
🔗

DX-Guard — Análisis de Código

Repo: dannyelito/DX-Guard
Último commit: 6253185 — fix(backend): manually inject missing get_db to resolve 500 API errors
Fecha análisis: 25/05/2026
Estado: 4 meses sin actividad


✅ Fixes Aplicados (25/05/2026)

# Estado Fix Archivos
✅ Fix #1 - USB toggle conn.execute() → cursor.execute() en endpoint /api/reglas y en todos los endpoints que usaban el método incorrecto main.py — 10 instancias corregidas
✅ Fix #2 - Links visibles Nuevo endpoint GET /api/admin/domains que devuelve la lista de dominios bloqueados main.py
✅ Fix #3 - Bloqueo www El agente ahora bloquea facebook.com y www.facebook.com Worker.cs
✅ Test básico Script test_dxguard.py para validar sintaxis y endpoints test_dxguard.py

Pendiente de probar en Windows

📋 Introducción

DX-Guard es un sistema SaaS de monitoreo y control parental/empresarial para estaciones Windows. Permite a administradores gestionar restricciones de hardware (USB), navegación web (bloqueo por hosts), instalaciones de software y supervisión en tiempo real.

Público objetivo: Empresas que quieren controlar qué hacen los empleados en sus PCs.

Funcionalidades clave

  1. Agente Windows (C# .NET 8) — Servicio que se ejecuta en cada PC del empleado
  2. Servidor Core (Python/FastAPI) — API REST + PostgreSQL
  3. Panel Web (HTML/Bootstrap) — Dashboard de administración multi-empresa

🏗️ Arquitectura

┌─────────────────────┐     ┌──────────────────────┐     ┌──────────────┐
│  Agente Windows     │────▶│  Servidor Core       │────▶│  PostgreSQL  │
│  (C# .NET 8 Worker) │     │  (Python FastAPI)    │     │  (Multi-Tenant)│
│  - Bloqueo USB      │     │  - Heartbeat API     │     └──────────────┘
│  - Bloqueo Web      │     │  - Reglas dinámicas  │
│  - Anti-Installer   │     │  - Reportes          │
│  - Métricas CPU/RAM │     │  - Multi-empresa     │
└─────────────────────┘     │  - Facturación       │
                             └──────────────────────┘

Stack tecnológico:
| Componente | Tecnología |
|------------|-----------|
| Agente Windows | C# .NET 8 / Newtonsoft.Json |
| Servidor API | Python 3.9+ / FastAPI / Uvicorn |
| Base de datos | PostgreSQL 15 |
| Panel web | Jinja2 / Bootstrap / HTML5 |
| Contenedor | Docker / docker-compose |
| Autenticación | Cookies + bcrypt + Passlib |


🔍 Análisis de Código

main.py (Servidor FastAPI) — ~27KB

Archivo monolítico — Toda la lógica del servidor está en un solo archivo (main.py de 27KB): modelos, rutas, lógica de negocio, DB, email, sesiones, etc. Esto escala mal.

Problemas identificados:

  1. Sesiones en memoria (SESSIONS = {}) — Se pierden al reiniciar el servidor. No escala horizontalmente. Un solo servidor caído = todos los usuarios desconectados.

  2. Conexiones DB sin pool — get_db() abre una conexión nueva cada vez sin connection pooling. En producción con N agentes haciendo heartbeat cada 60s, esto satura la DB.

  3. SQL Injection potencial en reglas — /api/reglas usa f'UPDATE equipos SET {col} = ...' con interpolación directa de tipo_bloqueo del usuario. Aunque hay un if col in [...], si se cambia esa lista o se envía otro valor, hay SQL injection.

  4. Error en conn.execute — En update_rules() usa conn.execute() sin cursor. El objeto de psycopg2 connection no tiene método execute(). Debería ser cursor = conn.cursor(); cursor.execute(). Esto lanza 500.

  5. init_db() sin cierre de conexiones — Retry loop abre conexiones sin cerrarlas. Si la DB no está lista, queda colgando conexiones.

  6. Forgot password sin token — Envía la contraseña temporal por email en texto plano y la guarda sin hash en la DB (usando temp_pass directamente sin hash_password).

  7. SMTP timeout — No hay timeout en el smtplib.SMTP(). Si el servidor SMTP no responde, el endpoint se cuelga para siempre.

  8. Falta rate limiting — No hay límites en login. Factible de brute force.

  9. CORS no configurado — No hay middleware CORS. Si el frontend se sirve desde otro dominio/origen, las peticiones serán bloqueadas.

  10. Credenciales hardcodeadas en .env — MASTER_KEY=dx-guard-secret-2024, DB password dxguard2024, usuario seed con pass 1234.

Worker.cs (Agente C#) — 326 líneas

  1. HttpClient sin reuso — Creado en el constructor como new HttpClient(). La documentación de Microsoft recomienda usar IHttpClientFactory para evitar socket exhaustion.

  2. PerformanceCounter obsoleto — PerformanceCounter está obsoleto en .NET 8/9. Se recomienda usar System.Diagnostics.Metrics o consultas WMI.

  3. AppDomain.CurrentDomain.BaseDirectory obsoleto — Usar AppContext.BaseDirectory.

  4. GetMacAddress ineficiente — Recorre todas las interfaces de red en cada heartbeat (cada 60 segundos). Debería cachearse al inicio.

  5. Anti-Install demasiado agresivo — Mata procesos que contengan "install", "setup", "msi", "wizard" en el título. Podría matar procesos legítimos (ej: "Visual Studio Installer", "Windows Update Setup").

  6. CheckAntiInstall sin Delay — Se ejecuta cada ciclo sin throttling. Podría saturar la CPU iterando todos los procesos sin pausa.

  7. Sin verificación de integridad — No se valida la firma del servidor ni el payload. Un MITM podría enviar reglas maliciosas.

  8. Logging sin límite — agent_log.txt crece indefinidamente sin rotación.

  9. Sin soporte IPv6 — GetMacAddress no filtra correctamente interfaces no Ethernet (WiFi, Bluetooth, VPNs).

General / DevOps

  1. Dockerfile ineficiente — Instala gcc y libpq-dev para compilar psycopg2, pero el requirements.txt usa psycopg2-binary que no necesita compilación. Se puede reducir el tamaño de la imagen quitando esos pasos.

  2. Multi-stage build — No hay. La imagen final lleva dependencias de compilación innecesarias.

  3. docker-compose expone DB — PostgreSQL expuesto en puerto 5433 al host. Las conexiones deberían ir por la red interna de Docker.

  4. Sin tests automatizados — El repositorio no tiene tests unitarios ni de integración.

  5. Instalador con contraseña hardcodeada — El .env en el repo contiene credenciales reales de la DB.



🐛 Bugs Reportados por Daniel

Bug #1: USB toggle no vuelve a activarse

Síntoma: Deshabilitar USB funciona, pero volverlo a habilitar no.

Causa raíz:

  1. conn.execute() no existe en psycopg2 — El endpoint /api/reglas usa:
    python conn.execute(f'UPDATE equipos SET {col} = %s WHERE mac_id = %s AND empresa_id = %s', ...)
    conn es un objeto psycopg2.connect(), no tiene método execute(). Debería ser cursor = conn.cursor(); cursor.execute(). Esto lanza un AttributeError 500 silencioso.

  2. El agente recibe 500 y no actualiza estado — Como el servidor responde con error, el agente no actualiza _usbLock y se queda congelado en el estado anterior.

Fix: cursor = conn.cursor(); cursor.execute(...) + try/except con logging.


Bug #2: Links agregados no se muestran ni funcionan

Síntoma: Agregar dominios desde el panel → no se ven en la vista y no se bloquean en PCs.

Causa raíz:

  1. No hay endpoint GET para listar dominios — Solo existen POST (crear) y DELETE. El panel no tiene forma de obtener la lista para mostrarla.
  2. Formato incompleto — Bloquea facebook.com pero no www.facebook.com. Navegadores modernos también usan DNS over HTTPS que bypassa el archivo hosts.
  3. Whitelist mal diseñada — Filtra por título de ventana (anti-install), no por URL.

Fix: Agregar GET /api/admin/domains y duplicar dominios con www.


Bug #3: Sistema de licencias confuso

Síntoma: No hay control de qué licencias están asignadas, cuántas quedan, quién las usa.

Problemas:
1. Licencia auto-generada sin control del admin
2. Sin endpoint para desactivar y liberar licencias
3. Sin historial de asignaciones
4. Sin expiración / renovación
5. Campo licencia_id muestra "PENDIENTE" confusamente

Fix propuesto: Nueva tabla licencias con: id, empresa_id, mac_id, activa, asignada_en, vence_en + endpoints CRUD.


💡 Mejoras Propuestas

🔴 Críticas (prioridad alta)

# Mejora Archivo Esfuerzo Impacto
1 Separar main.py en módulos (models/, routers/, services/) main.py 4h 🔥 Alta — mantenibilidad
2 Implementar connection pooling con psycopg2.pool o SQLAlchemy main.py 2h 🔥 Alta — rendimiento
3 Reemplazar SESSIONS{} por JWT o Redis main.py 3h 🔥 Alta — escalabilidad
4 Fix SQL injection en update_rules — usar parámetros seguros main.py 30min 🔥 Alta — seguridad
5 Fix conn.execute() sin cursor (500 error) main.py 15min 🔥 Alta — bug
6 Implementar IHttpClientFactory en agente C# Worker.cs 1h 🔥 Alta — estabilidad
7 Rate limiting en login main.py 1h 🟡 Media — seguridad

🟡 Medias

# Mejora Archivo Esfuerzo
8 Agregar timeout a SMTP (server.set timeout) main.py 15min
9 Hash de contraseña en forgot-password main.py 1h
10 Cachear MAC Address al inicio del agente Worker.cs 30min
11 Anti-Install: añadir whitelist de procesos del sistema Worker.cs 1h
12 Log rotation en agent_log.txt (máx 5MB) Worker.cs 30min
13 Tests básicos (pytest para API, xUnit para agente) — 4h
14 Dockerfile: eliminar dependencias innecesarias Dockerfile 15min
15 Configurar CORS middleware en FastAPI main.py 15min

🟢 Bajas / Cosmética

# Mejora Esfuerzo
16 AppContext.BaseDirectory en vez de AppDomain 5min
17 .env.example sin credenciales reales 5min
18 Multi-stage Docker build 1h
19 Documentación de API con Swagger/OpenAPI (FastAPI ya lo tiene integrado en /docs) 30min
20 Agregar .gitignore más completo (IDE, OS files) 5min

📊 Resumen

Métrica Valor
Archivos analizados 8 principales
Líneas de código ~2,800
Bugs críticos 2 (#5 SQL injection, #6 conn.execute)
Bugs funcionales 3 (#5, #6, #9 forgot-password)
Mejoras de seguridad 6
Mejoras de rendimiento 4
Mejoras de mantenibilidad 5
Total mejoras identificadas 20

Análisis generado por Nexus 🔗