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
- 🔲 Bug #1 — Verificar que al toggle USB desde el panel, el agente recibe el cambio y aplica/remueve el registry
- 🔲 Bug #2 — Verificar que los dominios agregados aparecen en el panel y se bloquean en el navegador
- 🔲 Bug #3 — Sistema de licencias (pendiente de diseñar)
📋 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
- Agente Windows (C# .NET 8) — Servicio que se ejecuta en cada PC del empleado
- Servidor Core (Python/FastAPI) — API REST + PostgreSQL
- 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:
-
Sesiones en memoria (
SESSIONS = {}) — Se pierden al reiniciar el servidor. No escala horizontalmente. Un solo servidor caído = todos los usuarios desconectados. -
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. -
SQL Injection potencial en reglas —
/api/reglasusaf'UPDATE equipos SET {col} = ...'con interpolación directa detipo_bloqueodel usuario. Aunque hay unif col in [...], si se cambia esa lista o se envía otro valor, hay SQL injection. -
Error en conn.execute — En
update_rules()usaconn.execute()sin cursor. El objeto de psycopg2 connection no tiene método execute(). Debería sercursor = conn.cursor(); cursor.execute(). Esto lanza 500. -
init_db() sin cierre de conexiones — Retry loop abre conexiones sin cerrarlas. Si la DB no está lista, queda colgando conexiones.
-
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_passdirectamente sinhash_password). -
SMTP timeout — No hay timeout en el
smtplib.SMTP(). Si el servidor SMTP no responde, el endpoint se cuelga para siempre. -
Falta rate limiting — No hay límites en login. Factible de brute force.
-
CORS no configurado — No hay middleware CORS. Si el frontend se sirve desde otro dominio/origen, las peticiones serán bloqueadas.
-
Credenciales hardcodeadas en .env —
MASTER_KEY=dx-guard-secret-2024, DB passworddxguard2024, usuario seed con pass1234.
Worker.cs (Agente C#) — 326 líneas
-
HttpClientsin reuso — Creado en el constructor comonew HttpClient(). La documentación de Microsoft recomienda usarIHttpClientFactorypara evitar socket exhaustion. -
PerformanceCounter obsoleto —
PerformanceCounterestá obsoleto en .NET 8/9. Se recomienda usarSystem.Diagnostics.Metricso consultas WMI. -
AppDomain.CurrentDomain.BaseDirectoryobsoleto — UsarAppContext.BaseDirectory. -
GetMacAddress ineficiente — Recorre todas las interfaces de red en cada heartbeat (cada 60 segundos). Debería cachearse al inicio.
-
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").
-
CheckAntiInstall sin Delay — Se ejecuta cada ciclo sin throttling. Podría saturar la CPU iterando todos los procesos sin pausa.
-
Sin verificación de integridad — No se valida la firma del servidor ni el payload. Un MITM podría enviar reglas maliciosas.
-
Logging sin límite —
agent_log.txtcrece indefinidamente sin rotación. -
Sin soporte IPv6 —
GetMacAddressno filtra correctamente interfaces no Ethernet (WiFi, Bluetooth, VPNs).
General / DevOps
-
Dockerfile ineficiente — Instala
gccylibpq-devpara compilar psycopg2, pero el requirements.txt usapsycopg2-binaryque no necesita compilación. Se puede reducir el tamaño de la imagen quitando esos pasos. -
Multi-stage build — No hay. La imagen final lleva dependencias de compilación innecesarias.
-
docker-compose expone DB — PostgreSQL expuesto en puerto
5433al host. Las conexiones deberían ir por la red interna de Docker. -
Sin tests automatizados — El repositorio no tiene tests unitarios ni de integración.
-
Instalador con contraseña hardcodeada — El
.enven 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:
-
conn.execute()no existe en psycopg2 — El endpoint/api/reglasusa:
python conn.execute(f'UPDATE equipos SET {col} = %s WHERE mac_id = %s AND empresa_id = %s', ...)
connes un objetopsycopg2.connect(), no tiene métodoexecute(). Debería sercursor = conn.cursor(); cursor.execute(). Esto lanza unAttributeError 500silencioso. -
El agente recibe 500 y no actualiza estado — Como el servidor responde con error, el agente no actualiza
_usbLocky 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:
- No hay endpoint GET para listar dominios — Solo existen POST (crear) y DELETE. El panel no tiene forma de obtener la lista para mostrarla.
- Formato incompleto — Bloquea
facebook.compero nowww.facebook.com. Navegadores modernos también usan DNS over HTTPS que bypassa el archivo hosts. - 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 🔗