Ir al contenido

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.

0lecturas

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.

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
end

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.

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.