ym88659208ym87991671
Доработки сайта партнера для поддержки sbol2web | Документация для разработчиков

Доработки сайта партнера для поддержки sbol2web

Обновлено 17 апреля 2024

1. МП Сбол открывает сайт партнера

МП СБОЛ добавляет к ссылке на сайт партнера параметр sberIDRedirect (в значении указывается хост deeplink для вызова МП СБОЛ), открывает ее во встроенном браузере.

https://partner.ru/auth?
type=auto
&to=%2Fcatalog
&sberIdRedirect=sberbankidlogin%3A%2F%2Fsberbankidsso
&token=dn1j2n3jn123j21n3

Если МП СБОЛ поддерживает sbol2web new (сценарий поддерживается, начиная с версий iOS 14.18, Android 14.18). Сбер ID проверяет в МП СБОЛ наличие у пользователя оферты Удобный доступ (УД). Если оферта УД не принята, то пользователю отображается экран принятия оферты (ссылка на оферту, кнопка Подтвердить), пользователь подтверждает оферту

2. Партнер запускает авторизацию по Sber ID

Сервис аутентификации партнера анализирует ссылку на наличие параметров sberIDRedirect. Если в ссылке есть параметр sberIDRedirect, то сервис аутентификации партнера использует значение этого параметра в качестве хоста: {значение параметра sberIDRedirect}{oidc-параметры, в т.ч. тут же state} и формирует обратную ссылку для авторизации по Сбер ID.

[Значение из параметра sberIDRedirect]?
scope=openid name phones email
&token=[значение из параметра token]
&client_id=*******-EEA3-D4EC-C535-A12A618A4C3C
&response_type=code
&state=UhdlDQS6vG4m
&nonce=TGfhfBxr5ak1
&redirect_uri=https%3A%2F%2Fpartner.ru%2Fauth%3Futm_source%3DQwerty_478Qwerty_478Qwerty_478Qwerty_478Qwerty_4789%26utm_medium%3DAsdfgh_123%26utm_campaign%3DZxcvbn_789

Если webLink содержит параметр to, то партнер сохраняет это значение в связке со state. Сохранять можно на своем backend или в своей cookie. Это нужно, чтобы после успешной аутентификации направить пользователя туда, куда он шел изначально (до старта аутентификации)

Значение параметра sberIDRedirect может динамически меняться, в зависимости от сценария и версии МП Сбол! Не завязывайтесь на какое-то конкретное значение этого параметра.

Партнер автоматически (без клика и действий пользователя) запускает полученную ссылку

4. Аутентификацию пользователя в МП Сбол

МП СБОЛ (Сбер ID) выполняет аутентификацию пользователя и открывает во встроенном браузере сайт партнера (адрес, указанный в redirect_uri) и параметры state и code.

   https://partner.ru/auth?
utm_source=Qwerty_478Qwerty_478Qwerty_478Qwerty_478Qwerty_4789
&utm_medium=Asdfgh_123
&utm_campaign=Zxcvbn_789
&code=qwdjwqe1j2321j3
&state=adh321h32h13

По значению state восстанавливается значение to и по его значению направляет пользователя в целевой раздел. Пример: https://partner.ru/catalog

Если МП СБОЛ не поддерживает sbol2web new (версий до iOS 14.18, Android 14.18), на этом шаге пользователь вернется в МП СБол для проверки наличия оферты Удобный доступ (УД). Если оферта УД не принята, то пользователю отображается экран принятия оферты (ссылка на оферту, кнопка Подтвердить), пользователь подтверждает оферту

5. Партнер авторизован

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

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.