TEC-018 — Protección contra bots
· 2 min de lectura
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
| RF | Entregable |
|---|---|
| RF-TEC-018-01 | Detección y bloqueo (403) de bots por firma de User-Agent |
| RF-TEC-018-02 | Rutas señuelo (honeypot) y bloqueo temporal por IP |
| RF-TEC-018-03 | robots.txt, noindex y honeypot en el login |
| RF-TEC-018-04 | Resolució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:
- Si la IP está bloqueada → 403.
- Si la ruta es una trampa (
/.env,/.git,/wp-login.php,/phpmyadmin,/actuator…) → 403. - Si el User-Agent es de un bot/escáner conocido (
sqlmap,curl,python-requests,headlesschrome,semrush,bytespider…) → 403. - 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ón | Por qué |
|---|---|
| Defensa propia (sin captcha/WAF) | Sin dependencias ni terceros; coherente con TEC-016/017 |
| Responder 403 y no 429 | Distingue el bloqueo anti-bot del rate limiting (TEC-005) |
| Lista de UA conservadora | No romper navegadores ni apps móviles (okhttp, React Native) |
| Middleware temprano | Cubre también Swagger, 404 y estáticos |
🖥️ API y Web
- API:
src/common/seguridad/bots/(constantes, config, detección, registro de bloqueos, middleware) + montaje ytrust proxyenmain.ts. Cada bloqueo se audita (BOT_BLOQUEADO). - Web:
public/robots.txt(Disallow: /),noindexenapp/layout.tsxy honeypot en el login. - Configuración:
BOTS_PROTECCION,BOTS_UMBRAL_INFRACCIONES,BOTS_BLOQUEO_TTL_MS,BOTS_UA_PERMITIDOS,TRUST_PROXY.
🧪 Verificación
| Prueba | Resultado |
|---|---|
npx tsc --noEmit (API y web) | EXIT 0 |
npx jest src/common/seguridad --runInBand | 118/118 verde (10 suites) |
curl -A "sqlmap/1.7" a /api/productos | 403 |
curl a /.env | 403 |
curl -A de navegador (con token) | 200 |
📎 Documentación
- Especificación: TEC-018: Protección contra Bots
- Manual de operación: Protección contra bots
- Capa anti-abuso base: TEC-005
- Requerimiento:
docs/mejoras-propuestas-almacen.md§6.2 (REQ-SEC-11)
