Firmas y Base64#

Los servicios externos suelen firmar sus solicitudes o esperar una firma tuya, y pasan los datos en Base64. Para eso el código tiene tres funciones.

hash_hmac#

hash_hmac(algo, text, key, format)

Calcula la firma HMAC de un texto con una clave secreta.

Devuelve la firma como cadena. Si algo, text o key están vacíos, devuelve undefined.

Advertencia

Pasa solo algoritmos de la lista. Con cualquier otro nombre, como 'sha3', la función lanza TypeError: hash_hmac: unsupported algorithm "sha3"…. Si no lo capturas con try...catch, el código se detiene con este error.

Verifica la firma de una solicitud entrante: el servicio de la tienda la envía en el encabezado X-Signature, y la clave secreta se guarda en una variable global del bot.

var secret = getGlobalVariable('shop_key');
var expected = hash_hmac('sha256', request.body, secret);

if (expected !== request.headers['x-signature']) {
    throw new Error('Firma no válida');
}

if (setContactById(request.data.contact_id)) {
    setContactVariable('order_status', request.data.status);
}

Si la firma no coincide, el código se detiene y el bloque responde a la solicitud con el código 422.

base64_encode#

base64_encode(text)

Codifica un texto en Base64.

Devuelve una cadena Base64.

var auth = 'Basic ' + base64_encode('flowers:secret-password');

base64_decode#

base64_decode(text)

Decodifica una cadena de Base64.

Devuelve el texto decodificado, o undefined si la cadena no es Base64.

var payload = base64_decode(request.data.payload);
var order = payload ? JSON.parse(payload) : null;