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_shippingsin firma HMAC cuando el administrador activó explícitamentecod_form_ignore_wc_shipping === 'yes'en los ajustes generales, o cuando el campostatefue deshabilitado intencionalmente encod_form_disable_form_fields. - En cualquier otro caso, si el
shipping_codefalta o su firma HMAC no coincide, la creación de la orden se aborta inmediatamente devolviendowp_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
upsellsen la base de datos medianteprcod_resolve_verified_upsell_item()y recalcula el precio en PHP.