🔗 Nexus

← Volver a notas
29 KB 23/09/2026 14:31
🔗

DX-Guard

🔗 Links

🧩 Modelo multi-empresa (MUY IMPORTANTE)

Clientes creados

Empresa (id) Nombre RUC Licencias
moore MOORE PERU ADVISORS SOCIEDAD ANONIMA 20604625697 5 (disponibles)
master SaaS Master Control — panel, no activable

🏗️ Arquitectura

Agente Windows (C# .NET 8 Worker)  →  Servidor Core (Python FastAPI)  →  PostgreSQL 15
- Bloqueo USB (registro)              - Heartbeat API                    - multi-empresa
- Bloqueo web (hosts)                 - Reglas dinámicas / licencias     - licencias
- Anti-installer                      - Reportes / capturas
- Métricas CPU/RAM                    - Vinculación del agente
Componente Tecnología
Agente Windows C# .NET 8 (DXGuardAgent.exe, ~85 MB self-contained)
Servidor API Python 3 / FastAPI / Uvicorn
Base de datos PostgreSQL 15
Panel web Jinja2 / Bootstrap
Contenedor Docker / docker-compose

Config del agente (precedencia): 1º Registro HKLM\SOFTWARE\DXGuard (ServerUrl, EmpresaId) → 2º config.json junto al .exe. Si existe el registro, el JSON se ignora.

🖥️ Infraestructura (Zeta)

📥 Instalación del agente (v4.4)

1. Descargar: https://z-shield.disoftx.solutions/download/agent

2. Descomprimir todo en una carpeta. Contenido: DXGuardAgent.exe, Instalar-DXGuard.bat, instalar.ps1, install.bat, config.json, LEEME.txt.

3. Click derecho en Instalar-DXGuard.bat → "Ejecutar como administrador".
Se abre una ventana que pide el código de licencia:
- Pega el código → "Vincular" → muestra Empresa + RUC (confirma que sea la correcta).
- "Instalar y activar" → escribe registro + config.json, crea e inicia el servicio DXGuardAgent.

Instalación manual (alternativa): editar config.json (server_url + empresa_id + licencia_codigo) y ejecutar install.bat como admin.
Comandos sueltos:

sc create DXGuardAgent binPath= "C:\Program Files\DX-Guard\DXGuardAgent.exe" start= auto
sc start DXGuardAgent

Logs del agente: %ProgramData%\DXGuard\agent_log.txt

🔌 Endpoint de vinculación

POST /api/agente/vincular (público, sin sesión) · body {"licencia":"DXG-XXXXXXXX-XXXXXXXX"}
- ✅ 200 → { status, empresa_id, nombre, ruc, estado }
- 403 si la licencia es de master ("no activable") o la empresa está suspendida · 404 licencia inválida · 410 revocada · 429 rate limit (10/min por IP).

🔑 Licencias

🛡️ Antivirus

El agente no tiene firma digital comercial → Windows Defender puede marcarlo. Agregar exclusión de carpeta (ej. C:\Program Files\DX-Guard\). En Kaspersky/otros: confiar en DXGuardAgent.exe y permitir salida hacia 154.38.186.254.

🗄️ Base de datos (tablas)

empresas, usuarios, equipos, licencias, politicas, equipo_politica, dominios_prohibidos, whitelist, actividad_diaria, notificaciones, audit_log.

📜 Historial

⏳ Pendientes

🆕 Pedidos del cliente Moore/MPA — IMPLEMENTADOS (2026-09-23)

Reunión del 23/09. Los 4 puntos están desarrollados y en producción (agente v4.11).

  1. ✅ Bloqueo de contenido para adultos — toggle por empresa (POST /api/config/adulto, en Ajustes → Restricciones Globales) y por política (politicas.bloqueo_adulto). Lista de categoría en GET /download/blocklist/adult (76.769 dominios, fuente StevenBlack porn-only). El agente la descarga (cache local %ProgramData%\DXGuard\adult_block.txt) y la aplica por hosts (# DX-Guard Adult) + desactiva DoH. ⚠️ Requiere agente v4.11.
  2. ✅ Análisis por conexión (bloques del día) — nueva tabla sesiones (inicio–fin; hueco >5 min = nueva sesión). /api/productividad ahora devuelve sesiones; nueva sección “🕒 Conexiones (bloques) del período” en Análisis. Funciona con cualquier agente (solo servidor).
  3. ✅ Historial de uso de navegadores (por equipo + general) — POST /api/agente/navegacion + tabla navegacion. El agente v4.11 lee el History (SQLite) de Chrome/Edge/Brave/Opera/Vivaldi y places.sqlite de Firefox (últimas 24 h, top dominios) y lo reporta cada ~15 min. UI: “🌐 Navegación (7 días)” en el detalle 🖥️ del equipo + “🌐 Uso de navegadores (general)” en Análisis. ⚠️ Requiere agente v4.11.
  4. ✅ Razón social moore → MPA (UPDATE empresas.nombre).

Extra: optimización del agente para no reescribir hosts/políticas si nada cambió (firma), importante con 76k dominios.

Backlog acordado con Daniel (2026-09-22)

  1. ✅ Bloqueo web reforzado (v4.8): por hosts + políticas URLBlocklist (Chrome/Edge/Brave) + WebsiteFilter (Firefox) + DoH off. Inmune a caché/Service Worker (el hosts solo no bastaba). Opera: best-effort (soporte limitado). Pendiente: verificar en la PC (chrome://policy).
  2. ✅ Kill switch por equipo — HECHO (2026-09-22 noche): botones Bloquear/Reactivar (/api/equipos/bloquear); el heartbeat de un equipo bloqueado devuelve BLOQUEADO y no recibe licencia ni reglas. + Eliminar equipo (/api/equipos/eliminar).
  3. 🔴 Probar el bloqueo USB con el agente v4.4/v4.5 en Windows (copiar al USB debe fallar).
  4. ✅ Bloqueo de instaladores — rediseñado en v4.7 (Nivel 2): decisión por nombre + ruta (no títulos de ventana, que no se ven desde el servicio), hilo aparte cada 2 s, notifica al panel, + whitelist por empresa y modo mantenimiento (desbloquear INSTALL por X min desde el inventario). Pendiente: probarlo con actualizaciones reales (SUNAT/SISCONT) y ajustar whitelist.
  5. ✅ "Revocar" → "Desvincular" — hecho: la licencia vuelve a disponible y solo se desvincula del equipo (no se invalida el código).
  6. ✅ Limpiar inventario — hecho: botón "Eliminar equipo" (/api/equipos/eliminar) libera la licencia y limpia el inventario.
  7. ✅ Quitar "Configuración de Marca" — hecho (y SMTP ocultado, decisión Daniel 22/09).
  8. ✅ Instalador en UN SOLO .exe — HECHO 2026-09-22 22:10: DXGuard-Setup.exe (C# .NET8, ~14 MB, manifiesto requireAdministrator) descarga el agente más reciente, instala en C:\Program Files\DX-Guard y abre el asistente de licencia. Endpoint GET /download/setup (https://z-shield.disoftx.solutions/download/setup). Fuente en installer/ (commit e80d0d1, pusheado).
  9. 🟡 Backlog 20 mejoras — HECHAS: connection pooling, CORS, rate limiting, timeout SMTP, anti-SQLi en reglas, IHttpClientFactory (agente), tests/test_smoke.py. PENDIENTES: modularizar main.py (sigue monolítico, ~1611 líneas) + ampliar tests + multi-stage build (#18).
  10. 🟡 Seguridad Zeta — puertos ✅ cerrados (5433→127.0.0.1, 9015→172.17.0.1; verificado 2026-09-23). ⚠️ PENDIENTE: el git remote del repo dx-guard sigue con un token de GitHub embebido en la URL (https://…:…@github.com/…) → rotar el token y sacarlo del remote (pasar a SSH o credential helper).
  11. ✅ CORS restringido, timeout SMTP, rotación de logs del agente (v4.10).

🆕 Pedidos reunión Moore Perú Advisors (2026-09-23)

Los apuntó Daniel en la reunión con el cliente. ✅ Los 4 desarrollados (2026-09-23, agente v4.11). Ver “Pedidos del cliente Moore/MPA — IMPLEMENTADOS”.

  1. Bloqueo de contenido inapropiado (¿porn?) — ✅ HECHO. Enfoque: listas de dominios por categoría alojadas en el servidor (ej. GET /download/blocklist/adult) que el agente descarga y mezcla con hosts + URLBlocklist (mecanismo que ya existe). Toggle por empresa/política/equipo. A tener en cuenta: tamaño (miles de dominios) y rendimiento de URLBlocklist; alternativa ligera: bloqueo por palabras clave (*porn*, *xxx*, *adult*). Fuentes free: oisd (porn), StevenBlack. MVP: lista adulta media + toggle; luego más categorías.
  2. Análisis — mostrar cada conexión (bloque) del día. Hoy actividad_diaria = 1 fila/día (primera_visto…ultimo_visto, minutos=contador) → solo se ve la última sesión (ej. Daniel ayer se conectó 3 veces y salió 1). Fix: tabla sesiones (mac_id, empresa_id, inicio, fin, minutos); en cada heartbeat se abre/cierra sesión según hueco (>5 min) o fin de actividad. Análisis lista las sesiones del día. Solo backend + panel (no toca el agente).
  3. Historial de uso de navegadores (por equipo + general). Requiere agente v4.11: leer el History (SQLite) de Chrome/Edge/Firefox → enviar dominios + horas (o top-dominios por intervalo). Server: tabla navegacion; UI: lista por equipo (modal 🖥️) + vista general. ⚠️ Privacidad: monitoreo laboral avisado. Alternativa ligera: registrar solo los intentos bloqueados.
  4. ✅ Cambiar razón social Moore Perú Advisors → MPA — HECHO 2026-09-23 (UPDATE empresas SET nombre='MPA' WHERE id='moore'). Pendiente menor: agregar "Editar empresa" en el panel master (hoy solo se crea).

Preguntas abiertas

Ideas de la competencia (features a considerar)

Revisado software similar (Syteca, ManageEngine Device Control Plus, AccessPatrol, ActivTrak, DeskTime, Kickidler, CleverControl, MonitUp, StaffCounter). Ideas aplicables a DX-Guard:
- Inventario de software instalado por equipo (y detectar pirata/no autorizado). ✅ hecho (v4.6)
- Hardware de los equipos (CPU, RAM, disco, serial, marca/modelo, MAC/IP). ✅ hecho (v4.6)
- Capturas de pantalla: ❌ NO implementar (decisión Daniel 22/09).
- Control USB granular: solo-lectura, permitir por dispositivo, alerta al conectar USB.
- Productividad: marcar apps/sitios como productivos/improductivos + puntaje; línea de tiempo de actividad (app por hora).
- Alertas en vivo: USB conectado, instalación bloqueada, equipo offline, intento de acceso a dominio prohibido. (offline y equipo nuevo ya hechos)
- Reportes programados por correo (diario/semanal).
- Políticas por departamento/grupo (ya hay políticas por grupo).
- Modo mantenimiento (permitir instalar X min), bloqueo de copiado (DLP).

📏 Alertas en vivo — tamaño del log (diseño)

📎 Ver también