Siete a Cloudflare Edge: Portelcore Contact Firewall
Architektúra serverless firewallu na okraji Cloudflare pre zmiernenie spamu a zabezpečenie kontaktného formulára.
V tomto dokumente podrobne popisujeme architektúru bezpečnosti, ktorú sme nasadili na hrane (edge network) našej siete pomocou Cloudflare Workers a súvisiacich služieb na ochranu a optimalizáciu kontaktného formulára a plánovania stretnutí Portelcore.
Architektúra Bezpečnosti na Okraji
Sección titulada «Arquitectura de Seguridad en el Borde»Exponovaná plocha kontaktného formulára je jedným z najbežnejších vektorov pre útoky denial-of-service aplikácií (Layer 7 DoS) a hromadné zasielanie nevyžiadanej pošty (Spam). Pre zmiernenie tohto rizika implementujeme trojvrstvovú validáciu pred spracovaním akýchkoľvek požiadaviek na našich backendových serveroch.
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 endKomponenty Systému
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Serverless Filter)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Nakonfigurovali sme Worker na ceste API kontaktného formulára pre zachytenie a predbežné spracovanie požiadaviek HTTP POST. Tým sa znižuje výpočtová záťaž na lokálnych serveroch dátového centra a blokuje sa škodlivý prenos priamo v globálnej distribučnej sieti Cloudflare.
- Výhody:
- Ultra-nízka latencia (distribuované vykonávanie v okrajových lokalitách).
- Bez potreby udržiavať dedikované proxy servery pre filtrovanie úrovne 7.
2. Integrácia s Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»Namiesto interaktívnych CAPTCHAs, ktoré komplikujú používateľskú skúsenosť, používame Turnstile na overenie platnosti klienta neviditeľným alebo nenápadným spôsobom pomocou telemetrických a prehliadačových výziev.
- Validácia na serveri: Pracovník overuje klientsku kľúč proti 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. Autentifikácia Stretnutí pomocou OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Pre požiadavky technických stretnutí, ktoré vyžadujú potvrdenie identity, Worker implementuje tok jedno použitia hesla (One-Time Password - OTP) zaslaný na e-mail žiadateľa.
- Stav OTP je dočasně uložen v Cloudflare KV s krátkým časem životnosti (Time-To-Live 5 minut).
- Tým sa zabezpečuje, že zadané e-mailové adresy sú platné a interaktívne zo strany legitímneho používateľa.
4. Integrácia s Cal.com a API Orchestration
Sección titulada «4. Integración con Cal.com y API de Orquestación»Jakmile je ověřena identita uživatele a překonány bezpečnostní výzvy, Worker bezpečně přesměruje požadavky na rezervaci do interní API Cal.com nebo do fronty technické podpory Portelcore, čímž zabrání automatizovaným fiktivním rezervacím v našich kalendářích.

