Verificar la firma de un webhook
Construye la cadena t.body a partir del encabezado X-CalcLib-Signature, calcula HMAC-SHA256 con tu secreto y compara antes de procesar el envío.
Un endpoint de webhook añadido en Webhooks recibe un POST firmado cada vez que alguien usa tu inserción. Cada envío incluye un encabezado X-CalcLib-Signature con el formato t=<unix time>,v1=<signature>.
Verifica antes de analizar
- Lee el cuerpo sin procesar de la solicitud. Si analizas el JSON y lo vuelves a serializar, cambian los bytes y la firma nunca coincidirá.
- Toma
tdel encabezado y construye la cadenat.body: la marca de tiempo, un punto y el cuerpo sin procesar. - Calcula el HMAC-SHA256 de esa cadena con el secreto de tu endpoint, en formato hexadecimal.
- Compáralo con cada valor
v1en tiempo constante. Mientras rotas un secreto, el encabezado puede incluir dos valoresv1; cualquiera de ellos puede coincidir. - Rechaza el envío si
tdifiere en más de 5 minutos de la hora de tu reloj.
Envíos que fallan
Se reintentan al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas y 8 horas. Un endpoint que falla 20 veces seguidas se desactiva y te enviamos un correo, según el ajuste de producto en Notificaciones.