Webhooks seguros en n8n usando autenticación por headers

Los webhooks son una herramienta poderosa para automatizar tareas entre aplicaciones, pero sin protección adecuada pueden convertirse en una puerta abierta para accesos no autorizados. En esta guía te muestro cómo configurar autenticación por headers directamente en n8n de forma sencilla y segura.

¿Por qué proteger un webhook?

Un webhook sin autenticación es como dejar la puerta de casa abierta: cualquiera puede enviar datos a tu sistema y ejecutar acciones no deseadas. La autenticación por headers es una forma eficaz y sencilla de controlar el acceso.

Paso 1: Configura tu webhook con autenticación

1. Añade un nodo Webhook a tu flujo en n8n.
2. Selecciona el método HTTP: Recomendamos POST para mayor seguridad.
3. En la sección «Authentication»: Selecciona Header Auth del desplegable.
4. Configura las credenciales: En «Credential for Header Auth», haz clic en «Create New» para crear nuevas credenciales.

Paso 2: Crea las credenciales de autenticación

Al crear las credenciales para Header Auth, necesitarás configurar:

• Name: El nombre del header personalizado (ejemplo: ziru)
• Value: El valor secreto que validará el acceso (ejemplo: clavedeprueba)

Guarda las credenciales con un nombre descriptivo como «Auth para webhooks» para identificarlas fácilmente.

Paso 3: Copia la URL del webhook

Una vez configurado, n8n te proporcionará una URL única para tu webhook. Esta URL será la que uses en tus integraciones externas. Ten en cuenta que son diferentes en test y en producción.

Paso 4: Prueba tu webhook seguro con curl

Para verificar que la autenticación funciona correctamente, prueba tu webhook desde la terminal:

Petición autorizada (funcionará):

curl -X POST "TU_WEBHOOK_URL" \
  -H "ziru: clavedeprueba" \
  -H "Content-Type: application/json" \
  -d '{"mensaje": "Hola desde curl autorizado"}'

Petición no autorizada (será rechazada):

curl -X POST "TU_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"mensaje": "Hola sin autorización"}'

La primera petición incluye el header ziru con el valor correcto clavedeprueba, por lo que n8n procesará el webhook normalmente. La segunda petición será rechazada automáticamente por n8n al no incluir las credenciales correctas.

Ventajas de este método

• Configuración simple: Todo se gestiona en el propio nodo webhook, sin necesidad de nodos adicionales.
• Seguridad automática: n8n se encarga de validar las credenciales antes de ejecutar el flujo.
• Gestión centralizada: Las credenciales se almacenan de forma segura en el sistema de credenciales de n8n.
• Reutilizable: Puedes usar las mismas credenciales en múltiples webhooks.

Buenas prácticas de seguridad

• Usa HTTPS: Siempre configura tu instancia de n8n con certificados SSL.
• Nombres de header únicos: Evita nombres comunes como «auth» o «token».
• Valores robustos: En producción, usa valores más complejos que clavedeprueba.
• Rotación regular: Cambia las credenciales periódicamente.
• Monitorización: Revisa los logs para detectar intentos de acceso no autorizado.

¿Necesitas más seguridad?

Para casos donde manejes datos especialmente sensibles, considera implementar autenticación HMAC, que añade verificación de integridad del payload. Sin embargo, para la mayoría de proyectos, la autenticación por headers es suficiente y mucho más sencilla de implementar.

¿Quieres aprender más sobre n8n?

Si buscas una guía completa, desde lo más básico hasta los trucos más avanzados, te recomiendo nuestra guía definitiva de n8n: Automatización para humanos. Incluye ejemplos, buenas prácticas y todo lo que necesitas para dominar la plataforma paso a paso.

Conclusión

Configurar webhooks seguros en n8n es más fácil de lo que parece. Con la autenticación por headers integrada, puedes proteger tus automatizaciones sin complicaciones técnicas. Recuerda siempre probar tu configuración antes de ponerla en producción.

Sobre el autor

«Ziru» somos un humano y una IA, colaborando para crear y compartir contenidos prácticos sobre automatización, IA y cultura digital. En eldiarioIA.es creemos en la tecnología útil, la seguridad práctica y el acceso libre al conocimiento. Todo lo que ves aquí es fruto de esa colaboración real entre persona y máquina.