Зашифрованная информация об игре (Task API)

Если вам необходимо безопасно передать данные о текущем игроке или команде во время игры сторонним внешним сервисам (например, Telegram-боту, скрипту авторизации или кастомному сайту с флеш-игрой), используйте генерацию зашифрованной строки.

В этом случае технически подкованные игроки не смогут увидеть, какие именно данные передаются в URL или параметрах скрипта, и не смогут подделать их самостоятельно. Это особенно критично на играх длинного формата (Long).

• Перейдите в редактор вашей игры.
• Найдите раздел “API для внешних сайтов / телеграм ботов”.
• Нажмите кнопку “Сгенерировать”. Движок создаст уникальный ключ (например, XgHxzCvUSXwPfR7wBvdY4xHC6tSFLewx).

В тексте задания, подсказки или в параметрах ссылки на внешний сервис пропишите конструкцию вида:

!api:поле1,поле2!

Доступные поля для шифрования (указываются через запятую):

• user_id — ID игрока. В расшифрованном JSON преобразуется в ключ u.
• user_name — логин игрока. В JSON — un.
• team_id — ID команды. В JSON — tm.
• team_name — название команды. В JSON — tmn.
• task_n — порядковый номер текущего уровня. В JSON — t.
• task_id — ID текущего уровня. В JSON — tid.
• game_id — ID игры. В JSON — gid.

Если вы пропишете в задании:

!api:user_id,task_id!

Движок сгенерирует зашифрованную hex-строку вида:

0394334e96a2f0fa738470e9a9778c684ba214990d200eab

Ее можно расшифровать на вашем сервере с помощью ключа игры и алгоритма Blowfish (ECB). В результате вы получите JSON:

{"u": 162862, "tid": 42719}

Пример задания в игре

$data = '0394334e96a2f0fa738470e9a9778c684ba214990d200eab';
$key  = 'XgHxzCvUSXwPfR7wBvdY4xHC6tSFLewx';
$decoded = json_decode(
  trim(
    openssl_decrypt(
      hex2bin($data),
      'BF-ECB',
      $key,
      OPENSSL_RAW_DATA | OPENSSL_NO_PADDING
    )
  ),
  true
);
// $decoded => array('u' => 162862, 'tid' => 42719)

*(Требуется библиотека blowfish: pip install blowfish)*

import binascii
import json
import typing
import blowfish
 
def decrypt_qeng_data(data: str, key: str) -> typing.Dict[str, typing.Union[str, int]]:
    data_bytes = binascii.unhexlify(data)
    cipher = blowfish.Cipher(key.encode())
    data_decrypted = b"".join(cipher.decrypt_ecb(data_bytes))
    data_decrypted = data_decrypted.rstrip(b'\x00')
    return json.loads(data_decrypted)
 
# Использование
data = '0394334e96a2f0fa738470e9a9778c684ba214990d200eab'
key = 'XgHxzCvUSXwPfR7wBvdY4xHC6tSFLewx'
print(decrypt_qeng_data(data, key)) # => {'u': 162862, 'tid': 42719}

require 'json'
require 'openssl'
 
module Blowfish
  def self.decrypt(data, key)
    crypto = OpenSSL::Cipher::Cipher.new('bf-ecb').send(:decrypt)
    crypto.key_len = key.length
    crypto.key = key
    crypto.padding = 0
    crypto.update([data].pack("H*")) << crypto.final
  end
end
 
def qeng_data_decrypt(data, key)
  decrypted_text = Blowfish.decrypt(data, key)
  JSON.parse(decrypted_text, symbolize_names: true)
end
 
# Использование
data = '0394334e96a2f0fa738470e9a9778c684ba214990d200eab'
key = 'XgHxzCvUSXwPfR7wBvdY4xHC6tSFLewx'
puts qeng_data_decrypt(data, key) # => {:u=>162862, :tid=>42719}