Запуск авторизации по сбер id

Создание и использование СБЕР ID

Сервис Сбербанка предоставляет удобный сервис под названием Сбер ID, который позволяет клиентам использовать свой телефонный номер в качестве единого идентификатора. Этот идентификатор может использоваться для быстрого входа на различные сайты и в приложения. В этой статье мы рассмотрим, как создать СБЕР ID, как им пользоваться и какие преимущества это дает клиентам.

Что такое Сбер ID и как им пользоваться

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

Процесс создания и использования Сбер ID

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

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

• Сбербанк Онлайн: вход через интернет-банк.
• Телефон: использование номера телефона клиента.
• Дебетовая карта: привязка карты для входа.
• QR-код: сканирование QR-кода для входа.

Преимущества использования Сбер ID

Используя Сбер ID, клиенты могут легко входить на сайты и в приложения партнерских компаний Сбербанка. Это более чем 170 ресурсов, включая такие известные сайты, как Мегамаркет, Okko, Еаптека, Литрес, Самокат, СберМаркет и другие. Плюсом является возможность хранить данные карт всех банков в зашифрованном виде и быстро совершать платежи без необходимости каждый раз вводить данные карты.

Добавление кнопки Войти по Сбер ID

С 28 августа 2023 года начиная с версии 3.0.0 добавлен новый способ инициализации SDK SberIDInitializer.initialize. Используя этот метод, можно больше не передавать clientId через верстку или конструктор. Данный метод в будущем станет обязательным, поэтому уже сейчас можно начинать переходить на него.

Теперь вы знаете, как создать и использовать Сбер ID, а также какие преимущества это дает клиентам банка и его партнеров.

*Метод инициализирует SDK.

Его необходимо вызвать при создании вашего Application и передать два параметра application и client_id.

Добавление в xml разметке

Кнопка автоматически устанавливает иконку Сбербанка, текст, шрифт, цвет по указанным в атрибутах значениям либо значениями по умолчанию. Высота кнопки ограничена интервалом 28dp-64dp, при установке высоты, выходящей за пределы интервала, высота будет автоматически приведена в соответствующей границе. Ширина кнопки имеет минимальное значение, исходя из размеров выбранного текста, логотипа и отступов. Максимальная ширина кнопки не ограничена.

Вам остается только добавить:

Начиная с версии SDK 2.0.0 в разметке кнопки нужно указывать идентификатор партнера. Для этого передавайте новый атрибут app:clientId со строковым значением. Переданное значение используется для более корректного сбора и анализа метрик по событиям, происходящим в рамках процесса авторизации по Сбер ID, а также выполнения фоновых проверок на допустимость выполнения самой авторизации. При неуспешном прохождении такой проверки кнопка авторизации будет скрыта от пользователя, подробнее см. пункт Проверка на допустимость авторизации по Сбер ID

Подробную информацию о стиле кнопок вы найдете в руководстве по дизайну Сбер ID.

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

Добавление через конструктор

Начиная с версии 2.4.0 появилась возможность создавать кнопку через конструктор, без xml. Данный способ актуален для партнеров, которые используют мультиплатформенные фреймворки, например Flutter.

Параметр	Описание
id приложения партнера	номер приложения партнера
размер кнопки в dp	размер кнопки в dp
размер кнопки в dp	размер кнопки в dp
тип кнопки	Enum класс ButtonType
текст кнопки	Enum класс ButtonType
скругление кнопки в dp	радиус скругления
цвет граней для белой кнопки	цвет обводки
загрузка со старта	true/false
Описание Enum класса для типа кнопки	Зеленная кнопка, Белая кнопка
Описание Enum класса для текста кнопки	Сбер ID, Продолжить с Сбер ID, Заполнить с Сбер ID

Далее добавляем ее в иерархию виджетов

Кастомизация кнопки

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

Для изменения стиля кнопки, укажите параметр в xml кнопки app:buttonType=значение из списка.

Значение white_type соответствует белой кнопке с серой обводкой:

Обводка

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

При установке цвета обводки для стандартной зеленой кнопки значение будет проигнорировано.

Скругление

Для изменения скругления кнопки, укажите параметр в xml кнопки app:buttonCornerRadius=значение_dp. Предопределенные значения corner_small и corner_large соответствуют 4 и 32 dp соответственно. Есть возможность указать здесь собственное значение радиуса скругления в dp.

Текст

Для изменения текста кнопки, укажите параметр в xml кнопки app:buttonText=значение из списка.

Персонализация кнопки

Начиная с версии SDK 1.2.0 кнопка входа по Сбер ID автоматически поддерживает персонализацию при выполнении следующих условий:

Дополнительных действий от разработчиков при интеграции этой версии SDK не требуется.

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

Если персонализация на стороне МП СБОЛ отключена либо на устройстве не установлено МП СБОЛ либо процедура персонализации завершилась неуспешно, текст на кнопке будет отображаться тот, который вы указали в разметке при ее добавлении.

При запуске процедуры персонализации на кнопке отображается индикатор загрузки.

После завершения персонализации кнопка выглядит следующим образом:

Если имя пользователя слишком длинное, чтобы уместиться в отведенное размерами кнопки место, итоговый текст будет автоматически обрезан с правой стороны:

Управление статусом загрузки

Начиная с версии SDK 1.3.5 появилась возможность вручную программно управлять статусом загрузки в кнопке (анимированное лого СберБанка, как в разделе Персонализация кнопки).

Это может быть полезно, если перед тем, как дать возможность пользователю нажать на кнопку, вам необходимо например сделать запрос на сервер и получить oidc-параметры для авторизации по Сбер ID. Либо уже после запуска авторизации дождаться результата ее выполнения. При ручной установке статуса загрузки кнопка перестает реагировать на нажатия, при снятии – начинает.

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

Предусмотрено два варианта управления статусом:

• Установить актуальный статус индикатора загрузки в кнопке
• В слуачае установки статуса загрузки стартует анимация, текст в кнопке зануляется
• В случае отмены статуса загрузки анимация останавливается, в кнопке отображается
• стандартный/персонализированный текст, либо продолжается анимация до завершения работы процедуры персонализации

issued_by:Орган выдавший документ,

issued_by:рога и копыта,

number:00 00 00000