ru.cryptopro.mykey.sdk.v1

Class UsersManager

java.lang.Object

_CallbackInvoker

ru.cryptopro.mykey.sdk.v1.UsersManager

public final class UsersManager
extends _CallbackInvoker

Класс для управления объектами User (регистрация, подтверждение профиля, установка/смена пароля и т.д.).

Constructor Summary

Constructors

Constructor and Description
UsersManager()

Method Summary

Modifier and Type	Method and Description
static void	acceptAccountChanges(Activity parentActivity, User user, UserCallback callback) Выполняет подтверждение присоединения мобильного устройства к учётной записи.
static void	acceptAccountChanges(User user, UserCallback callback) Выполняет подтверждение присоединения мобильного устройства к учётной записи.
static void	changePassword(Activity parentActivity, User user, boolean requirePassword, boolean shouldUpdatePolicy, UserCallback callback) Меняет способ защиты "вектора аутентификации". Запускает последовательность экранов, включающих: Экран ввода текущего пароля или отпечатка пальца. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.
static void	changePassword(User user, boolean requirePassword, boolean shouldUpdatePolicy, UserCallback callback) Меняет способ защиты "вектора аутентификации". Запускает последовательность экранов, включающих: Экран ввода текущего пароля или отпечатка пальца, если на момент вызова выполняется условие User.isReadyToSign() == false. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.
static void	changePassword(User user, boolean requirePassword, UserCallback callback) Меняет способ защиты "вектора аутентификации". Запускает последовательность экранов, включающих: Экран ввода текущего пароля или отпечатка пальца, если на момент вызова выполняется условие User.isReadyToSign() == false. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.
static void	checkApprovalStatus(Activity parentActivity, User user, boolean checkOnly, float checkingInterval, UserCallback callback) Отправляет запрос на получение сведений о статусе регистрации нового устройства пользователя
static void	checkApprovalStatus(User user, boolean checkOnly, float checkingInterval, UserCallback callback) Отправляет запрос на получение сведений о статусе регистрации нового устройства пользователя
static void	checkApprovalStatus(User user, boolean checkOnly, UserCallback callback) Отправляет запрос на получение сведений о статусе регистрации нового устройства пользователя без автоматической периодической проверки
static void	createUser(Activity parentActivity, java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String serviceUrl, java.lang.String deviceName, PushNotificationData pushData, boolean requirePassword, UserCallback callback) Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней. Запускает последовательность экранов SDK, выполняющих: Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static void	createUser(java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String serviceUrl, java.lang.String deviceName, PushNotificationData pushData, boolean requirePassword, UserCallback callback) Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней. Запускает последовательность экранов SDK, выполняющих: Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static void	createUserWithApproval(Activity parentActivity, java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String serviceUrl, java.lang.String deviceName, PushNotificationData pushData, java.lang.String uid, float checkingInterval, boolean requirePassword, UserCallback callback) Создание запроса на подключение другого устройства к учётной записи пользователя. Запускает процесс добавления устройства, где в ответ на данный запрос формирует "вектор аутентификации" и передаёт его на данное устройство. Подтверждение с другого устройства выполняется через получение списка устройств методом DevicesManager.listDevices(User, DevicesNetworkCallback), нахождением в списке устройства с заданным kid и вызовом методов DevicesManagerNonQual.approve(User, Device, NetworkCallback) или DevicesManagerNonQual.reject(User, Device, NetworkCallback) для подтверждения или отклонения запроса на регистрацию соответственно. После выполнения метода выполняется условие User.isReadyToSign() == true, созданная учетная запись имеет статус Device.DeviceStatus.ApproveRequired. Запускает последовательность экранов SDK, выполняющих: Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static void	createUserWithApproval(java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String serviceUrl, java.lang.String deviceName, PushNotificationData pushData, java.lang.String uid, boolean requirePassword, UserCallback callback) Создание запроса на подключение другого устройства к учётной записи пользователя без автоматической проверки статуса
static void	createUserWithApproval(java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String serviceUrl, java.lang.String deviceName, PushNotificationData pushData, java.lang.String uid, float checkingInterval, boolean requirePassword, UserCallback callback) Создание запроса на подключение другого устройства к учётной записи пользователя. Запускает процесс добавления устройства, где в ответ на данный запрос формирует "вектор аутентификации" и передаёт его на данное устройство. Подтверждение с другого устройства выполняется через получение списка устройств методом DevicesManager.listDevices(User, DevicesNetworkCallback), нахождением в списке устройства с заданным kid и вызовом методов DevicesManagerNonQual.approve(User, Device, NetworkCallback) или DevicesManagerNonQual.reject(User, Device, NetworkCallback) для подтверждения или отклонения запроса на регистрацию соответственно. После выполнения метода выполняется условие User.isReadyToSign() == true, созданная учетная запись имеет статус Device.DeviceStatus.ApproveRequired. Запускает последовательность экранов SDK, выполняющих: Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static void	createUserWithInitQR(Activity parentActivity, java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String deviceName, PushNotificationData pushData, boolean requirePassword, QRCodeKinit QRCodeKinit, UserCallback callback) Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней. Для запроса на регистрацию используется Kinit, полученный из QR-кода. Запускает последовательность экранов SDK, выполняющих: Запуск сканера QR-кодов (может быть пропущен, если задан QrCodeKinit) Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static void	createUserWithInitQR(java.lang.String externalId, java.lang.String alias, java.lang.String name, java.lang.String deviceName, PushNotificationData pushData, boolean requirePassword, QRCodeKinit QRCodeKinit, UserCallback callback) Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней. Для запроса на регистрацию используется Kinit, полученный из QR-кода. Запускает последовательность экранов SDK, выполняющих: Запуск сканера QR-кодов (может быть пропущен, если задан QrCodeKinit) Запрос политик сервера Запрос пароля и отпечатка с проверкой парольной политики: NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2).
static Error	delete(User user) Удаление объекта пользователя из хранилища
static void	getOperationsHistory(User user, int count, int bookmark, int[] operationCodes, OperationsHistoryCallback callback) Получение истории операций пользователя на сервисе
static java.util.List<User>	listStorage() Deprecated.
static void	listStorage(UsersCallback callback) Перечисление доступных в долгосрочной памяти объектов User. Для каждого объекта User.isReadyToSign() == false, кроме случаев, когда объект создавался без предъявления пароля.
static Error	rename(User user, java.lang.String newName) Смена названия объекта User в хранилище устройства
static void	renew(Activity parentActivity, User user, java.lang.String newName, java.lang.String deviceName, UserCallback callback) Перерегистрация пользователя на этом же устройстве.
static void	renew(User user, java.lang.String newName, java.lang.String deviceName, UserCallback callback) Перерегистрация пользователя на этом же устройстве.
static void	revoke(Activity parentActivity, User user, UserCallback callback) Отзыв "вектора аутентификации" на сервере.
static void	revoke(User user, UserCallback callback) Отзыв "вектора аутентификации" на сервере.
static void	submitPassword(Activity parentActivity, User user, UserCallback callback) Предъявление пароля на "вектор аутентификации". Запускает экран ввода пароля или отпечатка пальца.
static void	submitPassword(User user, UserCallback callback) Предъявление пароля на "вектор аутентификации". Запускает экран ввода пароля или отпечатка пальца.
static void	updateDeviceInfo(User user, PushNotificationData pushNotificationData, java.lang.String deviceName, UserCallback callback) Обновление информацию об устройстве на сервере
static void	updateStatus(User user, UserCallback callback) Обновление статуса пользователя.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UsersManager

public UsersManager()

Method Detail

createUser

public static void createUser(java.lang.String externalId,
                              java.lang.String alias,
                              java.lang.String name,
                              java.lang.String serviceUrl,
                              java.lang.String deviceName,
                              PushNotificationData pushData,
                              boolean requirePassword,
                              UserCallback callback)

Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней.
Запускает последовательность экранов SDK, выполняющих:

1. Запрос политик сервера
2. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
3. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
4. Сохранение объекта User в хранилище Shared Preferences

После выполнения метода выполняется условие User.isReadyToSign() == false, созданная учетная запись имеет статус Device.DeviceStatus.Installed.

Parameters:

externalId - Идентификатор сущности вызывающего приложения, к которому будет "привязан" объект. Если настройки сервера запрещают задание этого параметра на стороне мобильного приложения, то следует передать значение null

alias - Удобочитаемый идентификатор устройства. Допустима передача значения null

name - Имя ключа для использования внутри приложения (не передаётся на сервер)

serviceUrl - URL для взаимодействия с сервером my

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

createUser

public static void createUser(Activity parentActivity,
                              java.lang.String externalId,
                              java.lang.String alias,
                              java.lang.String name,
                              java.lang.String serviceUrl,
                              java.lang.String deviceName,
                              PushNotificationData pushData,
                              boolean requirePassword,
                              UserCallback callback)

Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней.
Запускает последовательность экранов SDK, выполняющих:

1. Запрос политик сервера
2. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
3. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
4. Сохранение объекта User в хранилище Shared Preferences

После выполнения метода выполняется условие User.isReadyToSign() == false, созданная учетная запись имеет статус Device.DeviceStatus.Installed.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

externalId - Идентификатор сущности вызывающего приложения, к которому будет "привязан" объект. Если настройки сервера запрещают задание этого параметра на стороне мобильного приложения, то следует передать значение null

alias - Удобочитаемый идентификатор устройства. Допустима передача значения null

name - Имя ключа для использования внутри приложения (не передаётся на сервер)

serviceUrl - URL для взаимодействия с сервером my

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

createUserWithInitQR

public static void createUserWithInitQR(java.lang.String externalId,
                                        java.lang.String alias,
                                        java.lang.String name,
                                        java.lang.String deviceName,
                                        PushNotificationData pushData,
                                        boolean requirePassword,
                                        QRCodeKinit QRCodeKinit,
                                        UserCallback callback)

Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней.
Для запроса на регистрацию используется Kinit, полученный из QR-кода.
Запускает последовательность экранов SDK, выполняющих:

1. Запуск сканера QR-кодов (может быть пропущен, если задан QrCodeKinit)
2. Запрос политик сервера
3. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
4. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
5. Сохранение объекта User в хранилище Shared Preferences

После выполнения метода выполняется условие User.isReadyToSign() == false, созданная учетная запись имеет статус Device.DeviceStatus.NotVerified.

Parameters:

externalId - Желаемое имя пользователя (login), имя пользователя может быть использовано вызывающей системой для управления учётной записью пользователя. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

alias - Уникальный человекочитаемый идентификатор, используемый для подтверждения владения МУ пользователем. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

QRCodeKinit - Данные из QR-кода, содержащего информацию о ключе KInit, либо null, тогда будет запущен экран сканера QR-кодов

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError.

createUserWithInitQR

public static void createUserWithInitQR(Activity parentActivity,
                                        java.lang.String externalId,
                                        java.lang.String alias,
                                        java.lang.String name,
                                        java.lang.String deviceName,
                                        PushNotificationData pushData,
                                        boolean requirePassword,
                                        QRCodeKinit QRCodeKinit,
                                        UserCallback callback)

Создание "неподтвержденной" учетной записи с получением "вектора аутентификации" к ней.
Для запроса на регистрацию используется Kinit, полученный из QR-кода.
Запускает последовательность экранов SDK, выполняющих:

1. Запуск сканера QR-кодов (может быть пропущен, если задан QrCodeKinit)
2. Запрос политик сервера
3. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
4. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
5. Сохранение объекта User в хранилище Shared Preferences

После выполнения метода выполняется условие User.isReadyToSign() == false, созданная учетная запись имеет статус Device.DeviceStatus.NotVerified.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

externalId - Желаемое имя пользователя (login), имя пользователя может быть использовано вызывающей системой для управления учётной записью пользователя. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

alias - Уникальный человекочитаемый идентификатор, используемый для подтверждения владения МУ пользователем. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

QRCodeKinit - Данные из QR-кода, содержащего информацию о ключе KInit, либо null, тогда будет запущен экран сканера QR-кодов

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

createUserWithApproval

public static void createUserWithApproval(java.lang.String externalId,
                                          java.lang.String alias,
                                          java.lang.String name,
                                          java.lang.String serviceUrl,
                                          java.lang.String deviceName,
                                          PushNotificationData pushData,
                                          java.lang.String uid,
                                          boolean requirePassword,
                                          UserCallback callback)

Создание запроса на подключение другого устройства к учётной записи пользователя без автоматической проверки статуса

See Also:

createUserWithApproval(String, String, String, String, String, PushNotificationData, String, float, boolean, UserCallback)

createUserWithApproval

public static void createUserWithApproval(java.lang.String externalId,
                                          java.lang.String alias,
                                          java.lang.String name,
                                          java.lang.String serviceUrl,
                                          java.lang.String deviceName,
                                          PushNotificationData pushData,
                                          java.lang.String uid,
                                          float checkingInterval,
                                          boolean requirePassword,
                                          UserCallback callback)

Создание запроса на подключение другого устройства к учётной записи пользователя.
Запускает процесс добавления устройства, где в ответ на данный запрос формирует "вектор аутентификации" и передаёт его на данное устройство.
Подтверждение с другого устройства выполняется через получение списка устройств методом DevicesManager.listDevices(User, DevicesNetworkCallback), нахождением в списке устройства с заданным kid и вызовом методов DevicesManagerNonQual.approve(User, Device, NetworkCallback) или DevicesManagerNonQual.reject(User, Device, NetworkCallback) для подтверждения или отклонения запроса на регистрацию соответственно.
После выполнения метода выполняется условие User.isReadyToSign() == true, созданная учетная запись имеет статус Device.DeviceStatus.ApproveRequired.
Запускает последовательность экранов SDK, выполняющих:

1. Запрос политик сервера
2. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
3. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
4. Сохранение объекта User в хранилище Shared Preferences
5. Отображение QR-кода для сканирования устройством, с которого будет выполняться подтверждение регистрации

Parameters:

externalId - Желаемое имя пользователя (login), имя пользователя может быть использовано вызывающей системой для управления учётной записью пользователя. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

alias - Уникальный человекочитаемый идентификатор, используемый для подтверждения владения МУ пользователем. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

serviceUrl - URL для взаимодействия с my

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

uid - Идентификатор добавляемого девайса

checkingInterval - Если задано ненулевое значение, то статус регистрации устройства будет проверяться каждые checkingInterval секунд в независимости от нажатия кнопки проверки статуса. Значение 0 указывает, что фоновая проверка статуса осуществляться не будет

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

createUserWithApproval

public static void createUserWithApproval(Activity parentActivity,
                                          java.lang.String externalId,
                                          java.lang.String alias,
                                          java.lang.String name,
                                          java.lang.String serviceUrl,
                                          java.lang.String deviceName,
                                          PushNotificationData pushData,
                                          java.lang.String uid,
                                          float checkingInterval,
                                          boolean requirePassword,
                                          UserCallback callback)

Создание запроса на подключение другого устройства к учётной записи пользователя.
Запускает процесс добавления устройства, где в ответ на данный запрос формирует "вектор аутентификации" и передаёт его на данное устройство.
Подтверждение с другого устройства выполняется через получение списка устройств методом DevicesManager.listDevices(User, DevicesNetworkCallback), нахождением в списке устройства с заданным kid и вызовом методов DevicesManagerNonQual.approve(User, Device, NetworkCallback) или DevicesManagerNonQual.reject(User, Device, NetworkCallback) для подтверждения или отклонения запроса на регистрацию соответственно.
После выполнения метода выполняется условие User.isReadyToSign() == true, созданная учетная запись имеет статус Device.DeviceStatus.ApproveRequired.
Запускает последовательность экранов SDK, выполняющих:

1. Запрос политик сервера
2. Запрос пароля и отпечатка с проверкой парольной политики:
   • NoPolicy - Любой ПИН-код 6 цифр, количество попыток не ограничено
   • Weak - Любой ПИН-код 6 цифр, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек) 30 секунд
   • Medium - Любой ПИН-код 6 цифр + проверка по словарю, тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек, далее х2). Словарь слабых паролей (текстовый файл, одна строчка - один слабый пароль) означивается в ресурсах приложения по адресу (/raw/weak_pass.txt)
   • Strong - Пароль 8 символов: алфавит + цифры + спецсимволы:
     • Один символ в верхнем регистре
     • Один символ в нижнем регистре
     • Один спецсимвол
     • Одна цифра
     • Тайм-аут по кол-ву попыток (5 попыток без задержки, если 5 раз ввести неверный пин, то задержка 30 сек,далее при каждой неверной время х2)
   • Если парольная политика имеет значение 0 (допускается пропуск шага с заданием пароля) и requirePassword == false, то пароль не запрашивается
   • В противном случае пользователю предлагается ввести пароль
   • Если флаг KEYFLAG_DENY_STORE_WITH_OS_PROTECTION опущен, то введенный пароль предлагается зашифровать с использованием отпечатка пальца для возможности использования отпечатка в дальнейшем
3. Регистрацию ключа на сервере (отпечаток устройства, пуш-идентификатор)
4. Сохранение объекта User в хранилище Shared Preferences
5. Отображение QR-кода для сканирования устройством, с которого будет выполняться подтверждение регистрации

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

externalId - Желаемое имя пользователя (login), имя пользователя может быть использовано вызывающей системой для управления учётной записью пользователя. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

alias - Уникальный человекочитаемый идентификатор, используемый для подтверждения владения МУ пользователем. Если данный параметр отсутствует в запросе, то его значение будет создано автоматически на стороне сервера

serviceUrl - URL для взаимодействия с my

deviceName - Читаемое название устройства

pushData - Данные для получения PUSH-уведомлений

uid - Идентификатор добавляемого девайса

checkingInterval - Если задано ненулевое значение, то статус регистрации устройства будет проверяться каждые checkingInterval секунд в независимости от нажатия кнопки проверки статуса. Значение 0 указывает, что фоновая проверка статуса осуществляться не будет.

requirePassword - Требуется ли ручное задание пароля пользователем для защиты ключа

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

listStorage

@Deprecated
public static java.util.List<User> listStorage()

Deprecated.

Перечисление доступных в долгосрочной памяти объектов User.
Для каждого объекта User.isReadyToSign() == false, кроме случаев, когда объект создавался без предъявления пароля.

Returns:

Список пользователей (объект списка и входящие в список объекты всегда не null)

listStorage

public static void listStorage(UsersCallback callback)

Перечисление доступных в долгосрочной памяти объектов User.
Для каждого объекта User.isReadyToSign() == false, кроме случаев, когда объект создавался без предъявления пароля.

Parameters:

callback - UsersCallback который возвращает список пользователей (объект списка и входящие в список объекты всегда не null) либо объект Error

delete

public static Error delete(User user)

Удаление объекта пользователя из хранилища

Parameters:

user - Объект пользователя для удаления

rename

public static Error rename(User user,
                           java.lang.String newName)

Смена названия объекта User в хранилище устройства

Parameters:

user - Объект пользователя, название которого нужно изменить

newName - Новое название

Returns:

Ошибка типа Error, при успехе метод Error.getType() вернёт 0

updateStatus

public static void updateStatus(User user,
                                UserCallback callback)

Обновление статуса пользователя. Выполняет асинхронный запрос на сервер.

Parameters:

user - Объект пользователя

callback - Реализация UserCallback для обработки результатов

acceptAccountChanges

public static void acceptAccountChanges(User user,
                                        UserCallback callback)

Выполняет подтверждение присоединения мобильного устройства к учётной записи. Метод необходимо вызывать для объекта User в статусе Device.DeviceStatus.NotVerified, поэтому перед вызовом метода рекомендуется выполнить вызов updateStatus(User, UserCallback) для получения актуального статуса и данных профиля устройства. Запускает следующую последовательность экранов:

1. Экран, содержащий данные профиля учётной записи, к которой присоединяется устройство с кнопками для подтверждения и отказа.
2. Экран сканирования QR-кода, в случае когда для подтверждения изменений в профиле требуется сканирование QR-кода. В этом случае выполняется условие User.qRVerificationRequired() == true.
3. Экран запроса пароля или отпечатка пальца, если на момент нажатия кнопки подтверждения изменений выполняется условие User.isReadyToSign() == false.

Parameters:

user - Объект пользователя, для которого подтверждается присоединение устройства

callback - Реализация UserCallback для обработки результатов. В случае успеха возвращается обновленный объект User, статус которого меняется на Device.DeviceStatus.Active, если регистрация данного устройства была подтверждена на другом устройстве. Если же пользователь нажал кнопку "Не сейчас", то вернётся объект User со статусом Device.DeviceStatus.ApproveRequired.

acceptAccountChanges

public static void acceptAccountChanges(Activity parentActivity,
                                        User user,
                                        UserCallback callback)

Выполняет подтверждение присоединения мобильного устройства к учётной записи. Метод необходимо вызывать для объекта User в статусе Device.DeviceStatus.NotVerified, поэтому перед вызовом метода рекомендуется выполнить вызов updateStatus(User, UserCallback) для получения актуального статуса и данных профиля устройства. Запускает следующую последовательность экранов:

1. Экран, содержащий данные профиля учётной записи, к которой присоединяется устройство с кнопками для подтверждения и отказа.
2. Экран сканирования QR-кода, в случае когда для подтверждения изменений в профиле требуется сканирование QR-кода. В этом случае выполняется условие User.qRVerificationRequired() == true.
3. Экран запроса пароля или отпечатка пальца, если на момент нажатия кнопки подтверждения изменений выполняется условие User.isReadyToSign() == false.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект пользователя, для которого подтверждается присоединение устройства

callback - Реализация UserCallback для обработки результатов. В случае успеха возвращается обновленный объект User, статус которого меняется на Device.DeviceStatus.Active, если регистрация данного устройства была подтверждена на другом устройстве. Если же пользователь нажал кнопку "Не сейчас", то вернётся объект User со статусом Device.DeviceStatus.ApproveRequired

checkApprovalStatus

public static void checkApprovalStatus(User user,
                                       boolean checkOnly,
                                       UserCallback callback)

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

See Also:

checkApprovalStatus(User, boolean, float, UserCallback)

checkApprovalStatus

public static void checkApprovalStatus(User user,
                                       boolean checkOnly,
                                       float checkingInterval,
                                       UserCallback callback)

Отправляет запрос на получение сведений о статусе регистрации нового устройства пользователя

Parameters:

user - Объект User, для которого нужно проверить, был ли одобрен запрос на присоединение данного устройства на другом устройстве

checkOnly - Флаг необходимости показа пользовательского интерфейса. Если установлено значение true, то пользовательский интерфейс не будет показан, а будет выполнен единичный запрос статуса. Если передано false, то будет показан пользовательский интерфейс с кнопкой обновления статуса

checkingInterval - Применяется в случае, когда параметр checkOnly имеет значение false. Если задано ненулевое значение, то статус регистрации устройства будет проверяться каждые checkingInterval секунд в независимости от нажатия кнопки проверки статуса. Значение 0 указывает, что фоновая проверка статуса осуществляться не будет

callback - Реализация UserCallback для обработки результатов. При успехе возвращается объект User с обновленным статусом

checkApprovalStatus

public static void checkApprovalStatus(Activity parentActivity,
                                       User user,
                                       boolean checkOnly,
                                       float checkingInterval,
                                       UserCallback callback)

Отправляет запрос на получение сведений о статусе регистрации нового устройства пользователя

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект User, для которого нужно проверить, был ли одобрен запрос на присоединение данного устройства на другом устройстве

checkOnly - Флаг необходимости показа пользовательского интерфейса. Если установлено значение true, то пользовательский интерфейс не будет показан, а будет выполнен единичный запрос статуса. Если передано false, то будет показан пользовательский интерфейс с кнопкой обновления статуса

checkingInterval - Применяется в случае, когда параметр checkOnly имеет значение false. Если задано ненулевое значение, то статус регистрации устройства будет проверяться каждые checkingInterval секунд в независимости от нажатия кнопки проверки статуса. Значение 0 указывает, что фоновая проверка статуса осуществляться не будет

callback - Реализация UserCallback для обработки результатов. При успехе возвращается объект User с обновленным статусом

submitPassword

public static void submitPassword(User user,
                                  UserCallback callback)

Предъявление пароля на "вектор аутентификации".
Запускает экран ввода пароля или отпечатка пальца. После успешного выполнения метода метод User.isReadyToSign() возвращает true. По этой причине метод необходимо вызывать в тех случаях, когда выполнение операции требует соблюдение условия User.isReadyToSign() == true. При этом следует помнить, что все методы SDK, открывающие пользовательский интерфейс, покажут экран запроса пароля автоматически при необходимости.
Перед вызовом метода проверка условия User.isReadyToSign() == false обязательна, если условие не выполняется, будет возвращена ошибка типа Error.ERROR_PASSWORD_ALREADY_SUBMITTED.

Parameters:

user - Объект пользователя, для которого вводится пароль

callback - Реализация UserCallback для обработки результатов

submitPassword

public static void submitPassword(Activity parentActivity,
                                  User user,
                                  UserCallback callback)

Предъявление пароля на "вектор аутентификации".
Запускает экран ввода пароля или отпечатка пальца. После успешного выполнения метода метод User.isReadyToSign() возвращает true. По этой причине метод необходимо вызывать в тех случаях, когда выполнение операции требует соблюдение условия User.isReadyToSign() == true. При этом следует помнить, что все методы SDK, открывающие пользовательский интерфейс, покажут экран запроса пароля автоматически при необходимости.
Перед вызовом метода проверка условия User.isReadyToSign() == false обязательна, если условие не выполняется, будет возвращена ошибка типа Error.ERROR_PASSWORD_ALREADY_SUBMITTED.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект пользователя, для которого вводится пароль

callback - Реализация UserCallback для обработки результатов

changePassword

public static void changePassword(User user,
                                  boolean requirePassword,
                                  UserCallback callback)

Меняет способ защиты "вектора аутентификации".
Запускает последовательность экранов, включающих:

1. Экран ввода текущего пароля или отпечатка пальца, если на момент вызова выполняется условие User.isReadyToSign() == false.
2. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.

Parameters:

user - Объект пользователя, для которого необходимо сменить способ защиты

requirePassword - Если установлено значение false и парольная политика ключа позволяет сохранение без пароля, то новый пароль запрошен не будет и дальнейший доступ к "вектору аутентификации" будет осуществляться без пароля

callback - Реализация UserCallback для обработки результатов

changePassword

public static void changePassword(User user,
                                  boolean requirePassword,
                                  boolean shouldUpdatePolicy,
                                  UserCallback callback)

Меняет способ защиты "вектора аутентификации".
Запускает последовательность экранов, включающих:

1. Экран ввода текущего пароля или отпечатка пальца, если на момент вызова выполняется условие User.isReadyToSign() == false.
2. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.

Parameters:

user - Объект пользователя, для которого необходимо сменить способ защиты

requirePassword - Если установлено значение false и парольная политика ключа позволяет сохранение без пароля, то новый пароль запрошен не будет и дальнейший доступ к "вектору аутентификации" будет осуществляться без пароля

shouldUpdatePolicy - Если установлено значение true, будет запрошено значение парольной политики у сервера

callback - Реализация UserCallback для обработки результатов

changePassword

public static void changePassword(Activity parentActivity,
                                  User user,
                                  boolean requirePassword,
                                  boolean shouldUpdatePolicy,
                                  UserCallback callback)

Меняет способ защиты "вектора аутентификации".
Запускает последовательность экранов, включающих:

1. Экран ввода текущего пароля или отпечатка пальца.
2. Экран ввода нового пароля, если параметр requirePassword имеет значение false или метод User.getPasswordPolicy() возвращает ненулевое значение.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект пользователя, для которого необходимо сменить способ защиты

requirePassword - Если установлено значение false и парольная политика ключа позволяет сохранение без пароля, то новый пароль запрошен не будет и дальнейший доступ к "вектору аутентификации" будет осуществляться без пароля

shouldUpdatePolicy - Если установлено значение true, будет запрошено значение парольной политики у сервера

callback - Реализация UserCallback для обработки результатов

revoke

public static void revoke(User user,
                          UserCallback callback)

Отзыв "вектора аутентификации" на сервере. Делает вектор недействительным

Parameters:

user - Объект пользователя чей "вектора аутентификации" будет отозван

callback - При успешном выполнении не возвращает ничего. NetworkCallback Иначе возвращает ошибку

revoke

public static void revoke(Activity parentActivity,
                          User user,
                          UserCallback callback)

Отзыв "вектора аутентификации" на сервере. Делает вектор недействительным

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект пользователя чей "вектора аутентификации" будет отозван

callback - При успешном выполнении не возвращает ничего. NetworkCallback Иначе возвращает ошибку

getOperationsHistory

public static void getOperationsHistory(User user,
                                        int count,
                                        int bookmark,
                                        int[] operationCodes,
                                        OperationsHistoryCallback callback)

Получение истории операций пользователя на сервисе

Parameters:

user - Пользователь, чью историю операций нужно показать

count - Количество операций для показа

bookmark - Идентификатор записи, относительно которой осуществляется поиск

operationCodes - Список кодов операций, которые должны быть включены в выборку. Нужно передать null, если фильтрация по кодам не требуется

callback - Реализация OperationsHistoryCallback для обработки результатов. При успехе, возвращается объект OperationsHistory

updateDeviceInfo

public static void updateDeviceInfo(User user,
                                    PushNotificationData pushNotificationData,
                                    java.lang.String deviceName,
                                    UserCallback callback)

Обновление информацию об устройстве на сервере

Parameters:

user - Пользователь, для которого происходит обновление

pushNotificationData - Новые данные для получения пуш-уведомлений, или null, если данные для получения уведомлений не поменялись

deviceName - Новое имя устройства, или null, если имя устройства не поменялось

callback - Реализация UserCallback для обработки результатов

renew

public static void renew(Activity parentActivity,
                         User user,
                         java.lang.String newName,
                         java.lang.String deviceName,
                         UserCallback callback)

Перерегистрация пользователя на этом же устройстве.

Parameters:

parentActivity - Экземпляр Activity приложения, с которого будет запущено Activity из SDK. При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity. Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения, переданного при инициализации

user - Объект пользователя

newName - Новое имя ключа для использования внутри приложения (не передаётся на сервер). Если null, то будет использовано имя из объекта пользователя User

deviceName - Читаемое название устройства

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError

renew

public static void renew(User user,
                         java.lang.String newName,
                         java.lang.String deviceName,
                         UserCallback callback)

Перерегистрация пользователя на этом же устройстве.

Parameters:

user - Объект пользователя

newName - Новое имя ключа для использования внутри приложения (не передаётся на сервер). Если null, то будет использовано имя из объекта пользователя User

deviceName - Читаемое название устройства

callback - При успешном выполнении возвращает созданный объект пользователя User. Иначе возвращает ошибку типа Error или NetworkError