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

  1. Por qué un webhook es una puerta
  2. Los seis fallos que vemos
  3. Cinco capas de defensa
  4. Checklist de 10 puntos
  5. Cómo lo probamos

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

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

#ControlPor qué importa
1Autenticación activada en el nodo WebhookSin ella, la URL es la única barrera.
2Secreto fuera de la URLLas URLs se registran y se filtran.
3Credenciales dedicadas y rotablesPermite revocar sin romper todo.
4Firma HMAC si el emisor la ofreceGarantiza origen e integridad.
5Solo POST y tamaño limitadoReduce superficie y abuso.
6Esquema de payload validadoEvita datos corruptos en el CRM.
7Rate limit en el edgeFrena fuerza bruta y bucles.
8Respuestas genéricasNo regala pistas al que prueba.
9Logs sin secretos ni PIIEl log no debe ser una nueva brecha.
10Test y producción separadosEvita escrituras en el entorno equivocado.

Cómo lo probamos

Con autorización escrita sobre el sistema, la batería mínima es:

Este artículo describe pruebas sobre sistemas propios o con autorización escrita. No es una invitación a probar infraestructura de terceros.

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óstico

Guía relacionada: así es un informe de auditoría por dentro.