Crypto

Descripción

El nodo Crypto calcula el hash o el HMAC de un valor de texto usando algoritmos estándar (MD5, SHA-1, SHA-256, SHA-384, SHA-512). Es útil para firmar payloads de webhooks, verificar integridad de datos, generar identificadores deterministas o comparar contra firmas provistas por servicios externos.

Es equivalente al nodo Crypto de n8n.

El modo Hash genera un resumen del valor. El modo HMAC genera un código de autenticación usando además una clave secreta. El resultado se codifica en hexadecimal o Base64 y se guarda en un campo del data.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
action	select	Sí	hash (por defecto): resumen simple. hmac: código de autenticación con clave secreta
algorithm	select	Sí	Algoritmo: md5, sha1, sha256 (por defecto), sha384, sha512
value	textarea	Sí	Texto o expresión a procesar. Soporta variables dinámicas
secret	text	No	Clave secreta (obligatoria cuando action es hmac). Soporta variables dinámicas
encoding	select	No	Codificación de salida: hex (por defecto) o base64
outputKey	text	No	Nombre del campo donde se guarda el resultado. Por defecto hash

Salida

El nodo agrega el resultado al data en el campo indicado por outputKey (por defecto hash):

{
  "texto": "hola mundo",
  "hash": "0b7f849446d3383546d15a480966084442cd2193"
}

Ejemplos de Uso

Hash SHA-256 de un texto

{
  "label": "Hash del email",
  "action": "hash",
  "algorithm": "sha256",
  "value": "{{data.email}}",
  "encoding": "hex",
  "outputKey": "email_hash"
}

Firmar un payload de webhook con HMAC-SHA256

{
  "label": "Firma HMAC",
  "action": "hmac",
  "algorithm": "sha256",
  "value": "{{data.payload}}",
  "secret": "{{data.webhook_secret}}",
  "encoding": "base64",
  "outputKey": "signature"
}

Genera la firma que luego puede compararse contra la cabecera enviada por el proveedor.

MD5 en Base64

{
  "label": "Checksum",
  "action": "hash",
  "algorithm": "md5",
  "value": "{{data.contenido}}",
  "encoding": "base64",
  "outputKey": "checksum"
}

Notas

• El modo hmac requiere obligatoriamente un secret; si falta, el nodo devuelve un error
• Si se indica un algoritmo o encoding no soportado, el nodo devuelve un error descriptivo
• Si el data de entrada es un objeto, el resultado se agrega sin perder los campos existentes; si no lo es, se envuelve en { value, [outputKey] }
• MD5 y SHA-1 no se recomiendan para usos criptográficos sensibles; úsalos solo para checksums o compatibilidad
• No requiere credenciales