Generador de HMAC

Acerca de esta herramienta

Qué demuestra un HMAC

HMAC (RFC 2104) combina un mensaje con una clave secreta mediante una función hash y devuelve una etiqueta corta. Quien tenga la misma clave puede volver a calcular la etiqueta. Si las dos etiquetas son iguales, el mensaje no se modificó por el camino (integridad) y lo generó alguien que conoce la clave (autenticidad).

Un hash simple no puede hacerlo, porque quien altere el mensaje también puede recalcular su hash. Un HMAC no oculta el mensaje, así que no es cifrado. Y como ambas partes tienen la misma clave, no puede demostrar cuál de las dos escribió el mensaje. Para eso hace falta una firma digital con una clave privada.

Firmas de webhooks

HMAC aparece a menudo en los webhooks. El proveedor firma el cuerpo de la petición con un secreto que comparte contigo y envía la etiqueta en una cabecera, y tu servidor calcula el mismo HMAC antes de fiarse de la petición. GitHub envía X-Hub-Signature-256: sha256=… en hex, Shopify envía X-Shopify-Hmac-SHA256 en Base64, y Stripe firma el timestamp, un punto y el cuerpo, y envía el resultado como v1=… dentro de Stripe-Signature.

Firma los bytes en bruto del cuerpo exactamente como llegaron. Si un framework interpreta el JSON y tú lo vuelves a serializar, cambian los espacios y el orden de las propiedades, y el HMAC deja de coincidir. Cuando aquí una firma no coincida, revisa primero la codificación de la clave (texto, hex o Base64) y después si hay un salto de línea al final del mensaje.

Por qué un servidor compara en tiempo constante

Una comparación de cadenas normal se detiene en el primer carácter distinto. En un servidor, eso hace que la respuesta sea un poco más rápida cuando los primeros bytes de una firma falsificada son incorrectos y un poco más lenta cuando son correctos, y un atacante capaz de medirlo puede reconstruir una etiqueta válida byte a byte. Una comparación en tiempo constante lee todos los bytes, sea cual sea el resultado. Usa la función que ofrece tu plataforma: crypto.timingSafeEqual en Node.js, hmac.Equal en Go, hmac.compare_digest en Python, hash_equals en PHP.

El campo de comparación de esta página funciona igual: decodifica ambos valores a bytes y los lee todos. En una pestaña del navegador que ya tiene los dos valores no hay ningún tiempo que ocultar, así que aquí solo te dice si tu propio código generó la etiqueta correcta.

Cómo funciona

La etiqueta la calcula el paquete crypto/hmac de Go compilado a WebAssembly y ejecutado en un hilo en segundo plano de tu navegador. El mensaje se toma como UTF-8, sin añadir ni recortar nada. Solo cambia una cosa: un cuadro de texto del navegador guarda cada salto de línea como un único avance de línea, así que un mensaje que llegó con finales de línea CRLF se firma aquí con LF. La clave se toma como texto UTF-8, o se decodifica desde hex o Base64 si así lo indicas. Ninguno de los dos se envía a ninguna parte. Aun así, es mejor no poner un secreto de producción en una página web: usa una clave de prueba cuando puedas.