REQ-SEC-18 — Gestión y liberación de IPs bloqueadas
· 2 min de lectura
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ón | Entregable |
|---|---|
| Gestionar y liberar las IPs bloqueadas | Pestaña «Bloqueadas» + POST /api/seguridad/ips/bloqueadas/liberar |
| Panel de IPs de confianza | Pestaña «Confianza» en /seguridad-ips |
| Agregar y validar la información de las IPs | Diálogo de alta con «Validar y consultar información» |
| Consultar la información con la API de SurosV4 | Proxy 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ón031), además del registro en memoria que aplica el bloqueo en caliente. Liberar levanta el bloqueo de inmediato y marca las filas vigentes comoLIBERADA. - 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
| Pieza | Rol |
|---|---|
database/migrations/031_create_ips_confianza_y_bloqueadas.sql | Tablas 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.ts | Exención de IPs de confianza |
components/security/seguridad-ips-panel.tsx | Panel de gestión (2 pestañas) |
Sin dependencias nuevas: se reutiliza el
fetchnativo 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.tsy casos nuevos enbots.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).tscEXIT 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
tscy quedan para CI con Node ≥ 24.
📚 Documentación
- Spec: REQ-SEC-18: Gestión y liberación de IPs bloqueadas
- Manual: Gestión de IPs bloqueadas y de confianza
- Anti-bots base: TEC-018: Protección contra Bots
