Redes e Cloudflare Edge: Portelcore Contact Firewall
Arquitetura de firewall de borda serverless na Cloudflare para mitigar spam e garantir o formulário de contato.
Neste documento detalhamos a arquitetura de segurança que hemos implantado na borda (edge network) de nossa rede utilizando Cloudflare Workers e serviços associados para proteger e otimizar o formulário de contato e agendamento de consultas de Portelcore.
Arquitetura de Segurança na Borda
Sección titulada «Arquitectura de Seguridad en el Borde»A superfície exposta do formulário de contato é um dos vetores mais comuns para ataques de negação de serviço de aplicação (Layer 7 DoS) e envios massivos de lixo eletrônico (Spam). Para mitigar este risco, implementamos uma validação em três camadas antes de processar qualquer solicitação em nossos 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 do Sistema
Sección titulada «Componentes del Sistema»1. Cloudflare Workers (Filtro Serverless)
Sección titulada «1. Cloudflare Workers (Filtro Serverless)»Configuramos um Worker na rota da API do formulário de contato para interceptar e pré-processar as requisições HTTP POST. Isso reduz a carga computacional dos servidores locais do data center e bloqueia o tráfego malicioso diretamente na rede de distribuição global da Cloudflare.
- Vantagens:
- Latência ultra-baixa (execução distribuída em localizações de borda).
- Sem a necessidade de manter servidores proxy dedicados para filtragem de nível 7.
2. Integração com Cloudflare Turnstile
Sección titulada «2. Integración con Cloudflare Turnstile»Em vez de CAPTCHAs interativos convencionais que dificultam a experiência do usuário, utilizamos Turnstile para verificar a validade do cliente de forma invisível ou não intrusiva, por meio de desafios de telemetria e comportamento do navegador.
- Validação no Servidor: O Worker valida a chave do cliente contra a 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. Autenticação de Agendamentos via OTP
Sección titulada «3. Autenticación de Citas mediante OTP»Para as solicitações de agendamentos técnicos que exijam confirmação de identidade, o Worker implementa um fluxo de senha de uso único (One-Time Password - OTP) enviado para o e-mail do solicitante.
- O estado do OTP é armazenado temporariamente no Cloudflare KV com um tempo de vida curto (Time-To-Live de 5 minutos).
- Isso garante que os e-mails inseridos no formulário são válidos e interativos por parte do usuário legítimo.
4. Integração com Cal.com e API de Orquestração
Sección titulada «4. Integración con Cal.com y API de Orquestación»Uma vez validada a identidade do usuário e superados os desafios de segurança, o Worker redireciona as solicitações de reserva de forma segura para a API interna do Cal.com ou para a fila de atendimento técnico da Portelcore, prevenindo reservas automatizadas fictícias em nossos calendários.

