Xarxes i Cloudflare Edge: Portelcore Contact Firewall
Arquitectura del firewall de perímetre serverless a Cloudflare per mitigar el spam i assegurar el formulari de contacte.
En aquest document detallem l'arquitectura de seguretat que hem desplegat a la vora (edge network) de la nostra xarxa utilitzant Cloudflare Workers i serveis associats per protegir i optimitzar el formulari de contacte i agendament de cites de Portelcore.
Arquitectura de Seguretat al Perímetre
Sección titulada «Arquitectura de Seguridad en el Borde»La superfície exposada del formulari de contacte és un dels vectors més habituals per a atacs de denegació de servei d'aplicació (Layer 7 DoS) i l'enviament masiu de correu brossa (Spam). Per mitigar aquest risc, implementem una validació en tres capes abans de processar qualsevol sol·licitud als nostres servidors backend.
sequenceDiagram actor Usuario as Cliente / Bot participant CF as 🛡️ Cloudflare Workers participant TS as 🤖 Cloudstile / Turnstile participant DB as 💾 Worker KV Cache participant API as ⚙️ Portelcore API / Cal.com
Usuario->>CF: Enviar solicitud de contacto / cita CF->>TS: Validar token de desafío Turnstile alt Desafío Fallido TS-->>CF: Token inválido / Bot detectado CF-->>Usuario: Bloqueo de solicitud (403 Forbidden) else Desafío Exitoso TS-->>CF: Token válido (Humano) CF->>DB: Verificar límites de rate-limiting (IP/Email) alt Límite Excedido DB-->>CF: IP sospechosa o rate limit alcanzado CF-->>Usuario: Error de límite (429 Too Many Requests) else Límite Correcto CF->>API: Canalizar solicitud (Envío OTP / Reserva Cal.com) API-->>Usuario: Confirmación y Token OTP enviado end endComponents del Sistema
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Filtre Serverless)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Hem configurat un Worker a la ruta de l'API del formulari de contacte per interceptar i preprocessar les sol·licituds HTTP POST. Això descarta la càrrega computacional dels servidors locals del centre de dades i bloqueja el trànsit maliciós directament a la xarxa de distribució global de Cloudflare.
- Avantatges:
- Latència ultra baixa (execució distribuïda en ubicacions de marge).
- Sense necessitat de mantenir servidors proxy dedicats per al filtrat de nivell 7.
2. Integració amb Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»En lloc de CAPTCHAs interactius convencionals que dificulten l'experiència d'usuari, utilitzem Turnstile per verificar la validesa del client de forma invisible o no intrusiva mitjançant reptes de telemetria i de comportament del navegador.
- Validació al Servidor: El Worker valida la clau del client contra l'API de Turnstile:
const response = await fetch('https://challenges.cloudflare.com/turnstile/v0/siteverify', {method: 'POST',body: JSON.stringify({ secret: SECRET_KEY, response: token }),headers: { 'Content-Type': 'application/json' }});
3. Autenticació de cites mitjançant OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Per a les sol·licituds de cites tècniques que requereixin confirmació d'identitat, el Worker implementa un flux de contrasenya d'ús únic (One-Time Password - OTP) enviat al correu electrònic del sol·licitant.
- L'estat de l'OTP s'emmagatzema temporalment a Cloudflare KV amb un temps de vida curt (Time-To-Live de 5 minuts).
- Això garanteix que els correus electrònics introduïts al formulari són vàlids i interactius per part de l'usuari legítim.
4. Integració amb Cal.com i l'API d'orquestació
Sección titulada «4. Integración con Cal.com y API de Orquestación»Un cop validada la identitat de l'usuari i superats els desafiaments de seguretat, el Worker redirigeix les sol·licituds de reserva de manera segura a l'API interna de Cal.com o a la cua d'atenció tècnica de Portelcore, evitant reserves automatitzades fictícies als nostres calendaris.

