Netwerken en Cloudflare Edge: Portelcore Contact Firewall
Serverless edge-firewallarchitectuur in Cloudflare om spam te mitigeren en het contactformulier te beveiligen.
In dit document beschrijven we de beveiligingsarchitectuur die we hebben uitgerold aan de rand (edge network) van ons netwerk met behulp van Cloudflare Workers en bijbehorende diensten om het contact- en afsprakenformulier van Portelcore te beschermen en te optimaliseren.
Edge-beveiligingsarchitectuur
Sección titulada «Arquitectura de Seguridad en el Borde»Het blootgestelde oppervlak van het contactformulier is een van de meest voorkomende vectoren voor application denial-of-service-aanvallen (Layer 7 DoS) en massale spamverzendingen. Om dit risico te beperken, hebben we een drielaagse validatie geïmplementeerd voordat verzoeken op onze backend-servers worden verwerkt.
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 endSysteemcomponenten
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Serverless Filter)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»We hebben een Worker geconfigureerd op het API-pad van het contactformulier om HTTP POST-verzoeken te onderscheppen en voor te verwerken. Dit ontlast de lokale servers van het datacenter en blokkeert kwaadaardig verkeer direct in het wereldwijde distributienetwerk van Cloudflare.
- Voordelen:
- Ultra-lage latentie (gedistribueerde uitvoering op edge-locaties).
- Geen noodzaak voor het onderhouden van dedicated proxy-servers voor filtering op laag 7.
2. Integratie met Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»In plaats van conventionele interactieve CAPTCHA's die de gebruikerservaring bemoeilijken, gebruiken we Turnstile om de geldigheid van de client onzichtbaar of niet-intrusief te verifiëren via telemetrie-uitdagingen en browsergedrag.
- Servervalidatie: de worker valideert de client-sleutel tegen de Turnstile-API:
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. Afspraakauthenticatie via OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Voor technische afspraakverzoeken die identiteitsbevestiging vereisen, implementeert de Worker een 'one-time password' (OTP) workflow die naar het e-mailadres van de aanvrager wordt verzonden.
- De OTP-status wordt tijdelijk opgeslagen in Cloudflare KV met een korte levensduur (Time-To-Live van 5 minuten).
- Dit garandeert dat de e-mailadressen die in het formulier worden ingevoerd, geldig zijn en dat de legitieme gebruiker hiermee kan interageren.
4. Integratie met Cal.com en Orchestration API
Sección titulada «4. Integración con Cal.com y API de Orquestación»Zodra de identiteit van de gebruiker is gevalideerd en de beveiligingsuitdagingen zijn doorstaan, leidt de Worker de reserveringsverzoeken veilig om naar de interne API van Cal.com of de technische ondersteuningswachtrij van Portelcore, waardoor fictieve geautomatiseerde reserveringen in onze agenda's worden voorkomen.

