INTEGRACIÓN JWT n8n: AUTOMATIZAR JWT CON N8N

La acción Sign genera un JSON Web Token firmado criptográficamente que puede ser utilizado para autenticar usuarios o intercambiar información segura entre servicios. Esta acción es fundamental cuando necesitas crear tokens de autenticación personalizados con claims específicos (identificador de usuario, roles, permisos, fecha de expiración, etc.).

Parámetros clave:

• Credential to connect with: Dropdown requerido donde seleccionas la cuenta JWT Auth previamente configurada con tu clave secreta o par de claves. Esta credencial determina el algoritmo de firma y la clave utilizada.
• Operation: Dropdown requerido configurado en "Sign" para indicar que el nodo generará un token firmado.
• Use JSON to Build Payload: Interruptor opcional on/off que determina si construyes el payload del JWT usando JSON bruto o mediante entrada manual de claims. Cuando está desactivado (por defecto), utilizas la interfaz visual de claims.
• Payload Claims: Sección dinámica donde añades pares clave-valor que conforman el payload del JWT. Utiliza el dropdown "Add Claim" para añadir claims estándar (iss, sub, aud, exp, iat) o personalizados.
• Options: Sección opcional donde puedes añadir parámetros avanzados de firma mediante el dropdown "Add option". Permite configurar opciones como "expiresIn", "notBefore", "audience", "issuer", entre otros.

Casos de uso típicos:

• Generar automáticamente un token de sesión cuando un usuario se autentica exitosamente en tu aplicación.
• Crear tokens de activación de cuenta con tiempo de expiración limitado.
• Firmar tokens de autorización para comunicación segura entre microservicios.
• Producir tokens de reset de contraseña únicos y de corta duración.

Cuándo usarlo: Utiliza Sign cada vez que necesites generar credenciales de autenticación seguras, crear tokens de autorización para APIs protegidas, o intercambiar información verificable entre sistemas sin exponer datos sensibles.

La acción Verify valida la autenticidad e integridad de un JSON Web Token recibido, verificando su firma criptográfica y opcionalmente sus claims. Esta operación es crítica para asegurar que los tokens utilizados en tus workflows provienen de una fuente confiable y no han sido manipulados.

Parámetros clave:

• Credential to connect with: Dropdown requerido donde seleccionas la cuenta JWT Auth utilizada para verificar la firma del token. La credencial debe contener la clave secreta (para algoritmos HMAC) o la clave pública (para algoritmos RSA/ECDSA) correspondiente a la clave con la que se firmó el token.
• Operation: Dropdown requerido configurado en "Verify" para indicar que el nodo validará un token existente.
• Token: Campo de texto requerido donde introduces el string del JWT que necesitas verificar. Acepta tokens completos (header.payload.signature) en formato string. Puedes pegar tokens estáticos o utilizar expresiones n8n para extraer el token de datos de entrada previos.
• Options: Sección opcional donde puedes añadir parámetros de verificación avanzados mediante el dropdown "Add option". Permite especificar claims esperados (audience, issuer), algoritmos de verificación permitidos, o tolerancia de tiempo para expiración.

Casos de uso típicos:

• Validar tokens JWT recibidos en webhooks antes de procesar peticiones API sensibles, rechazando automáticamente tokens inválidos o expirados.
• Verificar la autenticidad de tokens de autorización antes de conceder acceso a recursos protegidos.
• Implementar middleware de autenticación automatizado que verifica tokens en cada petición HTTP entrante.

Cuándo usarlo: Utiliza Verify como primera etapa de validación en cualquier workflow que reciba tokens JWT externos. Es esencial para securizar tus workflows de automatización contra tokens falsificados, manipulados o expirados.

La acción Decode extrae y devuelve el payload y el header de un JSON Web Token sin verificar su firma. Esta operación permite acceder a la información contenida en el token (claims de usuario, metadatos, timestamps) de forma rápida, aunque NO garantiza la autenticidad del token.

Parámetros clave:

• Credential to connect with: Dropdown requerido donde seleccionas una cuenta JWT Auth. Aunque la decodificación no requiere verificación de firma, n8n solicita una credencial por consistencia de interfaz.
• Operation: Dropdown requerido configurado en "Decode" para indicar que el nodo extraerá información del token sin validar su firma.
• Token: Campo de texto requerido donde introduces el string del JWT que deseas decodificar. Acepta tokens completos en formato string. El nodo extraerá el header (primer segmento) y el payload (segundo segmento) automáticamente.
• Options: Sección opcional actualmente sin propiedades configurables. El dropdown "Add option" permite añadir parámetros si futuros updates de n8n los implementan.

Casos de uso típicos:

• Extraer información de usuario (ID, email, roles) de tokens JWT para enriquecer datos en tu CRM o base de datos como Airtable sin necesidad de verificación previa.
• Leer metadatos de tokens (fecha de emisión, expiración, issuer) para análisis, logging o reporting de uso de autenticación.
• Obtener rápidamente el contenido de tokens en workflows de desarrollo o debugging donde la verificación de firma no es prioritaria.

Cuándo usarlo: Utiliza Decode cuando necesites acceder al contenido de un token JWT de forma rápida y la validación de autenticidad no es crítica en esa etapa del workflow. ⚠️ IMPORTANTE: Nunca confíes en datos decodificados sin verificación previa para tomar decisiones de seguridad o autorización. Para casos sensibles, utiliza siempre Verify antes de Decode.