Seguridad Criptográfica HMAC-SHA256 en Tarifas de Envío y Códigos de Descuento (Free y PRO)

En cualquier formulario de compra rápida basado en AJAX, confiar ciegamente en el costo de envío o en el porcentaje de descuento enviado por el navegador a través de $_POST abriría una vulnerabilidad crítica: un usuario malintencionado podría inspeccionar el DOM, cambiar data-cost="15000" por 0 o alterar un descuento del 10% al 99%.

Para blindar tu tienda contra la manipulación de precios en el cliente, tanto Modal COD Form Free (v2.0+) como Modal COD Form PRO (v5.0+) implementan un sistema de firma criptográfica HMAC-SHA256 por sitio en todas las tarifas de envío y códigos de descuento.

1. Generación de la Clave Secreta Única por Sitio

Ninguna firma puede falsificarse leyendo el código fuente público del plugin porque la clave secreta combina la sal criptográfica única de tu instalación de WordPress (wp_salt('nonce') definida en wp-config.php) con la constante interna del plugin:

Edición Función Generadora de Clave Fórmula Criptográfica
Modal COD Form Free modalcodf_get_secret_key() (en includes/modalcodf-utils.php) hash( 'sha256', wp_salt( 'nonce' ) . MODALCODF_UTILKEY )
Modal COD Form PRO prcod_get_secret_key() (en includes/utils/discount-utils.php) hash( 'sha256', wp_salt( 'nonce' ) . D_S_K ) (con soporte de verificación de respaldo para mantener compatibilidad en sesiones activas).

2. Firma y Validación de Tarifas de Envío (data-shipping-code)

Cuando el cliente selecciona un departamento o ciudad (o cuando se precarga el envío inicial con cod_form_load_initial_shipping = yes), el servidor calcula las tarifas legítimas y genera un token firmado en Base64 para cada radio button:

Estructura interna antes de Base64:
{method_id:instance_id}[]{cost}[]{label}[]{HMAC_SHA256}

¿Por qué se utiliza el delimitador seguro '[]'?

  • Muchos administradores nombran sus tarifas de envío usando barras verticales o guiones (por ejemplo, Envío Express | Entrega 24h).
  • Al usar '[]' como delimitador y extraer primero el hash final (array_pop), luego el método (array_shift) y el costo (array_shift), cualquier resto se vuelve a unir limpiamente en $label (implode('[]', $parts)). Así, ningún carácter especial en el nombre de la tarifa rompe jamás la verificación HMAC.
  • En el servidor, hash_equals($expected_hmac, $received_hmac) compara las firmas en tiempo constante para prevenir ataques de temporización (timing attacks).

3. Protección Estricta contra Inyección de free_shipping

Si un atacante intenta enviar shipping_method = 'free_shipping' con un shipping_code vacío para evadir el cobro del flete, el validador de órdenes (MODALCODF_Order_Creator / PRCOD_Order_Creator) ejecuta una comprobación estricta en el servidor:

  • Solo se acepta free_shipping sin firma HMAC cuando el administrador activó explícitamente cod_form_ignore_wc_shipping === 'yes' en los ajustes generales, o cuando el campo state fue deshabilitado intencionalmente en cod_form_disable_form_fields.
  • En cualquier otro caso, si el shipping_code falta o su firma HMAC no coincide, la creación de la orden se aborta inmediatamente devolviendo wp_send_json_error.

4. Firma de Códigos de Descuento en PRO (dsc y downsell_dsc)

Del mismo modo, en Modal COD Form PRO:

  • Las tarjetas de Ofertas por Cantidad y los popups de Downsell emiten un token firmado mediante prcod_generate_discount_code($discount_type, $discount_value).
  • Al recibir el pedido, prcod_decrypt_discount_code($encrypted_code) verifica el HMAC-SHA256 antes de aplicar cualquier rebaja.
  • Para los Upsells 1-Tick y 1-Click, el servidor ni siquiera confía en un código firmado del cliente: consulta directamente los metadatos del CPT upsells en la base de datos mediante prcod_resolve_verified_upsell_item() y recalcula el precio en PHP.

5. Enlaces Relacionados

Compartir esta información

Aumenta tus ventas

Mejora tu conversión en tiendas WordPress y WooCommerce con pago contra-entrega.