Seguridad de automatizaciones
Cómo asegurar un webhook de n8n expuesto
Un webhook es la puerta de entrada de tu automatización. Si no tiene autenticación, cualquiera que conozca la URL puede ejecutar tu flujo, consumir tu cuota o meter datos falsos en tu CRM. Así se cierra.
Contenido
Por qué un webhook es una puerta
n8n pone la automatización al alcance de cualquier pyme. Un flujo que escucha un formulario, crea una factura o avisa a un comercial es útil desde el primer día. El problema es que el webhook que lo activa es, por defecto, una URL pública que acepta peticiones.
No hace falta un atacante sofisticado. Basta con que la URL aparezca en un repositorio, en una captura de pantalla, en los logs de un proxy o en el historial de un navegador compartido. A partir de ahí, cualquiera puede enviar el mismo JSON que envía tu formulario.
La URL del webhook no es un secreto. Es una dirección. La autenticación es la cerradura.
Los seis fallos que vemos
1. Webhook sin autenticación
Es el más común. El nodo Webhook de n8n permite autenticación por cabecera o básica, pero viene desactivada. Si el flujo solo comprueba el cuerpo del JSON, cualquiera puede invocarlo.
2. Secreto en la query string
Añadir ?token=abc123 a la URL parece una solución rápida. El problema es que las
URLs se registran en access logs, proxies, historiales y herramientas de analítica. Un secreto
en la URL se filtra por diseño.
3. CORS abierto
Si el webhook se llama desde el navegador, un Access-Control-Allow-Origin: *
permite que cualquier web lo invoque con las credenciales del visitante. Para integraciones
servidor a servidor, CORS no debería estar abierto en absoluto.
4. Sin límite de peticiones
Un webhook sin rate limit es una forma barata de consumir tu cuota de n8n, llenar tu base de datos o provocar errores en cascada. No hace falta un ataque: un formulario mal configurado puede generar el mismo efecto.
5. Respuestas que filtran internals
Devolver el error completo de la base de datos o la traza del nodo es cómodo para depurar y muy útil para quien está probando qué acepta tu flujo. La respuesta debe ser genérica; el detalle va al log interno.
6. Confiar en el payload
Que el JSON venga de tu formulario no significa que sea válido. Campos obligatorios, tipos, longitudes, importes y estados deben validarse en el flujo antes de escribir en el CRM o disparar un pago.
Cinco capas de defensa
Capa 1 · Autenticación en el nodo Webhook
En n8n, abre el nodo Webhook y activa Authentication → Header Auth. Crea una
credencial con un nombre de cabecera, por ejemplo X-API-Key, y un valor aleatorio
de al menos 32 bytes. El emisor debe enviar esa cabecera en cada petición.
Si el emisor no puede enviar cabeceras personalizadas, usa Basic Auth y credenciales dedicadas. Nunca reutilices la contraseña de un usuario real.
Capa 2 · Firma HMAC cuando el emisor la soporta
Stripe, GitHub, Shopify y muchos SaaS firman sus webhooks con HMAC-SHA256. Si es tu caso, verifica la firma antes de que el payload llegue a n8n. La forma más limpia es un pequeño Worker en Cloudflare que valida y reenvía.
function hexToBytes(hex) {
return new Uint8Array(hex.match(/.{1,2}/g).map((b) => parseInt(b, 16)));
}
export default {
async fetch(request, env) {
if (request.method !== 'POST') {
return new Response('Method Not Allowed', { status: 405 });
}
const raw = await request.text();
const signature = request.headers.get('x-signature') ?? '';
if (!/^[0-9a-f]{64}$/i.test(signature)) {
return new Response('Unauthorized', { status: 401 });
}
const key = await crypto.subtle.importKey(
'raw',
new TextEncoder().encode(env.WEBHOOK_SECRET),
{ name: 'HMAC', hash: 'SHA-256' },
false,
['verify']
);
const valid = await crypto.subtle.verify(
'HMAC',
key,
hexToBytes(signature),
new TextEncoder().encode(raw)
);
if (!valid) return new Response('Unauthorized', { status: 401 });
return fetch(env.N8N_WEBHOOK_URL, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: raw
});
}
};
El secreto vive en la variable de entorno del Worker, no en el flujo de n8n ni en el código. Si el emisor incluye una marca de tiempo, compruébala y rechaza peticiones con más de cinco minutos para evitar reenvíos.
Capa 3 · Secretos fuera del workflow
Las credenciales de n8n se cifran con N8N_ENCRYPTION_KEY. Esa clave debe estar
respaldada: si se pierde, las credenciales no se recuperan. No exportes workflows con secretos
incrustados ni los subas a un repositorio, aunque sea privado.
Separa siempre el entorno de pruebas del de producción. El webhook de test de n8n y el de producción son URLs distintas; publicar la de test en un formulario es un error silencioso que llena la tabla equivocada.
Capa 4 · Límites y validación
- Método: acepta solo
POST. RechazaGETcon 405. - Tamaño: limita el cuerpo a lo que esperas. Un formulario normal no necesita 10 MB.
- Esquema: valida campos obligatorios, tipos y longitudes antes de escribir.
- Rate limit: en Cloudflare, una regla de 30 peticiones por minuto y por IP es un buen punto de partida.
- Origen: si el emisor tiene IP fija, añade una allowlist. Si no la tiene, no la inventes.
Capa 5 · Observabilidad sin filtrar datos
Registra método, ruta, código de respuesta, latencia, IP y un identificador de ejecución. No registres cabeceras de autorización, tokens ni el payload completo si contiene datos personales. Configura una alerta cuando aumenten los 401, los 429 o los 5xx: un pico de rechazos puede ser un escaneo, y un pico de aceptaciones puede ser abuso.
Checklist de 10 puntos
| # | Control | Por qué importa |
|---|---|---|
| 1 | Autenticación activada en el nodo Webhook | Sin ella, la URL es la única barrera. |
| 2 | Secreto fuera de la URL | Las URLs se registran y se filtran. |
| 3 | Credenciales dedicadas y rotables | Permite revocar sin romper todo. |
| 4 | Firma HMAC si el emisor la ofrece | Garantiza origen e integridad. |
| 5 | Solo POST y tamaño limitado | Reduce superficie y abuso. |
| 6 | Esquema de payload validado | Evita datos corruptos en el CRM. |
| 7 | Rate limit en el edge | Frena fuerza bruta y bucles. |
| 8 | Respuestas genéricas | No regala pistas al que prueba. |
| 9 | Logs sin secretos ni PII | El log no debe ser una nueva brecha. |
| 10 | Test y producción separados | Evita escrituras en el entorno equivocado. |
Cómo lo probamos
Con autorización escrita sobre el sistema, la batería mínima es:
- Petición sin cabecera de autenticación → debe devolver 401.
- Petición con secreto incorrecto → 401, sin distinguir del caso anterior.
- Petición con firma HMAC manipulada → 401.
- Reenvío de una petición válida antigua → rechazo si hay control de timestamp.
- Petición con cuerpo sobredimensionado → 413.
- Método GET → 405.
- Ráfaga de peticiones → 429 antes de degradar el flujo.
- Revisión de logs: ni secretos ni datos personales en claro.
Diagnóstico gratuito
¿Tienes un webhook de n8n en producción?
Revisamos la superficie expuesta de tu automatización, las credenciales y los flujos críticos. Te entregamos un informe con prioridades y un presupuesto cerrado en 72 horas.
Solicitar diagnósticoGuía relacionada: así es un informe de auditoría por dentro.