Reti e Cloudflare Edge: Portelcore Contact Firewall
Architettura del firewall edge serverless in Cloudflare per mitigare lo spam e proteggere il modulo di contatto.
In questo documento dettagliamo l'architettura di sicurezza che abbiamo distribuito sul bordo (edge network) della nostra rete utilizzando Cloudflare Workers e servizi associati per proteggere e ottimizzare il modulo di contatto e la pianificazione degli appuntamenti di Portelcore.
Architettura di Sicurezza Edge
Sección titulada «Arquitectura de Seguridad en el Borde»La superficie esposta del modulo di contatto è uno dei vettori più comuni per attacchi di Denial of Service applicativo (Layer 7 DoS) e invii massivi di posta indesiderata (Spam). Per mitigare questo rischio, abbiamo implementato una validazione a tre livelli prima di elaborare qualsiasi richiesta sui nostri server 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 endComponenti del sistema
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Filtro Serverless)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Abbiamo configurato un Worker nel percorso dell'API del modulo di contatto per intercettare e pre-elaborare le richieste HTTP POST. Ciò scarica il carico computazionale dai server locali del data center e blocca il traffico malevolo direttamente sulla rete di distribuzione globale di Cloudflare.
- Vantaggi:
- Latenza ultra-bassa (esecuzione distribuita in località edge).
- Nessuna necessità di mantenere server proxy dedicati per il filtraggio di livello 7.
2. Integrazione con Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»Invece di utilizzare CAPTCHAs interattivi convenzionali che complicano l'esperienza dell'utente, utilizziamo Turnstile per verificare la validità del client in modo invisibile o non invasivo tramite sfide di telemetria e comportamento del browser.
- Validazione sul server: Il Worker valida la chiave del client contro l'API di 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. Autenticazione degli appuntamenti tramite OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Per le richieste di appuntamenti tecnici che richiedono la conferma dell'identità, il Worker implementa un flusso di password monouso (One-Time Password - OTP) inviato all'e-mail del richiedente.
- Lo stato dell'OTP viene memorizzato temporaneamente in Cloudflare KV con un tempo di vita breve (Time-To-Live di 5 minuti).
- Questo garantisce che gli indirizzi email inseriti nel modulo siano validi e che vi sia un'interazione da parte dell'utente legittimo.
4. Integrazione con Cal.com e API di orchestrazione
Sección titulada «4. Integración con Cal.com y API de Orquestación»Una volta validata l'identità dell'utente e superate le sfide di sicurezza, il Worker reindirizza le richieste di prenotazione in modo sicuro all'API interna di Cal.com o alla coda di assistenza tecnica di Portelcore, prevenendo prenotazioni automatizzate false nei nostri calendari.

