Saltar al contenido principal

REQ-SEC-18 — Gestión y liberación de IPs bloqueadas

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación del requerimiento REQ-SEC-18 (Gestión y liberación de IPs bloqueadas), dentro de Seguridad y con prioridad Media. Hasta ahora el bloqueo por IP del anti-bots (TEC-018) era en memoria y sin panel, y no existía lista de IPs de confianza.


📋 Alcance​

Criterio de aceptaciónEntregable
Gestionar y liberar las IPs bloqueadasPestaña «Bloqueadas» + POST /api/seguridad/ips/bloqueadas/liberar
Panel de IPs de confianzaPestaña «Confianza» en /seguridad-ips
Agregar y validar la información de las IPsDiálogo de alta con «Validar y consultar información»
Consultar la información con la API de SurosV4Proxy GET /api/seguridad/ips/info/:ip → api.ipquery.io

⚙️ Cómo funciona​

  • Bloqueos persistentes: cada bloqueo efectivo del anti-bots se guarda en ips_bloqueadas (migración 031), además del registro en memoria que aplica el bloqueo en caliente. Liberar levanta el bloqueo de inmediato y marca las filas vigentes como LIBERADA.
  • IPs de confianza: alta/baja con ips_confianza; la lista se cachea en memoria y exime a la IP del anti-bots, del reCAPTCHA y del límite de tasa.
  • Información de la IP: al agregar (y al ver el detalle) se consulta https://api.ipquery.io/{ip} desde el API (proxy), con timeout y degradación con gracia.

🧩 Detalles de implementación​

PiezaRol
database/migrations/031_create_ips_confianza_y_bloqueadas.sqlTablas ips_confianza / ips_bloqueadas
domains/seguridad-ips/Servicio, lista de confianza, proxy de info, controlador y DTOs
common/seguridad/bots/Providers + callbacks esConfiable / alBloquear
throttler.guard.ts / recaptcha.guard.tsExención de IPs de confianza
components/security/seguridad-ips-panel.tsxPanel de gestión (2 pestañas)

Sin dependencias nuevas: se reutiliza el fetch nativo del API (como en los webhooks) y axios ya presente en la web.

🧪 Pruebas​

  • API: seguridad-ips.service.spec.ts, ip-info.service.spec.ts, lista-confianza.service.spec.ts y casos nuevos en bots.middleware.spec.ts (esConfiable / alBloquear).
  • Web: src/components/__tests__/seguridad-ips.test.tsx — 3 casos (listado, liberar con confirmación y alta con validación). tsc EXIT 0 en API y web.

Nota de entorno: la suite Jest del API no corre en este entorno (Node v22.22.3; NestJS 12 es ESM y Jest exige Node ≥ 24.9). Los specs compilan con tsc y quedan para CI con Node ≥ 24.

📚 Documentación​