Гид по интеграции · 2026

Безопасность API для казино: подписи, белые списки IP и идемпотентность

API для казино перемещает деньги при каждом спине. Безопасность здесь — не столько про файрволы, сколько про три вопроса: подлинный ли это запрос, безопасен ли он, если придет дважды, и можно ли потом отследить каждое изменение баланса? Ниже — меры контроля, которые нужно согласовать с провайдером до первой реальной ставки.

Коротко

  • Подписывайте каждый запрос в обоих направлениях и отклоняйте все, что не проходит проверку.
  • Внесите IP серверов в белый список с обеих сторон; эндпоинты кошелька никогда не должны быть открыты в интернет.
  • Сделайте каждый вызов кошелька идемпотентным по ID транзакции.
  • Делайте токены сессий короткоживущими и привязанными к одному игроку и одной игре.
  • Логируйте каждый запрос и ответ; они понадобятся вам при спорах.

Что доказывает подписанный запрос

Подпись — это хеш тела запроса и временной метки, созданный с помощью секрета, который есть только у вас и у провайдера. Принимающая сторона вычисляет его заново; если значения не совпадают, запрос подделан или изменен и отклоняется. Временная метка тоже важна: принимайте запросы только в коротком окне — тогда перехваченный запрос нельзя будет повторить через час.

В IGP каждый вызов через API для казино содержит хеш, чтобы сервер мог доказать, что вызов пришел от вас. Требуйте такой же защиты для колбэков, поступающих на ваш кошелек, и тестируйте оба направления, а не только то, в котором отправляете вы.

Белый список IP

Эндпоинт вашего кошелька — место, где движутся деньги, поэтому он должен отвечать только серверам провайдера. Согласуйте фиксированные исходящие IP с обеих сторон, ведите отдельные списки для staging и production и рассматривайте любое изменение списка как запрос на изменение, а не как быстрое исправление.

Идемпотентность: контроль, который защищает балансы

В сетях случаются тайм-ауты. Если провайдер не получает ваш ответ вовремя, он отправляет то же списание или зачисление повторно. Если ваш кошелек считает повтор новой транзакцией, игрок платит дважды или получает выплату дважды.

Решение простое и обязательное: храните каждый ID транзакции, и если он приходит повторно, возвращайте исходный ответ, не изменяя баланс. Откаты должны ссылаться на транзакцию, которую они отменяют. В нашем чек-листе интеграции API для казино есть тесты для всех трех случаев.

Токены сессий и запуск игры

Игровая сессия начинается с токена, который ваша платформа выдает при запуске. Привяжите его к одному игроку, одной игре и одной валюте, задайте короткий срок жизни и проверяйте при первом вызове кошелька. Не передавайте персональные данные в URL запуска: ID игрока и токена достаточно.

Мера контроля От чего защищает Кто отвечает
Подпись запроса Поддельные или измененные вызовы Оператор и провайдер
Окно временной метки Повторно воспроизведенные запросы Оператор и провайдер
Белый список IP Вызовы с неизвестных серверов Оператор и провайдер
Идемпотентные ID транзакций Двойные списания и зачисления при повторах Кошелек оператора
Короткоживущие токены сессий Перехваченные или повторно использованные игровые сессии Платформа оператора
TLS для каждого вызова Перехват при передаче Оператор и провайдер
Журналы аудита Споры, в которых ничего нельзя доказать Оператор и провайдер

Перед запуском

  • Отправьте запрос с неверной подписью и запрос с просроченной временной меткой; оба должны быть отклонены.
  • Вызовите кошелек с IP, которого нет в списке; вызов должен быть отклонен.
  • Отправьте одно и то же списание дважды и одно и то же зачисление дважды; баланс должен измениться по одному разу.
  • Запустите игру с просроченным токеном; сессия на реальные деньги открыться не должна.
  • Возьмите случайный раунд за вчера и отследите его от начала до конца в своих логах.

Частые вопросы

Нет. TLS защищает данные при передаче, но не доказывает, кто отправил запрос, и не мешает отправить валидный запрос дважды. Нужны также подписанные запросы, окно временной метки, белый список IP и идемпотентные вызовы кошелька.

Если ваш кошелек идемпотентен по ID транзакции — ничего: второй вызов вернет исходный результат, и баланс изменится один раз. Если нет, игрок получит двойное списание или двойное зачисление — одна из классических ошибок, из-за которых в интеграциях казино теряются деньги.

Только то, что нужно игре для работы: ID игрока, токен сессии, валюту, язык и юрисдикцию. Имена, e-mail, адреса и платежные данные остаются на вашей платформе.

По графику, согласованному с провайдером, и немедленно после кадровых изменений или при любом подозрении на утечку. Во время ротации поддерживайте два активных секрета, чтобы живой трафик не прерывался.

Одна подписанная интеграция, 150+ провайдеров

Подписанные запросы, один кошелек и один нормализованный поток транзакций для 18 000+ игр, а также песочница для тестирования всех перечисленных мер контроля.

Посмотреть API для казино →