Авторизация / Подключение хранилища для данных пользователей
 На главную

Авторизация

  • Руководство по интеграции

  • Варианты аутентификации

  • Хранилище данных пользователей

  • Безопасность

  • Кастомизация

  • Провайдеры коммуникационных услуг

  • Возможности

  • Инструкции

  • Расширения

  • Юридические настройки

  • Справочники

  • Подключение хранилища для данных пользователей

    В зависимости от способа хранения данных пользователей вам доступна разная функциональность продукта (см. раздел Сравнение хранилищ для данных пользователей).

    Хранилище Иксоллы

    Если вы хотите, чтобы продукт Авторизация выполнял всю логику аутентификации, используйте хранилище Иксоллы. С этим типом хранилища вам будут доступны более гибкие настройки.

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

    1. На странице навигации перейдите к блоку База пользователей и выберите раздел Хранилище.
    2. Выберите пункт Хранилище Иксоллы и нажмите Сохранить изменения.

    Примечание
    Хранилище поддерживает аутентификацию по стандарту JWT и протоколу OAuth 2.0. Вся информация о пользователях хранится на стороне Иксоллы.

    Хранилище PlayFab

    Если вы хотите использовать функциональность PlayFab для работы с пользователями, подключите хранилище PlayFab. В хранилище записывается следующая информация:

    • имя пользователя;
    • email-адрес пользователя;
    • пароль пользователя;
    • поля с расширенной формы регистрации, если она настроена.

    Примечание
    Хранилище поддерживает аутентификацию по стандарту JWT и протоколу OAuth 2.0.

    Хранилище PlayFab предоставляет вам доступ к следующим функциям:

    • регистрация пользователей;
    • аутентификация по email-адресу или имени пользователя и паролю;
    • аутентификация через Twitch;
    • сброс пароля пользователя;
    • блокировка пользователя.

    Чтобы подключить хранилище:

    1. На странице навигации перейдите к блоку База пользователей и выберите раздел Хранилище.
    2. Выберите пункт PlayFab.
    3. В поле Title ID введите значение того же поля из личного кабинета PlayFab.
    4. Нажмите Сохранить изменения.

    Примечание
    Вся информация о пользователях хранится на стороне Иксоллы. Пароль пользователя валидируется на стороне PlayFab.

    Хранилище Firebase

    Если вы хотите использовать функциональность Firebase для работы с пользователями, подключите хранилище Firebase. В хранилище записывается следующая информация:

    • имя пользователя;
    • email-адрес пользователя;
    • пароль пользователя;
    • поля с расширенной формы регистрации, если она настроена.

    Примечание
    Хранилище поддерживает аутентификацию по стандарту JWT и протоколу OAuth 2.0.

    Чтобы подключить хранилище:

    1. На странице навигации перейдите к блоку База пользователей и выберите раздел Хранилище.
    2. Выберите пункт Firebase.
    3. В поле Ключ API введите значение того же поля из личного кабинета Firebase.
    4. Нажмите Сохранить изменения.

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

    Собственное хранилище

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

    Собственное хранилище предоставляет вам доступ к следующим функциям:

    • регистрация пользователей;
    • аутентификация пользователя с помощью email-адреса или имени пользователя и пароля;
    • аутентификация без пароля по номеру телефона;
    • аутентификация через социальные сети;
    • сброс пароля пользователя.

    Примечание
    Хранилище поддерживает аутентификацию по стандарту JWT.

    Для взаимодействия сервера Авторизации Иксолла и вашего приложения:

    1. Подключите собственное хранилище.
    2. Настройте обработку запросов от сервера Авторизации Иксолла.

    Примечание
    Вся информация о пользователях хранится на стороне Иксоллы. Пароль пользователя валидируется на стороне собственного хранилища.

    Подключение собственного хранилища

    1. На странице навигации перейдите к блоку База пользователей и выберите раздел Хранилище.
    2. Выберите пункт Собственное хранилище.
    3. Введите URL-адреса для отправки запросов API:
    4. Нажмите Сохранить изменения.
    5. Для заданных вами URL-адресов реализуйте API, который будет отвечать следующим образом:
      • HTTP 200 / HTTP 204 для успешных запросов. Если требуется, JSON с дополнительными данными пользователя можно разместить в теле ответа. Переданные данные записываются в JWT (параметр partner_data).
      • Другие HTTP-коды для неуспешных запросов.

    Примечание
    • Чтобы передавать ID пользователя из вашей базы данных в JWT, обратитесь к аккаунт-менеджеру проекта.
    • Чтобы аутентификация без пароля по номеру телефона работала корректно, ответ вашего API должен содержать параметр account_id, который соответствует ID пользователя на стороне клиента.

    Настройка обработки запросов от сервера Авторизации Иксолла

    Запросы от сервера Авторизации Иксолла отправляются на URL, указанные в Личном кабинете, с заголовком Authorization: Bearer <JWT>. JWT подписан секретным ключом вашего проекта.

    Чтобы обработать запрос:

    1. Провалидируйте полученный JWT.
    2. Если валидация прошла успешно, декодируйте JWT и убедитесь, что в его структуре есть поля из таблицы ниже. Для декодирования вы можете использовать библиотеку.

    ПолеТипОписание
    expUnix TimestampДата и время истечения JWT. Срок жизни JWT — 7 минут.
    iatUnix TimestampДата и время выдачи JWT.
    issstringСервис, подписавший JWT: https://login.xsolla.com.
    request_typestringКонстанта: gateway_request.
    xsolla_login_project_idstring (UUID)ID вашего варианта авторизации в Личном кабинете.

    Пример полезных данных токена:

    Copy
    Full screen
    Small screen

    {
      "exp": 1573635020,
      "iat": 1573634600,
      "iss": "https://login.xsolla.com",
      "request_type": "gateway_request",
      "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
    }

    Прогресс интеграции
    Спасибо за обратную связь!

    Продолжить чтение

    Последнее обновление: 22 марта 2022

    Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

    Сообщите о проблеме
    Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
    Укажите email-адрес, чтобы мы могли связаться с вами
    Спасибо за обратную связь!