Recursos · Integración n8n

Integración JWT n8nAutomatiza JWT con n8n.

¿Tu flujo tiene que hablar con un servicio que solo acepta tokens firmados? La integración JWT n8n lo resuelve con un nodo y 3 operaciones: decodificar, firmar y verificar. La clave vive en un credential que creas una vez y el nodo la usa en cada ejecución.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué hace de verdad la integración JWT n8n?

JWT viene de JSON Web Token, el formato que describe la RFC 7519. En n8n, la integración JWT n8n cabe en un solo nodo: 3 operaciones sobre 1 recurso para firmar un token, verificarlo o leer lo que lleva dentro. Todo ocurre entre ese nodo y un credential JWT, donde se guardan la clave y el algoritmo.

Empecemos por lo habitual: un flujo programado tiene que llamar a un servicio que solo acepta una aserción firmada. Sign a JWT arma ese token justo antes de la llamada. Rellenas Expires In, la vida del token en segundos, indicas el destinatario en Audience y el token pasa al nodo que lanza la petición.

El sentido contrario aparece igual de a menudo. Un servicio externo llama a tu Webhook de n8n, la URL que n8n expone para que un sistema de fuera arranque un flujo, y la llamada trae un token. Verify a JWT va justo detrás y corta el flujo cuando el token no cuadra, así que la fila en Postgres o el aviso por Gmail solo salen cuando la comprobación pasa.

Queda el caso menos vistoso, el que ahorra una tarde entera. Llega un token y nadie sabe qué lleva dentro. Decode a JWT lo convierte en JSON legible, Return Additional Info añade la cabecera y la firma, y puedes dejar el resultado en Google Sheets mientras localizas el claim que te interesa.

Casi ningún valor se escribe a mano. Viene de una expresión, la sintaxis {{ }} con la que n8n toma un dato del item que entra, escrita como {{ $json.field }}. Un campo marcado como requerido detiene la ejecución del nodo mientras siga vacío: es lo que pasa con Token en Decode a JWT y en Verify a JWT.

El nodo cubre 3 operaciones sobre 1 recurso. Fuera de ese catálogo entra el nodo HTTP Request, que llama a cualquier endpoint de la API de una herramienta reutilizando el mismo credential mediante la autenticación predefinida. Y si todavía dudas de plataforma, la Reseña n8n lo desarrolla, mientras que el Curso n8n encaja cuando es un equipo entero el que va a montar estos flujos.

Conexión

¿Cómo se configura el credential JWT en n8n?

  1. 01

    Crear el credential JWT

    En n8n, abre el menú Credentials y crea un credential JWT. Un credential es la caja donde guardas el secreto: lo rellenas una vez y aparece en la lista desplegable de cada nodo que lo necesita, en este flujo y en los siguientes. Además no es exclusivo del nodo JWT, el nodo Webhook admite ese mismo credential.

  2. 02

    Elegir el Key Type

    Hay 2 tipos de clave. Passphrase firma con un secreto y un algoritmo HMAC, así que el credential te pide ese Secret. PEM Key apunta al private key JWT con algoritmo RSA o ECDSA: pegas una Private Key y una Public Key obtenidas al generar un par de claves. Elige el tipo que corresponda a la clave que ya tienes en la mano.

  3. 03

    Seleccionar el Algorithm

    Último campo: el Algorithm con el que se firma la aserción. El credential admite HS256, HS384, HS512, RS256, RS384, RS512, ES256, ES384, ES512, PS256, PS384, PS512 y none. Guarda el credential, abre el nodo JWT y ya aparece en su lista desplegable.

Acciones

¿Qué sabe hacer el nodo JWT en n8n?

El nodo JWT expone 3 operaciones. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Decode a JWT

decode

Lo que ves en n8n

Notas y casos de uso

Decodificar devuelve el contenido del token en JSON. Listo para el nodo siguiente. Si activas Return Additional Info, recibes el token decodificado completo, con la información de cabecera y de firma, en lugar de solo el payload.

Parámetros clave

  • Token: el token a verificar o decodificar, campo requerido, normalmente una expresión que apunta al item que entra, {{ $json.field }}.
  • Return Additional Info: desactivado, tienes el payload; activado, llegan también la cabecera y la firma.
  • Key ID: el claim de cabecera opcional kid, que indica la clave para validar la firma.
Casos de uso
entra un token en el flujo y nadie sabe qué transporta. Decodifícalo una vez, lee el JSON y monta la rama siguiente sobre lo que has encontrado.
02

Sign a JWT

sign

Lo que ves en n8n

Notas y casos de uso

Firmar crea el token en vez de leerlo. No hay ningún campo obligatorio: rellenas los claims que necesitas, uno a uno en la colección Payload Claims y sus 12 campos, o en JSON si el payload lo prepara un nodo anterior.

Parámetros clave

  • Use JSON to Build Payload: indica si los claims se construyen en JSON, el objeto va a Payload Claims (JSON).
  • Expires In: la vida del token en segundos, 3600 como ejemplo.
  • Audience: identifica a los destinatarios del JWT.
Casos de uso
un flujo programado llama a un servicio que exige una aserción firmada. Firmas el token justo antes de la llamada y se lo pasas al nodo que hace la petición.
03

Verify a JWT

verify

Lo que ves en n8n

Notas y casos de uso

Aquí el nodo comprueba el token con el algoritmo definido en el credential, y las opciones marcan cuánto aprieta esa comprobación. Si existe Clock Tolerance es porque dos servidores casi nunca van al mismo segundo.

Parámetros clave

  • Token: también requerido aquí, y un campo requerido vacío detiene el nodo antes que ninguna otra cosa.
  • Ignore Expiration: indica si se ignora la expiración del token durante la comprobación.
  • Clock Tolerance: los segundos que se toleran al comprobar los claims nbf y exp, para absorber pequeñas diferencias de reloj entre servidores.
Casos de uso
un servicio externo llama a tu Webhook. La comprobación va primero y el resto del flujo solo se ejecuta cuando el token pasa.
Necesitas ayuda

¿Necesitas ayuda para automatizar JWT con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

JWT y n8n: las dudas que llegan después

01¿La integración JWT n8n es gratuita?
Sí. El nodo JWT viene incluido con n8n: nada que instalar y ningún coste extra del lado de n8n. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada con Docker o npm, bajo Community Edition y licencia Sustainable Use. Un flujo montado en una corre en la otra sin cambios. El nodo trabaja con tokens que ya generas o recibes, y la clave se queda en un credential que creas tú. Así que la pregunta de coste se decide en el sitio donde corre n8n, no en el nodo.
02¿Qué credential necesita el nodo JWT?
Un credential JWT, creado una vez en el menú Credentials y reutilizable en todas partes. Admite 2 tipos de clave. Con Passphrase, la firma se hace con un secreto y un algoritmo HMAC: escribes el Secret y luego eliges el Algorithm. Con PEM Key estás en el private key JWT con algoritmo RSA o ECDSA: introduces una Private Key y una Public Key salidas de un par de claves generado, y después el Algorithm. Ese mismo credential también autentica al nodo Webhook, o sea que con una entrada cubres los dos. Dentro del nodo, cada operación todavía puede sustituir el algoritmo guardado con su opción Override Algorithm.
03¿Qué límites tiene el nodo JWT en n8n?
El nodo cubre 3 operaciones sobre 1 recurso: Decode a JWT, Sign a JWT y Verify a JWT. Fuera de ese catálogo toma el relevo el nodo HTTP Request, que llama a cualquier endpoint de la API de una herramienta reutilizando el mismo credential mediante la autenticación predefinida. Dos detalles que conviene saber antes de montar nada. Token es el campo requerido de Decode a JWT y de Verify a JWT, y un campo requerido vacío detiene la ejecución del nodo. Sign a JWT no tiene ningún campo obligatorio: el payload lleva exactamente lo que tú pongas, campo por campo en los 12 Payload Claims o en un bloque JSON.
04¿El nodo JWT reacciona en tiempo real?
Depende de lo que arranque el flujo. JWT no tiene nodo trigger en n8n, así que un flujo que lo use empieza por otro disparador: un Schedule Trigger a intervalo fijo, el nodo Webhook de n8n al que llama un servicio externo, o el trigger de otra herramienta que ya esté en el flujo. El nodo JWT se ejecuta después, como un paso más de esa ejecución. El ritmo lo marca el primer nodo: con un Webhook, la reacción sigue a la llamada recibida; con un Schedule Trigger, sigue al reloj. La firma o la comprobación llegan justo detrás.
05¿n8n o Make para trabajar con JWT?
Depende del alojamiento y del modelo de coste más que de las funciones. n8n corre en tu propio servidor, con Docker o npm, o en n8n Cloud, y el flujo es idéntico en ambos casos. Make es una plataforma de automatización alojada, sin opción de autoalojamiento, facturada por operación. Si los tokens que firmas o verificas tocan sistemas que mantienes en casa, el autoalojamiento deja la clave y los datos de tu lado. Si prefieres que otro opere la plataforma y te facture por operación, Make responde a eso. La lógica visual también cambia: probar un flujo real en cada una decide antes que una tabla de funciones.