Redes y Cloudflare Edge: Portelcore Contact Firewall
Arquitectura del firewall de borde serverless en Cloudflare para mitigar spam y asegurar el formulario de contacto.
En este documento detallamos la arquitectura de seguridad que hemos desplegado en el borde (edge network) de nuestra red utilizando Cloudflare Workers y servicios asociados para proteger y optimizar el formulario de contacto y agendamiento de citas de Portelcore.
Arquitectura de Seguridad en el Borde
Sección titulada «Arquitectura de Seguridad en el Borde»La superficie expuesta del formulario de contacto es uno de los vectores más habituales para ataques de denegación de servicio de aplicación (Layer 7 DoS) y envíos masivos de correo basura (Spam). Para mitigar este riesgo, implementamos una validación en tres capas antes de procesar cualquier solicitud en nuestros servidores 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 endComponentes del Sistema
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Filtro Serverless)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Hemos configurado un Worker en la ruta de la API del formulario de contacto para interceptar y pre-procesar las solicitudes HTTP POST. Esto descarga la carga computacional de los servidores locales del centro de datos y bloquea el tráfico malicioso directamente en la red de distribución global de Cloudflare.
- Ventajas:
- Latencia ultra-baja (ejecución distribuida en localizaciones de borde).
- Sin necesidad de mantener servidores proxy dedicados para filtrado de nivel 7.
2. Integración con Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»En lugar de CAPTCHAs interactivos convencionales que dificultan la experiencia de usuario, utilizamos Turnstile para verificar la validez del cliente de forma invisible o no intrusiva mediante desafíos de telemetría y comportamiento del navegador.
- Validación en Servidor: El Worker valida la clave del cliente contra la 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ón de Citas mediante OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Para las solicitudes de citas técnicas que requieran confirmación de identidad, el Worker implementa un flujo de contraseña de un solo uso (One-Time Password - OTP) enviado al correo del solicitante.
- El estado del OTP se almacena temporalmente en Cloudflare KV con un tiempo de vida corto (Time-To-Live de 5 minutos).
- Esto garantiza que los correos electrónicos ingresados en el formulario son válidos e interactivos por parte del usuario legítimo.
4. Integración con Cal.com y API de Orquestación
Sección titulada «4. Integración con Cal.com y API de Orquestación»Una vez validada la identidad del usuario y superados los desafíos de seguridad, el Worker redirige las solicitudes de reserva de manera segura a la API interna de Cal.com o a la cola de atención técnica de Portelcore, previniendo reservas automatizadas ficticias en nuestros calendarios.

