Netzwerke und Cloudflare Edge: Portelcore Contact Firewall
Serverless Edge-Firewall-Architektur in Cloudflare zur Spam-Mitigierung und Absicherung des Kontaktformulars.
In diesem Dokument beschreiben wir die Sicherheitsarchitektur, die wir am Edge (edge network) unseres Netzwerks unter Verwendung von Cloudflare Workers und zugehörigen Diensten implementiert haben, um das Kontakt- und Terminbuchungsformular von Portelcore zu schützen und zu optimieren.
Sicherheitsarchitektur am Edge
Sección titulada «Arquitectura de Seguridad en el Borde»Die Angriffsfläche des Kontaktformulars ist einer der häufigsten Vektoren für Application Layer Denial-of-Service-Angriffe (Layer 7 DoS) und Spam-Massensendungen. Um dieses Risiko zu minimieren, haben wir eine dreistufige Validierung implementiert, bevor Anfragen auf unseren Backend-Servern verarbeitet werden.
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 endSystemkomponenten
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Serverless-Filter)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Wir haben einen Worker auf dem API-Pfad des Kontaktformulars konfiguriert, um HTTP-POST-Anfragen abzufangen und vorzuverarbeiten. Dies entlastet die lokalen Server des Rechenzentrums von der Rechenlast und blockiert bösartigen Datenverkehr direkt im globalen Verteilungsnetzwerk von Cloudflare.
- Vorteile:
- Ultra-niedrige Latenz (verteilte Ausführung an Edge-Standorten).
- Ohne die Notwendigkeit, dedizierte Proxy-Server für die Layer-7-Filterung zu betreiben.
2. Integration mit Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»Anstelle von interaktiven herkömmlichen CAPTCHAs, die die Benutzererfahrung erschweren, verwenden wir Turnstile, um die Gültigkeit des Clients auf eine unsichtbare oder nicht aufdringliche Weise durch Telemetrie- und Browserverhaltensherausforderungen zu überprüfen.
- Server-Validierung: Der Worker validiert den Clientschlüssel gegen die API von 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. Termin-Authentifizierung mittels OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Für technische Terminanfragen, die eine Identitätsbestätigung erfordern, implementiert der Worker einen Einmalpasswort-Fluss (One-Time Password - OTP), der an die E-Mail-Adresse des Antragstellers gesendet wird.
- Der OTP-Status wird vorübergehend in Cloudflare KV mit einer kurzen Lebensdauer (Time-To-Live von 5 Minuten) gespeichert.
- Dies stellt sicher, dass die im Formular eingegebenen E-Mail-Adressen gültig sind und eine Interaktion des legitimen Benutzers erfordern.
4. Integration mit Cal.com und Orchestrierungs-API
Sección titulada «4. Integración con Cal.com y API de Orquestación»Sobald die Benutzeridentität validiert und die Sicherheitsherausforderungen überwunden wurden, leitet der Worker die Buchungsanfragen sicher an die interne API von Cal.com oder an die technische Warteschlange von Portelcore weiter, wodurch automatisierte Scheinbuchungen in unseren Kalendern verhindert werden.

