Как пользоваться генератором ссылок offerwall
Скопируйте App ID и соль для хеша ссылок в личном кабинете в разделе Offerwall, ваш offerwall, Интеграция. Введите ID пользователя тестового аккаунта, добавьте sub ID, если отслеживаете размещения, и генератор покажет хеш, полную подписанную ссылку и готовый к вставке код iframe и кнопки Earn. Ничего из введенного никуда не отправляется: хеш вычисляется в вашем браузере с помощью Web Crypto API.
Используйте его, чтобы проверить код своего сервера. Если ссылка, которую ваш сервер создает для того же ID пользователя, не совпадает со ссылкой здесь, разница в вашем коде, а не в Moonetix.
Как строится хеш
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
ID пользователя - это сообщение, а соль - ключ. Sub ID не входят в хеш, поэтому пользователи могут их менять: используйте их для отслеживания, но никогда для начисления. Документация по ссылке offerwall показывает тот же код на PHP, Node.js и Python.
Храните соль на своем сервере
Эта страница - инструмент для тестирования. В рабочей среде создавайте хеш на своем сервере и отправляйте в браузер или приложение только готовую ссылку. Соль в JavaScript, в сборке приложения или в публичном репозитории позволяет кому угодно открыть ваш offerwall от имени любого вашего пользователя. Если соль когда-либо утекла, смените ее: безопасный порядок действий описан в статье Как сменить ключи и соль ссылки.
Частые проблемы
- Ссылка недействительна (403). Хеш не совпадает с ID пользователя. Убедитесь, что вы хешируете ровно ту строку ID пользователя, которую ставите в ссылку, и используете соль для хеша ссылок, а не секретный ключ postback.
- Числа и строки. Хешируйте ID пользователя как строку.
42и042- это разные пользователи. - Кодирование. Хешируйте исходный ID пользователя, а затем закодируйте его для URL в ссылке. Не хешируйте закодированное значение.
Частые вопросы
Безопасно ли вводить здесь мою соль для хеша ссылок?
Страница никуда ее не отправляет, но пользоваться тестовым приложением или тестовой солью все равно правильнее. Никогда не размещайте настоящую соль в клиентском коде.
Какой хеш использует ссылка на offerwall Moonetix?
HMAC-SHA256 от ID пользователя с солью для хеша ссылок в качестве ключа, в виде hex в нижнем регистре.
Меняют ли sub ID хеш?
Нет. Sub ID не входят в хеш, поэтому их можно добавлять или менять, не пересчитывая его.
Можно ли использовать эту ссылку в мобильном приложении?
Да, в WebView или в системном браузере, если ссылку создает ваш бэкенд. Для нативного экрана используйте SDK для Android, iOS, Unity, Flutter или React Native с токеном сессии.