Как интегрировать Babka Login
Как это работает
Вы можете добавить на ваш сайт возможность аутентификации пользователя через Babka Login — с помощью аккаунта пользователя в Babka. Существуют следующие способы интеграции:
- Кнопка Babka Accounts. В этом случае:
- Не нужно создавать и настраивать проект Авторизации Иксолла в Личном кабинете.
- Необходимо на серверной стороне вашего приложения реализовать обмен кода авторизации на авторизационный токен пользователя.
- Babka Login как социальная сеть в виджете Авторизации Иксолла. В этом случае:
- Необходимо создать и настроить проект Авторизации Иксолла в Личном кабинете.
- Вы сразу получаете авторизационный токен пользователя на вашем сайте.
Интеграция кнопки Babka Accounts
Чтобы интегрировать кнопку Babka Login:
- Создайте клиент Babka Login OAuth 2.0.
- Интегрируйте кнопку Babka Accounts на стороне вашего приложения.
- Реализуйте получение авторизационный токена пользователя.
Создание клиента Babka Login OAuth 2.0
Чтобы создать клиент Babka OAuth 2.0:
- Свяжитесь с аккаунт-менеджером проекта и предоставьте следующие данные:
Параметр | Тип | Пример | Описание |
---|---|---|---|
Redirect URIs | Массив строк | [“https://example.com/oauth/callback”, “http://localhost:3000/oauth/callback”] | Список URI-адресов, которые могут быть использованы для перенаправления пользователя после аутентификации через Babka Login. |
Audience | Строковый | “https://example.com” | Домен, на котором будет использоваться аутентификация через Babka Login. |
Scope | Массив строк | [“email”, “transactions”] | Список разрешений Babka. |
- Интеграционная команда Иксоллы создаст клиент Babka Login OAuth 2.0 для вас и предоставит его идентификатор и секретный ключ. Эти данные необходимы для получения авторизационного токена пользователя.
Интеграция кнопки Babka Accounts на стороне приложения
Интегрируйте кнопку Babka Accounts на стороне вашего приложения с помощью Babka Login SDK.
Получение авторизационного токена пользователя
После авторизации на стороне Babka Login, пользователь будет переадресован на URI-адрес, указанный в параметре redirect_uri
. Чтобы получить авторизационный токен пользователя, воспользуйтесь инструкцией. Чтобы обновить авторизационный токен пользователя по истечении срока его действия, воспользуйтесь инструкцией.
Интеграция Babka Login как социальной сети
Чтобы интегрировать Babka Login как социальную сеть:
- Создайте клиент Babka Login OAuth 2.0.
- Интегрируйте виджет авторизации.
- Подключите Babka Login как социальную сеть.
- Реализуйте получение авторизационного токена пользователя.
Создание клиента Babka Login OAuth 2.0
Чтобы создать клиент Babka Login OAuth 2.0:
- Создайте проект в Личном кабинете.
- Настройте вариант авторизации в Личном кабинете.
- Свяжитесь с аккаунт-менеджером проекта и предоставьте следующие данные:
Параметр | Тип | Пример | Описание |
---|---|---|---|
Redirect URIs | Массив строк | [“https://example.com/oauth/callback”, “http://localhost:3000/oauth/callback”] | Список URI-адресов, которые могут быть использованы для перенаправления пользователя после аутентификации через Babka Login. |
Audience | Строковый | “https://example.com” | Домен, на котором будет использоваться аутентификация через Babka Login. |
Scope | Массив строк | [“email”, “transactions”] | Список разрешений Babka. |
- Интеграционная команда Иксоллы создаст клиент Babka Login OAuth 2.0 для вас и предоставит его идентификатор и секретный ключ. Эти данные необходимы для получения авторизационного токена пользователя.
Интеграция виджета авторизации
Интегрируйте виджет Авторизации Иксолла с помощью SDK.
Подключение Babka Login как социальной сети
- Откройте ваш проект в Личном кабинете и перейдите в раздел Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Настройки аутентификации и выберите раздел Авторизация через социальные сети.
- В списке социальных сетей найдите панель Babka.
- Нажмите значок ⚙ и выберите пункт Настройки.
- Заполните следующие поля:
- ID приложения — идентификатор клиента Babka Login OAuth 2.0, который вы получили от Иксоллы.
- Секретный ключ приложения — ключ Babka Login OAuth 2.0, который вы получили от Иксоллы.
- Разрешенные ресурсы — сайт, с которого будут приходить запросы на обмен кода авторизации на авторизационный токен пользователя. Укажите тот же URL-адрес, который был указан в качестве параметра Audience при создании клиента Babka Login OAuth 2.0.
- Нажмите Подключить.
- Включите использование всплывающего окна Babka Login (опционально):
- Перейдите к блоку Настройки аутентификации и выберите раздел Настройки Callback URL.
- В поле Callback URL введите
https://login-widget.xsolla.com/latest/babka-auth-succeed
. - В коде виджета передайте значение
true
в параметреbabkaLoginPopup
, в параметреcallbackUrl
передайте URL-адрес страницы, на которую необходимо перенаправить пользователя после аутентификации.
Пример кода виджета:
- js
import { Widget } from '@xsolla/login-sdk';
const xl = new Widget({
projectId: '[Login ID]',
preferredLocale: 'en_US',
babkaLoginPopup: true,
callbackUrl: '[Your Callback URL]',
});
- Добавьте кнопку Babka Account на сайт.
Пример кода для кнопки Babka Accounts:
- html
<div id="xl_auth"></div>
<button onclick="xl.open()">Babka Login Popup</button>
Получение авторизационного токена пользователя
После авторизации на стороне Babka Login, пользователь будет переадресован на URL-адрес, указанный в параметре callback_url
. В параметре token
передается авторизационный токен пользователя.
Чтобы внутри авторизационного токена пользователя передавать токен Babka Login OAuth:
- Откройте ваш проект в Личном кабинете и перейдите в раздел Авторизация.
- Нажмите Настроить в панели нужного варианта авторизации.
- Перейдите к блоку Настройки аутентификации и выберите раздел Авторизация через социальные сети.
- Установите переключатель Встраивать JWT токен социальной сети в положение Вкл.
- Нажмите Сохранить изменения.
Была ли статья полезна?
Оценить страницу
В другой раз
Спасибо за обратную связь!
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.