Firma de entregas de webhook
Cada entrega de webhook saliente se firma con HMAC-SHA256. A un webhook guardado sin clave secreta se le asigna una, que se muestra una sola vez; un webhook sin clave secreta se muestra como Sin firmar (no se ha establecido ninguna clave secreta) y sus entregas no se envían hasta que se establezca una.
- Plataforma › Eventos y Webhooks › Webhooks › Nuevo: a un webhook guardado sin una clave secreta de firma (o guardado nuevamente como activo sin una) se le asigna una clave segura, que se muestra una sola vez, con un botón para copiar. Cópiela y envíela al receptor; no se mostrará de nuevo.
- La opción "Establecer clave secreta de firma" en un webhook la establece o la reemplaza: escriba una de al menos 32 caracteres, o déjela en blanco para generar una y verla una sola vez. Se rechazará una más corta.
- HMAC-SHA256 es la única firma que se ofrece para los webhooks salientes.
- Los webhooks y las entregas de webhooks tienen una columna de firma. Un webhook sin secreto se muestra como "Sin firmar" (no se ha configurado ningún secreto) y cada una de sus entregas falla con el mensaje "No se envió: no se ha configurado ningún secreto de firma en este webhook" en lugar de enviarse sin firmar. Configure un secreto (o guarde el webhook nuevamente mientras esté activo) y las entregas se enviarán firmadas.
Una entrega que falla porque no se pudo encontrar el nombre del destinatario (un fallo de DNS) se reintenta hasta alcanzar el límite de reintentos del webhook, como si fuera una conexión fallida. Un destino que la plataforma rechaza directamente (una dirección privada o de metadatos, un esquema que no utiliza) sigue fallando en el primer intento.
Véase también Acontecimientos que nunca se pierden.