Cómo usar el generador de enlaces de offerwall
Copie su App ID y su link hash salt desde su panel, en Offerwalls, su offerwall, Integration. Escriba el ID de usuario de una cuenta de prueba, agregue sub IDs si hace seguimiento de ubicaciones, y el generador muestra el hash, el enlace firmado completo y el código del iframe y del botón Earn listo para pegar. Nada de lo que escribe se envía a ningún lugar: el hash se calcula en su navegador con la Web Crypto API.
Úselo para comprobar el código de su propio servidor. Si el enlace que genera su servidor para el mismo ID de usuario no coincide con el de aquí, la diferencia está en su código, no en Moonetix.
Cómo se construye el hash
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
El ID de usuario es el mensaje y el salt es la clave. Los sub IDs no forman parte del hash, así que los usuarios pueden cambiarlos: úselos para seguimiento, nunca para acreditar. La documentación del Offerwall link muestra el mismo código en PHP, Node.js y Python.
Mantenga el salt en su servidor
Esta página es una herramienta de prueba. En producción, genere el hash en su servidor y envíe solo el enlace terminado al navegador o a la app. Un salt en JavaScript, en el paquete de una app o en un repositorio público permite a cualquiera abrir su offerwall como cualquiera de sus usuarios. Si alguna vez se filtra un salt, rótelo: cómo rotar las claves y el salt del enlace explica el orden seguro.
Problemas comunes
- Enlace no válido (403). El hash no coincide con el ID de usuario. Compruebe que calcula el hash exactamente de la misma cadena de ID de usuario que pone en el enlace, con el link hash salt, no con la postback secret key.
- Números frente a cadenas. Calcule el hash del ID de usuario como cadena.
42y042son usuarios distintos. - Codificación. Calcule el hash del ID de usuario sin procesar y luego codifíquelo para URL en el enlace. No calcule el hash del valor ya codificado.
Preguntas frecuentes
¿Es seguro escribir aquí mi link hash salt?
La página nunca lo envía a ningún lugar, pero usar una app de prueba o un salt de prueba sigue siendo una costumbre más segura. Nunca ponga su salt real en código del lado del cliente.
¿Qué hash usa el enlace del offerwall de Moonetix?
HMAC-SHA256 del ID de usuario, con su link hash salt como clave, en hexadecimal en minúsculas.
¿Los sub IDs cambian el hash?
No. Los sub IDs no forman parte del hash, así que puede agregarlos o cambiarlos sin volver a generarlo.
¿Puedo usar este enlace en una app móvil?
Sí, en un WebView o en el navegador del sistema, si su backend lo genera. Para una pantalla nativa, use en su lugar el SDK de Android, iOS, Unity, Flutter o React Native con un token de sesión.