Сбор email-адресов при аутентификации через социальные сети

Как это работает

Большинство социальных сетей не передают информацию о email-адресах пользователей. Вы можете собирать эти данные с помощью продукта Авторизации и использовать их, чтобы:

  • экспортировать пользователей в ваш аккаунт Mailchimp и добавлять их в новостные рассылки;
  • дать пользователям возможность сбрасывать пароль и проходить аутентификацию как через email-адрес и пароль, так и через аккаунт социальной сети.

Note: Если у вас подключен продукт Лаунчер Иксолла, сбор email-адресов будет происходить автоматически.

Для кого подходит

Для партнеров, у которых уже интегрирован продукт Авторизация и есть пользователи с аутентификацией через социальные сети.

Как настроить

В зависимости от выбранного варианта интеграции продукта Авторизация, вы можете настроить сбор email-адресов одним из следующих способов:

Сбор email-адресов через виджет авторизации

Для версии виджета 2.0 вы можете дополнительно запрашивать email-адреса после регистрации через социальные сети. Чтобы настроить запрос email-адресов:

  1. Перейдите в Личный кабинет в раздел ваш вариант авторизации > Общие настройки > Настройки аутентификации.
  2. Установите переключатель Всегда собирать email пользователя при регистрации в положение Вкл.

Для предыдущей версии виджета:

  • При использовании методов API по стандарту JWT добавьте параметр fields=email в код инициализации:

Copy
Full screen
Small screen
<script type="text/javascript">
XL.init({
  projectId: '[Login ID]',
  callbackUrl: '[callbackUrl]',
  locale: 'en_US',
  fields: 'email'
});
</script>

  • При использовании методов API по протоколу OAuth 2.0 добавьте параметр scope=email в код инициализации:

Copy
Full screen
Small screen
<script type="text/javascript">
XL.init({
  projectId: '[Login ID]',
  locale: 'en_US',
  clientId: [client_id],
  responseType: 'code',
  scope: 'email',
  state: [custom_state],
  redirectUri: [redirect_uri]
});

Сбор email-адресов через методы API

Если у вас настроена интеграция через методы API:

  • При использовании метода Auth via Social Network по стандарту JWT добавьте параметр fields=email.

Пример запроса:

Copy
Full screen
Small screen
GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url}

  • При использовании метода Auth via Social Network по протоколу OAuth 2.0 добавьте параметр scope=email.

Пример запроса:

Copy
Full screen
Small screen
GET https://login.xsolla.com/api/oauth2/social/{providerName}/login_redirect?scope=email&client_id={client_id}&redirect_uri={redirect_uri}&state={state}&response_type=code