Перейти к основному содержимому

Операции самообслуживания

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

  • изменение пароля,
  • подтверждение измененного контакта,
  • добавление нового контакта,
  • добавление и удаление учетной записи.

Чтобы повысить уровень безопасности, дополнительно подтверждаются отправкой кода все операции, кроме:

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

Пользователь может одновременно выполнять до пяти однотипных операций самообслуживания, требующих аутентификации (например, добавление нового контакта). Каждая операция завершается собственным кодом подтверждения. При завершении одной из операций все остальные операции того же типа будет невозможно завершить.

Все необходимые изменения пользователь может выполнять на странице самообслуживания, доступной по адресу путь-к-приложению/self-service:

Страница самообслуживания

Алгоритм выполнения операций самообслуживания​

Вы также можете реализовать свой сценарий использования этих операций. Выполнение операций происходит по следующему алгоритму:

  1. Пользователь инициирует процесс выполнения операции (например, нажатием на кнопку в форме).
  2. Приложение проверяет данные и в случае успеха отправляет код подтверждения через сервис отправки кодов.
  3. Пользователь получает код и каким-либо образом передает его приложению (например, вводит в поле ввода).
  4. Приложение проверяет код и в зависимости от результата предлагает отправить код повторно через определенный временной интервал или подтверждает выполняемую операцию.
примечание

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

Объектная модель для реализации самообслуживания пользователей​

Для реализации операций самообслуживания пользователей используются типы пространства имен Стд::Пользователи::Самообслуживание.

ОперацииСамообслуживания​

Тип ОперацииСамообслуживания доступен через одноименное свойство глобального контекста. С помощью его методов ДобавлениеУчетнойЗаписи() и УдалениеУчетнойЗаписи() вы можете добавить и удалить способы аутентификации:

ОперацииСамообслуживания.ДобавлениеУчетнойЗаписи(): ОперацияДобавленияУчетнойЗаписи
ОперацииСамообслуживания.УдалениеУчетнойЗаписи(): ОперацияУдаленияУчетнойЗаписи

С помощью методов ДобавлениеКонтакта() и ПодтверждениеКонтакта() можно добавить и подтвердить контакт текущего пользователя:

ОперацииСамообслуживания.ДобавлениеКонтакта(): ОперацияДобавленияКонтакта
ОперацииСамообслуживания.ПодтверждениеКонтакта(): ОперацияПодтвержденияКонтакта

Метод ИзменениеПароля() позволяет изменить пароль:

ОперацииСамообслуживания.ИзменениеПароля(): ОперацияИзмененияПароля

ОперацияДобавленияУчетнойЗаписи​

Чтобы добавить учетную запись пользователя, для объекта типа ОперацияДобавленияУчетнойЗаписи вызывается метод Выполнить() с поставщиком аутентификации, указанном в параметре.

ОперацияУдаленияУчетнойЗаписи, ОперацияДобавленияКонтакта, ОперацияПодтвержденияКонтакта, ОперацияИзмененияПароля​

Для объектов типов ОперацияУдаленияУчетнойЗаписи, ОперацияДобавленияКонтакта, ОперацияПодтвержденияКонтакта, ОперацияИзмененияПароля доступны следующие методы:

  • Начать() — создает операцию. Принимает параметры, соответствующие операции. Например, ОперацияИзмененияПароля.Начать() принимает два параметра типа Строка: СтарыйПароль и НовыйПароль.

    пер СтатусОперации = ОперацииСамообслуживания.ИзменениеПароля()
                                                 .Начать("СтарыйПароль", "НовыйПароль")

    А метод ОперацияПодтвержденияКонтакта.Начать() принимает параметры ВидКонтакта, который задает вид подтверждаемого контакта, и СпособПодтверждения, который задает способ подтверждения операции самообслуживания. Эти параметры должны соответствовать друг другу, иначе выбрасывается исключение:

    примечание

    Рекомендуется создавать операцию изменения пароля только тогда, когда вы уверены, что пользователь готов начать процесс изменения пароля (когда пользователь сам инициирует процесс), потому что при успешном вызове метода Начать() пользователю сразу же отправляется код подтверждения.

  • ПовторитьОтправкуКодаПодтверждения() — повторяет отправку кода подтверждения, если не превышено количество попыток отправки.

    пер СтатусОперации = ОперацииСамообслуживания.ИзменениеПароля()
                                                 .ПовторитьОтправкуКодаПодтверждения()
    примечание

    Можно затребовать отправку кода не более 5 раз. После пятой попытки отправка кодов блокируется на 24 часа. Зарегистрировать пользователя с заблокированным контактом нельзя.

    Если в момент вызова метода операция уже завершена, выбрасывается исключение ИсключениеНедопустимоеСостояние.

  • Подтвердить() — подтверждает операцию кодом из СМС или электронного письма. В качестве параметра принимает код подтверждения типа Строка.

    метод ПодтверждениеОперации(ОперацияПодтвержденияКонтакта: ОперацияПодтвержденияКонтакта, Код: Строка)
        ОперацияПодтвержденияКонтакта.Подтвердить(Код)
    ;

    Если операция завершена, выбрасывается исключение ИсключениеНедопустимоеСостояние.

СтатусПодтверждаемойОперацииСамообслуживания​

Все методы операций возвращают объект типа СтатусПодтверждаемойОперацииСамообслуживания, описывающий результат операции. Объект этого типа имеет следующие свойства:

А также свойства, унаследованные от родительского типа СтатусОперацииСамообслуживания:

  • ПараметрыСОшибками — соответствие между параметрами, в которых произошла ошибка, и текстом ошибки.
  • ПредыдущийШагУспешен — признак того, что предыдущий шаг завершился успешно.
  • Сообщение — описание ошибки при неуспешном выполнении операции.
  • Шаг — текущий шаг операции.
если СтатусОперации.Шаг != ШагОперацииСамообслуживания.ЗавершеноУспешно
    ВыброситьИсключениеИсполнения(СтатусОперации.Сообщение)
;

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

метод Регистрация()
    // ...
    знч Операция = ОперацииСамообслуживания.РегистрацияПользователя()
    знч СтатусОперации = Операция.Начать(...)
    если СтатусОперации.ПредыдущийШагУспешен
        Операция.Завершить()
    иначе 
        если
            СтатусОперации.ПараметрыСОшибками.СодержитКлюч(ВидПараметраОперацииСамообслуживания.Логин)
            // ...
        ;
        если 
            СтатусОперации.ПараметрыСОшибками.СодержитКлюч(ВидПараметраОперацииСамообслуживания.НовыйПароль)
            // ...
        ;
        если 
            СтатусОперации.ПараметрыСОшибками.СодержитКлюч(ВидПараметраОперацииСамообслуживания.Телефон)
            // ...
        ;
        если 
            СтатусОперации.ПараметрыСОшибками.СодержитКлюч(ВидПараметраОперацииСамообслуживания.ЭлектроннаяПочта)
            // ...
        ;
    // ...
;

ШагОперацииСамообслуживания​

Текущий шаг операции самообслуживания описывается элементами типа ШагОперацииСамообслуживания:

Самообслуживание на мобильных устройствах​

С помощью операций самообслуживания для мобильных устройств вы можете:

  • добавлять текущее мобильное устройство, с которого выполняется вход, в список доверенных устройств;
  • получать список доверенных мобильных устройств;
  • добавлять текущее устройство в список мобильных устройств, с которых можно выполнить вход, используя ПИН-код или биометрию (если поддерживается устройством);
  • отключать использование биометрии, если она включена;
  • удалять мобильные устройства из списка доверенных устройств (например, если пользователь потерял или поменял устройство).

Типы встроенного языка для реализации самообслуживания на мобильных устройствах​

Список идентификаторов и описаний доверенных устройств содержится в типе ОписаниеПользователяСервиса в свойстве ДоверенныеУстройства.

Доверенные устройства описывает тип Пользователи.ДоверенноеУстройствоПользователя. Он содержит следующие свойства:

  • Ид — уникальный идентификатор;
  • Описание — описание устройства (обычно это модель телефона/устройства);
  • ВидПлатформы — вид операционной системы, используемой на устройстве;
  • ИспользуетсяБиометрия — флаг, показывающий, используется ли биометрия на устройстве (значение определяется только по наличию публичного ключа для биометрии без учета значения свойства КлиентскоеУстройство.ДоступнаБиометрия);
  • ИспользуетсяПинКод — флаг, показывающий, установлен ли ПИН-код на устройстве (определяется по наличию публичного ключа для ПИН-кода).

Чтобы разрешить использование биометрии на устройстве, используйте свойство ДоступнаБиометрия типа КлиентскоеУстройство.

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

Все операции выполняются с помощью методов Выполнить().

Пример добавления текущего устройства в список доверенных устройств
метод ДобавитьТекущееУстройствоВСписокДоверенныхУстройств(Источник: Кнопка, Событие: СобытиеПриНажатии)
    пер ОперацияДобавления = ОперацииСамообслуживания.ДобавлениеДоверенногоУстройства()
    пер СтатусОперации = ОперацияДобавления.Выполнить()
    ОбработкаСтатусаОперации(СтатусОперации)
;


метод ОбработкаСтатусаОперации(СтатусОперации: СтатусОперацииСамообслуживания)
    если СтатусОперации.Шаг == ШагОперацииСамообслуживания.ЗавершеноУспешно
        // Обработка события при добавлении устройства
    иначе
        выбросить новый ИсключениеВыполнения(СтатусОперации.Сообщение)
    ;
;

Пример экрана входа для мобильного устройства:

Пример экрана входа для мобильного устройства

Последнее обновление