Saltar al contenido principal

TEC-018 — Protección contra bots

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

Cierra el requerimiento REQ-SEC-11 (Seguridad, prioridad Alta) de la sección 6.2 Seguridad. Completa la capa anti-abuso del sistema (que ya tenía el rate limiting de TEC-005) con una defensa específicamente anti-bot y sin dependencias nuevas.


📋 Alcance​

RFEntregable
RF-TEC-018-01Detección y bloqueo (403) de bots por firma de User-Agent
RF-TEC-018-02Rutas señuelo (honeypot) y bloqueo temporal por IP
RF-TEC-018-03robots.txt, noindex y honeypot en el login
RF-TEC-018-04Resolución segura de la IP (trust proxy) frente a spoofing

⚙️ Cómo funciona​

Un middleware temprano (antes de Swagger y de las rutas) inspecciona cada petición:

  1. Si la IP está bloqueada → 403.
  2. Si la ruta es una trampa (/.env, /.git, /wp-login.php, /phpmyadmin, /actuator…) → 403.
  3. Si el User-Agent es de un bot/escáner conocido (sqlmap, curl, python-requests, headlesschrome, semrush, bytespider…) → 403.
  4. Tras 5 infracciones, la IP queda bloqueada 15 min.
curl -A "sqlmap/1.7" GET /api/productos → 403 (Acceso denegado a agentes automatizados)
curl GET /.env → 403 (Ruta no permitida)
navegador real GET /api/productos → 200

🔐 Decisiones de seguridad​

DecisiónPor qué
Defensa propia (sin captcha/WAF)Sin dependencias ni terceros; coherente con TEC-016/017
Responder 403 y no 429Distingue el bloqueo anti-bot del rate limiting (TEC-005)
Lista de UA conservadoraNo romper navegadores ni apps móviles (okhttp, React Native)
Middleware tempranoCubre también Swagger, 404 y estáticos

🖥️ API y Web​

  • API: src/common/seguridad/bots/ (constantes, config, detección, registro de bloqueos, middleware) + montaje y trust proxy en main.ts. Cada bloqueo se audita (BOT_BLOQUEADO).
  • Web: public/robots.txt (Disallow: /), noindex en app/layout.tsx y honeypot en el login.
  • Configuración: BOTS_PROTECCION, BOTS_UMBRAL_INFRACCIONES, BOTS_BLOQUEO_TTL_MS, BOTS_UA_PERMITIDOS, TRUST_PROXY.

🧪 Verificación​

PruebaResultado
npx tsc --noEmit (API y web)EXIT 0
npx jest src/common/seguridad --runInBand118/118 verde (10 suites)
curl -A "sqlmap/1.7" a /api/productos403
curl a /.env403
curl -A de navegador (con token)200

📎 Documentación​