Clase 04 · Módulo 07
Validación y protección contra spam
Validación y protección contra spam
Qué logras en esta clase
Tu formulario rechaza datos inválidos y frena a los bots antes de que lleguen a tu tabla.
- Separas la validación que ayuda de la que protege.
- Combinas tres defensas contra el spam.
- Integras Turnstile y verificas su respuesta en el servidor.
02
Cortesía y protección
La validación en el navegador es una cortesía con quien escribe. La del servidor es la única que protege.
03
Dos validaciones, dos trabajos
| En el navegador | En el servidor | |
|---|---|---|
| Para qué | Avisar al instante | Decidir qué se acepta |
| Se puede saltar | Sí | No |
| Es obligatoria | No, pero ayuda | Sí |
Necesitas las dos. La primera mejora la experiencia. La segunda es la que cuenta.
04
La validación del navegador
<input name="email" type="email" required maxlength="120" />Con esos atributos el navegador revisa solo: required exige un valor, type="email" exige forma de correo y maxlength limita el largo. Si algo falla, muestra un aviso y no envía.
No requiere JavaScript y funciona en todos los navegadores actuales.
05
Por qué no alcanza
La documentación de Astro lo dice claro: cada action es una dirección pública, con la forma /_actions/nombre.
Cualquiera puede llamarla directo con un programa, sin pasar por tu formulario ni por sus atributos. Un bot no abre tu página: le habla a esa dirección.
06
La validación del servidor
input: z.object({
nombre: z.string().min(2).max(80),
email: z.email(),
mensaje: z.string().min(10).max(2000),
}),Este esquema vive dentro de la action. Zod es la biblioteca de validación que Astro incluye. Si un dato no cumple, la action responde con un error y tu código de guardado nunca se ejecuta.
07
Qué se valida en cada campo
| Regla | Ejemplo |
|---|---|
| Presencia | El mensaje no viene vacío |
| Formato | El correo tiene forma de correo |
| Largo mínimo y máximo | Entre 10 y 2.000 caracteres |
| Valores permitidos | El motivo es uno de la lista |
08
Errores que ayudan a corregir
Astro entrega los errores de validación separados por campo. Con eso tu formulario puede:
- Mostrar cada mensaje junto al campo que falló.
- Conservar lo que la persona ya escribió.
- Decir cómo corregirlo: «Escribe al menos 10 caracteres».
09
Quién manda spam
Programas automáticos recorren la web buscando formularios y los llenan con enlaces o publicidad. No eligen tu sitio: prueban todos.
Las consecuencias para ti:
- Tu bandeja y tu tabla se llenan de basura.
- Gastas la cuota de correos de tu plan.
- Los mensajes reales se pierden entre el ruido.
10
Capas baratas, una sobre otra
Ninguna defensa sola frena todo. Se combinan varias capas simples, cada una atrapa lo que la anterior deja pasar.
11
Capa 1: el campo trampa
<input name="sitio_web" tabindex="-1" autocomplete="off" />Es un campo extra, oculto con CSS, que una persona nunca ve ni llena. Muchos bots completan todo lo que encuentran. Si ese campo llega con contenido, el servidor descarta el envío. En inglés se llama honeypot.
Límite: los bots más elaborados lo detectan. Pide que quede oculto también para lectores de pantalla.
12
Capa 2: límite de envíos
Nadie real envía veinte mensajes en un minuto. Un límite por tiempo corta las ráfagas.
Formas de aplicarlo:
- Reglas del alojamiento, si tu plan las ofrece. Compruébalo en su documentación.
- Lógica en la action: rechazar si el mismo correo ya escribió hace instantes.
Lo malo: un límite muy estricto bloquea a personas reales que comparten red.
13
Capa 3: Turnstile
Turnstile es el desafío antibots de Cloudflare, una alternativa al CAPTCHA de imágenes. Entrega un comprobante, llamado token, que tu servidor valida antes de aceptar el envío.
Su plan gratis incluye hasta 20 widgets por cuenta, 10 dominios por widget y verificaciones sin tope.
14
Turnstile en tu página
- Crea un widget en el panel de Cloudflare. Recibes una clave de sitio, pública, y una clave secreta.
- Carga su script desde la dirección oficial.
- Pon el widget dentro del formulario.
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
<div class="cf-turnstile" data-sitekey="TU_CLAVE_DE_SITIO"></div>Al estar dentro del form, agrega solo un campo oculto llamado cf-turnstile-response con el token.
15
Turnstile en tu servidor
La action envía una petición POST a esta dirección, con dos datos: secret, tu clave secreta, y response, el token recibido.
https://challenges.cloudflare.com/turnstile/v0/siteverifyLa respuesta trae un campo success. Solo si es verdadero el envío continúa. Cloudflare indica que esta comprobación es obligatoria: sin ella, el widget no protege nada.
16
Un token dura poco y sirve una vez
Cada token vence a los 5 minutos y está pensado para una sola validación. Si falla el envío, hay que generar otro.
17
El orden de las comprobaciones
Primero lo más barato de revisar. Guardar va al final: nada llega a tu tabla sin pasar por todo lo anterior.
18
Las tres capas, comparadas
| Capa | Molestia para la persona | Qué frena |
|---|---|---|
| Campo trampa | Ninguna | Bots simples |
| Límite de envíos | Ninguna, salvo abuso | Ráfagas |
| Turnstile | Baja | Bots que simulan un navegador |
Para una web chica, parte con las dos primeras. Suma Turnstile si el spam igual pasa o si tu formulario dispara correos a terceros.
19
Cómo responderle a un bot
| Caso | Respuesta |
|---|---|
| Campo trampa lleno | Aparentar éxito y no guardar |
| Token inválido o vencido | Pedir que lo intente de nuevo |
| Campos inválidos | Error por campo |
Al bot no le das pistas de qué lo delató. A la persona, que puede fallar por un token vencido, siempre le das una salida.
20
Probar las defensas
- Envía el formulario normal: debe guardar.
- Llena el campo trampa desde las herramientas del navegador: no debe guardar.
- Pídele a Claude que llame a la action sin token: debe rechazar.
- Deja la página abierta más de 5 minutos y envía: debe pedir reintento, no perder el texto.
21
Dos errores frecuentes
El segundo: cargar el script de Turnstile desde una copia propia. Cloudflare pide usar la dirección exacta, porque una copia deja de funcionar cuando lo actualizan.
22
Lo que te llevas
- El navegador valida para ayudar; el servidor valida para proteger.
- Una action es una dirección pública: se puede llamar sin pasar por tu formulario.
- Campo trampa, límite de envíos y Turnstile se combinan.
- El token de Turnstile se verifica siempre en el servidor, dura 5 minutos y sirve una vez.
- Guardar es el último paso de la cadena.
23
Hazlo ahora
En 15 minutos:
- Define el largo mínimo y máximo de cada campo de tu formulario.
- Pídele a Claude el esquema de validación y el campo trampa, en modo plan.
- Revisa en el diff que la comprobación del campo trampa ocurre en el servidor.
- Haz las dos primeras pruebas de la lista y confirma el resultado en tu tabla.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026