DX-Guard
- Producto: Disoftx · Registrado en Cerebro: 2026-09-21
- Qué es: SaaS de monitoreo y control de estaciones Windows para empresas. Bloqueo de USB (escritura), filtrado web (archivo hosts), bloqueo de instaladores, capturas de pantalla por demanda y métricas CPU/RAM. Multi-empresa (multi-tenant).
- Público: empresas que quieren controlar qué hacen sus empleados en las PCs.
- Estado: ✅ EN PRODUCCIÓN (servidor + panel). Agente v4.10. Puertos internos. Repo GitHub actualizado (
dannyelito/DX-Guard).
🔗 Links
- Panel / API (público): https://z-shield.disoftx.solutions
- Descarga del agente: https://z-shield.disoftx.solutions/download/agent
- Espejo: https://disoftx.solutions/descargas/DXGuard-Agent-v4.3.zip
- También:
/download/config.jsony/download/install.bat - Acceso al panel (SaaS master): empresa
master· usuarioditurrizaga· pass1234 - IP del servidor: 154.38.186.254 (Zeta)
- Repo (Zeta):
/home/opsmgr/proyectos/dx-guard(git)
🧩 Modelo multi-empresa (MUY IMPORTANTE)
master= SOLO el panel principal (SaaS). Desde ahí se crean los clientes y sus licencias. No es activable (no se le pueden vincular agentes).- Cada cliente es una empresa (con su RUC). Al crearla se le generan N licencias automáticamente (
limite_licencias). - Vía de activación (v4.3): el instalador pide el código de licencia → consulta al servidor → devuelve empresa + RUC → el instalador escribe
empresa_id→ el agente hace heartbeat y el servidor asigna una licencia disponible de esa empresa. - ⚠️ El agente v4.3 no envía el código de licencia (solo
empresa_id): la asignación es automática por empresa. (Mejora v4.4: que el agente lealicencia_codigoy la envíe, para fijar la licencia exacta.)
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)
- Contenedores:
dxguard-server(FastAPI, host9015→ contenedor8000) ydxguard-db(postgres:15, host5433→ 5432).restart: always. - Compose:
/home/opsmgr/proyectos/dx-guard/docker-compose.yml(bind.:/app; db en volumenpostgres_data). .env:DB_NAME=dxguard,DB_USER=dxadmin,DB_PASS=dxguard2024,MASTER_KEY=dx-gua…24.- Caddy:
/home/opsmgr/proyectos/caddy/Caddyfile→z-shield.disoftx.solutions { reverse_proxy 172.17.0.1:9015 }. - ⚠️
dxguard.disoftx.solutionsresuelve pero NO está servido (error SSL). No usar. - ⚠️ Seguridad pendiente: puertos 5433 y 9015 expuestos al host (podar/cerrar).
📥 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
- Códigos únicos
DXG-XXXXXXXX-XXXXXXXX(tablalicencias), estados disponible / asignada / revocada / vencida. - Se generan al crear la empresa (
limite_licencias) o desde el panel: Ajustes → Gestión de Licencias → +1. - Endpoints:
GET /api/licencias,POST /api/licencias/generar,POST /api/licencias/revocar,GET /api/licencias/list/{empresa_id}. - Heartbeat: si el equipo no tiene licencia activa, el servidor le asigna una disponible de su empresa; si ya está asignada a su MAC, sigue ACTIVA.
🛡️ 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
- 2026-05-25 — Análisis de código: fixes (
cursor.execute,GET /api/admin/domains, bloqueo dewww.) + 20 mejoras (vercoding/mejoras/DX-Guard.md). - 2026-07-16 — Revisión v4.2: 8 bugs + rediseño del sistema de licencias.
- 2026-07-29 — Agente v4.3 empaquetado.
- 2026-09-03 — FIX CRÍTICO (
7ca8f34): toggle de reglas (USB/web/install) fallaba con 500 (int vs boolean). - 2026-09-21 — Cerebro + descarga con
config.jsoncorregido (z-shield) +install.batincluido. - Nuevo endpoint
POST /api/agente/vincular(vinculación por licencia → empresa + RUC). masterbloqueado como activable en heartbeat (EMPRESA_NO_ACTIVABLE).- Creada empresa de prueba MOORE PERU ADVISORS SAC (
moore, RUC 20604625697). - Instalador con ventana (
Instalar-DXGuard.bat+instalar.ps1) reemplaza la edición manual del JSON. - 2026-09-22 (madrugada) — Agente v4.4 compilado y publicado (cross-compilado desde Linux con .NET SDK 8 en Omni):
- Fix USB:
StorageDevicePolicies\WriteProtect(época Windows 7) ya no lo aplica Windows 10/11 (confirmado:reg querymostrabaWriteProtect 0x1pero el USB seguía escribible; + hilo oficial de Microsoft). Nuevo método: políticaRemovableStorageDevices\Deny_Write=1+Set-Disk -IsReadOnly $truesobre discosBusType='USB'(se re-aplica cada heartbeat ~60s → cubre USB conectados después). - Licencia exacta: el agente ahora lee y envía
licencia_codigo(registroLicenciaCodigooconfig.json); el servidor la asigna si está disponible (si está en uso, cae al auto-asignado). - Descarga: https://z-shield.disoftx.solutions/download/agent (el endpoint ahora sirve el
DXGuard-Agent-*.zipmás nuevo). - Build:
dotnet publish -c Release -r win-x64 --self-contained -p:EnableWindowsTargeting=trueen/home/admin/dxguard_build(fuente copiada de Zeta). - 2026-09-22 (~01:45) — v4.5 + fixes de panel:
- Bug MAC vacío: el agente reportaba
mac_id=""(adaptadores virtuales/túnel devuelven MAC vacío) → fila "en blanco" en el panel y licencia asignada a un equipo sin MAC. v4.5 elige un MAC físico válido (12 hex) y si no, usa MachineGuid. - Bug política no se guardaba:
equipo_politicatiene PK compuesta(mac_id, politica_id)y elINSERT ... ON CONFLICT DO UPDATEsin target daba error en Postgres → no guardaba. Fix: índice único enmac_id+ON CONFLICT (mac_id);/api/equiposahora devuelvepolitica_idy el select queda seleccionado. - Gestión de Licencias: se quitaron los botones +1/+5/+10 (las empresas no se auto-generan licencias) → mensaje "escríbenos a daniel@disoftx.solutions". Los clientes se crean/gestionan desde master.
- Descarga: el endpoint sirve el zip más nuevo (v4.5).
- 2026-09-22 (madrugada, tanda 2 — antes de dormir Daniel) — Panel + funciones nuevas:
- Pestaña "Ayuda": guía de uso, instalación paso a paso, link de descarga del agente y tiempos de aplicación (agente 60s / panel 30s).
- Copiar licencia: ícono 📋 en cada fila de licencias.
- Desvincular (reemplaza "Revocar" en la UI): la licencia vuelve a
disponibley el equipo queda bloqueado (para que no la re-tome). - Kill switch: botones Bloquear/Reactivar por equipo (endpoint
/api/equipos/bloquear); el heartbeat de un equipo bloqueado devuelveBLOQUEADOy no recibe licencia ni reglas. Eliminar equipo (/api/equipos/eliminar) limpia el inventario y libera la licencia. - Reset de contraseña desde Central Maestro → Directorio de Clientes → 🔑 (
/api/master/usuario/password; vacío = genera automática). - Análisis → "Horas activas por equipo": calendario por día del mes (horas por equipo/empleado, con inicio–fin en tooltip y total). Endpoint
/api/productividad?desde&hasta. - Se quitó "Configuración de Marca" y "Servidor de Notificaciones (SMTP)" del panel (decisión Daniel).
- Fix: el selector de mes de Análisis mostraba
${...}literal (HTML roto) → ahora son<option>reales. - Backend: columna
equipos.bloqueado(migración idempotente); audit events nuevos yaudit_logtolerante (ya no rompe con eventos desconocidos). - Todos los endpoints probados con curl (bloquear→heartbeat BLOQUEADO→reactivar; productividad con datos; reset de clave).
- 2026-09-22 (madrugada, tanda 3) — Inventario + Alertas:
- Hardware de equipos: el agente v4.6 reporta modelo, N° de serie, disco (libre/total), arquitectura, IP local y usuario de Windows (columnas nuevas en
equipos). - Inventario de software: el agente lee el registro de desinstalación (HKLM 64/32 + HKCU), topa a 500, y lo envía cuando cambia o cada 24h. Tabla
equipos_software; endpointGET /api/equipos/detalle?mac_id=. - UI: botón 🖥️ en cada equipo → modal con Hardware + Software instalado (programa, versión, editor).
- Alertas en vivo:
notificar()con dedupe → tablanotificaciones(ya existente); alertas de equipo nuevo y equipo sin conexión (>10 min, chequeo cada 5 min); purga automática a 90 días (ALERT_RETENCION_DIAS). Estimado ≈ 3 MB/mes con 50 equipos. - Capturas de pantalla: DESCARTADAS por decisión de Daniel (no implementar).
- Agente v4.6 compilado y publicado;
/download/agentsirve el más nuevo. - Backup del backend:
main.py.bak-vinc-<TS>en Zeta. - 2026-09-22 (madrugada) — Fix "agregar licencias" no funcionaba: el botón master llamaba a
/api/licencias/generar(endpoint de empresa, que ignoraempresa_idy creaba las licencias bajo la empresa del token = master). Nuevo endpointPOST /api/master/empresa/licencias(solo master_admin){id, cantidad}que genera para la empresa objetivo y sincronizalimite_licencias; el JS detemplates/index.htmlahora lo usa.update-limitcorregido (no baja por debajo de las asignadas y sincroniza el límite). - Limpieza: se borraron 20 licencias basura creadas en master por los clicks fallidos → master queda 0 disponibles (coherente con "master no activable"). Backups:
main.py.bak-lic-<TS>. - 2026-09-22 (noche, tanda 3 — 20 mejoras + hardening) — Agente v4.10 + repo GitHub:
- Servidor (main.py): connection pool (
ThreadedConnectionPool1-20), CORS restringido ahttps://z-shield.disoftx.solutions, rate limiting en/login(10/5min por IP+usuario → 429), timeout SMTP (10s),update_rulescon mapa de columnas (anti-SQLi). (JWT, hash forgot-password y conn.execute ya estaban.) - Agente v4.10: rotación de logs (
agent_log.old.txta los 5 MB), cache de MAC,HttpClientestático,AppContext.BaseDirectory, y desbloqueo USB más robusto (borraDeny_Writeen vez de 0 + limpia readonly de todos los USB +Update-HostStorageCache) — respuesta al bug del permiso temporal de USB que no revertía. - Infra: puertos 5433 → 127.0.0.1 y 9015 → 172.17.0.1 (ya no públicos; Caddy sigue entrando).
.env,__pycache__y zips fuera del repo (git rm --cached+ .gitignore).Dockerfileoptimizado (sin gcc/libpq-dev) +requirements.txtpineado (versiones reales del contenedor) +.dockerignore. - Tests:
tests/test_smoke.py(pytest). Docs:docs/MEJORAS.mdcon las 20 mejoras y estado. - GitHub (repo
dannyelito/DX-Guard, ramamain): commitaf75a3e+ merge8464545(se integró la línea remota v4.3 por historial, conservando el código actual). Push OK. - ⏳ Pendientes de las 20: #1 modularizar main.py, #18 multi-stage build, ampliar tests. + instalador .exe único (al final).
- 2026-09-22 (noche, tanda 2 — panel) — Mejoras de panel + Agente v4.9:
- Permiso temporal para USB/WEB/INSTALL: generalizado el de INSTALL. Columnas
usb_hasta,web_hasta(+ la ya existenteinstalar_hasta); endpointPOST /api/equipos/regla-temporal{mac_id,tipo,minutos}; en el heartbeat las 3 reglas respetan su ventana. UI: clic en cualquier candado → modal 5/15/30/60 min; candado naranja con cuenta atrás. - Sync rápido (Agente v4.9): nuevo endpoint público
POST /api/agente/sync(solo reglas) + el agente lo consulta cada 10 s → los cambios (dominios, reglas, cerrar navegadores) se aplican en ≤10 s sin esperar el latido de 60 s.ApplyConfig()factorizado. - UI de dominios: chips con contador, entrada normalizada (quita
https://), Enter para añadir, y refresco del inventario al cambiar. Aviso "se aplica en ~10 s". - Placeholders: color claro (
#cbd5e1) sobre el fondo oscuro (antes gris ilegible). - SMTP eliminado: quitadas las referencias JS colgantes (
updateSmtpConfig,updateCompanyLogo,config-logo-url,smtp-*) que rompíanloadBranding. - Ayuda reescrita (uso, no implementación): interruptores USB/WEB/INSTALL, permiso temporal, políticas, ⊘ cerrar navegadores, tiempos (≤10 s / panel 30 s), análisis, licencias.
- Zip v4.9 publicado;
/download/agentsirve v4.9. Backups:*.bak-panel2-*,Worker.cs.bak-v49-*. - 2026-09-22 (noche) — Agente v4.8 — bloqueo web por políticas de navegador (URLBlocklist) (pedido Daniel, tras pruebas del 4.7).
- Motivo: el bloqueo por
hostsse salta con la caché/Service Worker de un perfil ya abierto (probado: perfil limpio bloquea, perfil normal no). - Agente v4.8: al aplicar el bloqueo web escribe en el registro (HKLM) las políticas
URLBlocklistde Chrome, Edge, Brave (+ Opera best-effort), y en FirefoxWebsiteFilter(*://*.dominio/*) + desactiva DoH (DnsOverHttpsMode=off/DNSOverHTTPS {Enabled:false}). Al desactivar el bloqueo web, las quita. Bloquea a nivel URL dentro del navegador → inmune a caché/Service Worker y a DoH. - ⚠️ Requiere reiniciar el navegador una vez para tomar la política. No requiere reiniciar la PC.
- ⚠️ Opera tiene soporte limitado de políticas de empresa → puede no aplicar; Chrome/Edge/Firefox sí.
- Verificación:
chrome://policy(Chrome/Edge). Pendiente: probar en la PC (Daniel). - Botón "Cerrar navegadores" (mismo v4.8): en Acciones del inventario → cierra Chrome/Edge/Firefox/Opera/Brave/Vivaldi de esa PC (orden puntual vía heartbeat
cerrar_navegadores, columnaequipos.cmd_cerrar_navegadores, se consume 1 vez). Alternativa recomendada al reinicio de PC. - 2026-09-22 (noche, fixes) — Timezone + spam de alertas: la base estaba en UTC (la app en
America/Lima) → las notificaciones salían 5 h desfasadas →ALTER DATABASE dxguard SET timezone TO 'America/Lima'. Y la alerta "equipo sin conexión" llevaba los minutos en el mensaje (cambiaban) → el dedupe nunca coincidía → avisaba cada 5 min; ahora el mensaje es estable (minutos en el título) → 1 aviso por equipo / 12 h. Backups:main.py.bak-tznotif-*. - 2026-09-22 (tarde, tanda 3) — Agente v4.7 + Modo Mantenimiento + bloqueo de instaladores Nivel 2 (pedido Daniel).
- Causa raíz del INSTALL que no bloqueaba (diagnosticada con Daniel): el agente corre como servicio (sesión 0) →
MainWindowTitlede las apps del usuario llega vacío → el chequeo viejo caía al nombre del .exe y solo mataba si el .exe se llamabasetup/install(prueba: renombrar asetup_test.exe→Instalador bloqueado: setup_test). - Agente v4.7 — anti-install Nivel 2 (reescrito): ya no usa títulos de ventana. Decide por nombre del ejecutable (
install, setup, wizard, uninstall, unins, msiexec, installer) y por RUTA: bloquea ejecutables que corran desde\Users\*\Downloads,\Users\*\Desktop,\Users\*\AppData\Local\Temp,\Windows\Temp,\Users\Public\Downloadsy unidades extraíbles (USB), firmados o no. Nunca toca Windows ni Program Files. Respeta la whitelist por empresa. Corre en hilo aparte cada 2 s (ya no cada 60 s). Al bloquear, notifica al panel (POST /api/agente/instalacion-bloqueada→ alertainstalacion_bloqueada). - Modo mantenimiento (desbloqueo temporal por equipo): nuevo endpoint
POST /api/equipos/instalar-temporal{mac_id, minutos}(0 = bloquear ya). Columna nuevaequipos.instalar_hasta(migración idempotente). En el heartbeat, si hay ventana activa →install=false(se permite instalar aunque la política lo bloquee); al expirar se re-bloquea solo. UI: clic en el candado INSTALL (aunque el equipo esté gobernado por política) abre modal con 5/15/30/60 min; se muestra candado naranja + cuenta mientras dura. - Probado: endpoint + heartbeat (install true → mantenimiento 5min → false → revocar → true) +
instalar_hastaen/api/equipos. Build:dotnet publishv4.7; zipDXGuard-Agent-v4.7.zippublicado (el endpoint ya sirve v4.7). Backups:Worker.cs.bak-*,main.py.bak-insttemp-*,index.html.bak-insttemp-*. - Pendiente menor: probar el v4.7 en la PC (Daniel reinstala) y validar que no afecte actualizaciones legítimas (SUNAT/SISCONT) → ahí entra whitelist/mantenimiento.
- 2026-09-22 (tarde, tanda 2) — Editar políticas desde el panel (pedido por Daniel): la pestaña Ajustes → Políticas por Grupo solo permitía crear/eliminar.
- Nuevo endpoint
PUT /api/politicas/{pid}(actualiza nombre + reglas, filtrando porempresa_id; 404 si no es de la empresa; auditaPOLITICA_EDITAR). - UI: botón ✏️ Editar en cada fila → abre el mismo modal precargado (título "Editar Política" / botón "Guardar cambios");
savePolitica()hace PUT si edita, POST si crea. Al guardar refresca equipos (los iconos reflejan la nueva política). - Backups:
main.py.bak-poledit-*/index.html.bak-poledit-*. Probado con curl (crear→editar→leer→404 en id inexistente→borrar). - 2026-09-22 (tarde) — Fix: los iconos USB/WEB/INSTALL no reflejaban la política asignada (reportado por Daniel: política "Total" = todo bloqueado, asignada a
DESKTOP-2I4IC1I, pero el panel mostraba candados abiertos verdes). - Causa: el endpoint
/api/equiposdevolvíaequipos.bloqueo_usb/web/install, que siguen enfalse(la asignación de política no copia sus valores a la tablaequipos). Pero el agente sí aplicaba la política (en el heartbeat la política tiene prioridad → el bloqueo real estaba activo; solo el panel lo pintaba mal). - Fix (backend):
/api/equiposahora haceLEFT JOIN politicasy devuelve el estado efectivoef_usb/ef_web/ef_install+politica_nombre+reglas_por_politica(misma precedencia que el agente). - Fix (frontend):
toggleBtn()usa el estado efectivo; cuando el equipo está gobernado por una política, el candado se muestra como bloqueado y no clickeable con tooltip («Controlado por la política X...»). Así no se puede "hacer clic sin efecto". - Backups:
main.py.bak-fixicon-*/templates/index.html.bak-fixicon-*. Contenedordxguard-serverreiniciado. Verificado por SQL (ef_* = t/t/tpara DESKTOP-2I4IC1I) y por HTTP (endpoint devuelve los campos nuevos). - 2026-09-21 (noche) — Fix visual del panel: el CSS no definía
--bs-table-color, así que Bootstrap 5.3 pintaba las celdas con--bs-body-color(negro) → los nombres de las empresas se veían negros sobre fondo oscuro. Se agregó--bs-table-color:var(--text-main)en.table+ las utilidades.text-main/.text-dim/.text-muted(no existían). Afecta a todas las tablas del panel. Backup:templates/index.html.bak-<TS>.
⏳ 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).
- ✅ 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 enGET /download/blocklist/adult(76.769 dominios, fuente StevenBlack porn-only). El agente la descarga (cache local%ProgramData%\DXGuard\adult_block.txt) y la aplica porhosts(# DX-Guard Adult) + desactiva DoH. ⚠️ Requiere agente v4.11. - ✅ Análisis por conexión (bloques del día) — nueva tabla
sesiones(inicio–fin; hueco >5 min = nueva sesión)./api/productividadahora devuelvesesiones; nueva sección “🕒 Conexiones (bloques) del período” en Análisis. Funciona con cualquier agente (solo servidor). - ✅ Historial de uso de navegadores (por equipo + general) —
POST /api/agente/navegacion+ tablanavegacion. El agente v4.11 lee elHistory(SQLite) de Chrome/Edge/Brave/Opera/Vivaldi yplaces.sqlitede 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. - ✅ Razón social
moore→ MPA (UPDATEempresas.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)
- ✅ Bloqueo web reforzado (v4.8): por
hosts+ políticasURLBlocklist(Chrome/Edge/Brave) +WebsiteFilter(Firefox) + DoH off. Inmune a caché/Service Worker (elhostssolo no bastaba). Opera: best-effort (soporte limitado). Pendiente: verificar en la PC (chrome://policy). - ✅ Kill switch por equipo — HECHO (2026-09-22 noche): botones Bloquear/Reactivar (
/api/equipos/bloquear); el heartbeat de un equipo bloqueado devuelveBLOQUEADOy no recibe licencia ni reglas. + Eliminar equipo (/api/equipos/eliminar). - 🔴 Probar el bloqueo USB con el agente v4.4/v4.5 en Windows (copiar al USB debe fallar).
- ✅ 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.
- ✅ "Revocar" → "Desvincular" — hecho: la licencia vuelve a
disponibley solo se desvincula del equipo (no se invalida el código). - ✅ Limpiar inventario — hecho: botón "Eliminar equipo" (
/api/equipos/eliminar) libera la licencia y limpia el inventario. - ✅ Quitar "Configuración de Marca" — hecho (y SMTP ocultado, decisión Daniel 22/09).
- ✅ 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 enC:\Program Files\DX-Guardy abre el asistente de licencia. EndpointGET /download/setup(https://z-shield.disoftx.solutions/download/setup). Fuente eninstaller/(commite80d0d1, pusheado). - 🟡 Backlog 20 mejoras — HECHAS: connection pooling, CORS, rate limiting, timeout SMTP, anti-SQLi en reglas,
IHttpClientFactory(agente),tests/test_smoke.py. PENDIENTES: modularizarmain.py(sigue monolítico, ~1611 líneas) + ampliar tests + multi-stage build (#18). - 🟡 Seguridad Zeta — puertos ✅ cerrados (5433→127.0.0.1, 9015→172.17.0.1; verificado 2026-09-23). ⚠️ PENDIENTE: el
git remotedel 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). - ✅ 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”.
- 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 conhosts+URLBlocklist(mecanismo que ya existe). Toggle por empresa/política/equipo. A tener en cuenta: tamaño (miles de dominios) y rendimiento deURLBlocklist; alternativa ligera: bloqueo por palabras clave (*porn*,*xxx*,*adult*). Fuentes free: oisd (porn), StevenBlack. MVP: lista adulta media + toggle; luego más categorías. - 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: tablasesiones(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). - 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: tablanavegacion; UI: lista por equipo (modal 🖥️) + vista general. ⚠️ Privacidad: monitoreo laboral avisado. Alternativa ligera: registrar solo los intentos bloqueados. - ✅ 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
- SMTP: sirve para los correos de bienvenida (al crear empresa) y recuperación de contraseña; si la empresa no configura su SMTP, usa el global (
smtp.stackmail.com). Decidir si se deja o se oculta. (Ocultado en el panel 22/09.)
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)
- Regla base: guardar eventos (no telemetría continua). Un evento = fila de ~200 bytes.
- Volumen real estimado (50 equipos × ~10 eventos/día) ≈ 500/día → ~15.000/mes → ~3 MB/mes. Trivial.
- Lo que SÍ infla: (a) capturas (50 eq × 1/5min ≈ 14.400 imágenes/día ≈ ~0,5–1 GB/mes), (b) registrar cada heartbeat (72.000 filas/mes, aún manejable), (c) timeline app-por-segundo.
- Diseño a implementar: eventos con throttle/dedupe, retención 90 días para eventos crudos, agregados diarios (ya existe
actividad_diaria) que se conservan siempre, capturas como archivos (no BLOB) con cuota y retención (ej. 30 días), y cron de purga + VACUUM.
📎 Ver también
- Análisis de código y 20 mejoras:
coding/mejoras/DX-Guard.md - Cambios v4.11 (changelog):
docs/CAMBIOS-v4.11.md(repodannyelito/DX-Guard) - Regenerar la lista de bloqueo de adultos:
scripts/update_blocklist.sh(repo DX-Guard) - Infra Zeta (puertos, UFW):
wiki/bitacora/2026-08-18.md