Ir al contenido

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.

0lectures

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.

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
end

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.

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.