Skip to main content
La firma permite demostrar que el cuerpo recibido fue generado por alguien que conoce el secreto y que no fue alterado durante el tránsito.

Elige el protocolo correcto

X-Cobrix-Signature: t=…,v1=…Firma timestamp.raw_body y acepta cualquier 2xx.
x-cobrix-signature: hexFirma solo raw_body y exige HTTP 200.

Protocolo general

Cobrix envía:
La fórmula exacta es:
1

Captura el cuerpo crudo

Obtén los bytes recibidos. Todavía no ejecutes JSON.parse.
2

Extrae t y v1

Del header de firma toma el timestamp t y el hexadecimal v1.
3

Rechaza timestamps viejos

Compara t con la hora Unix actual y admite como máximo 300 segundos de diferencia.
4

Construye el mensaje

Concatena el timestamp, un punto literal y el cuerpo exacto.
5

Calcula y compara

Calcula HMAC-SHA256 con el secreto y usa una comparación timing-safe.

Protocolo de documentos públicos

La fórmula no agrega timestamp:

Fixture para probar tu implementación

Si obtienes otro resultado, revisa codificación UTF-8, saltos de línea, espacios y el orden en que el framework procesa el cuerpo.
Nunca registres el secreto ni el header completo de firma en logs públicos. Para soporte basta con el identificador del evento y el resultado de la validación.