Примеры представлены в разделе Операции с PIN-кодами.

bindToken

Предъявить PIN-код. После успешного выполнения состояние аутентификации переходит в JCWebClient2.Vars.AuthState.binded.

Вводить PIN-код можно одним из способов (см. Способы ввода PIN-кода):

  • передав напрямую (аргумент pin);
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).

Работает при состоянии аутентификации JCWebClient2.Vars.AuthState.notBinded.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Примеры в разделе Предъявление PIN-кода.

Аргументы:

tokenID
Тип: Integer
Идентификатор токена. Получается с помощью команды getAllSlots.

Значение идентификатора не постоянно, но в рамках сессии не меняется.

secureMessaging (По умолчанию: false)
Тип: Boolean
Включить строгий сеанс.

Если установить в true при работе со смарт-картой, подключенной к Антифрод-терминалу, то будет сгенерировано исключение CKR_FUNCTION_NOT_SUPPORTED.

pin (Необязательный)
Тип: String
PIN-код.

useUI (По умолчанию: false)
Тип: Boolean
Признак использования графического интерфейса приложения JC-WebClient для ввода PIN.

Если равен true, то аргумент pin игнорируется.

antifraud [устаревшее] (Обязательный - для смарт-карты в Антифрод-терминале, в остальных случаях - Необязательный)
Тип: PlainObject
Параметры для ввода PIN с Антифрод-терминала.

Если указан, то аргументы useUI и pin игнорируются.

Параметры:

deviceID (Необязательный)
Тип: Integer
Идентификатор Антифрод-терминала, работающего без смарт-карты. Получаются с помощью команды getAllSlots.

Идентификатор игнорируется, если в tokenID передали идентификатор смарт-карты, подключенной к Антифрод-терминалу.

Значения идентификатора не постоянно, но в рамках сессии не меняется.

langID (По умолчанию: JCWebClient2.defaults().antifraud.langID)
Тип: Integer
Допустимые значения: JCWebClient2.Vars.AftLang
Идентификатор языка, используемого для отображения сообщений.

timeout (По умолчанию: JCWebClient2.defaults().antifraud.timeout)
Тип: Integer
Тайм-аут ожидания ввода от пользователя до отмены операции, в секундах.

changePIN

Изменить PIN-код пользователя на токене.

Вводить PIN-коды можно одним из способов (см. Способы ввода PIN-кода):

  • передав напрямую (аргументы oldPin и newPin);
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).

Работает при любом состоянии аутентификации.

Пример в разделе Смена PIN-кода пользователя/администратора.

Аргументы:

tokenID
Тип: Integer
Идентификатор токена. Получается с помощью команды getAllSlots.

Значение идентификатора не постоянно, но в рамках сессии не меняется.

oldPin (Необязательный)
Тип: String
Старый PIN-код.

newPin (Необязательный)
Тип: String
Новый PIN-код.

useUI (По умолчанию: false)
Тип: Boolean
Признак использования графического интерфейса приложения JC-WebClient.

Если равен true, то аргументы oldPin и newPin игнорируются.

antifraud [устаревшее] (Обязательный - для смарт-карты в Антифрод-терминале, в остальных случаях - Необязательный)
Тип: PlainObject
Параметры для ввода PIN с Антифрод-терминала.

Если указан, то аргументы useUI, oldPin и newPin игнорируются.

Параметры:

deviceID (Необязательный)
Тип: Integer
Идентификатор Антифрод-терминала, работающего без смарт-карты. Получаются с помощью команды getAllSlots.

Идентификатор игнорируется, если в tokenID передали идентификатор смарт-карты, подключенной к Антифрод-терминалу.

Значения идентификатора не постоянно, но в рамках сессии не меняется.

langID (По умолчанию: JCWebClient2.defaults().antifraud.langID)
Тип: Integer
Допустимые значения: JCWebClient2.Vars.AftLang
Идентификатор языка, используемого для отображения сообщений.

timeout (По умолчанию: JCWebClient2.defaults().antifraud.timeout)
Тип: Integer
Тайм-аут ожидания ввода от пользователя до отмены операции, в секундах.

confirmRequired
Тип: Boolean
Признак повторного ввода PIN-кода для подтверждения.

unblockUserPIN

Разблокировать PIN-код пользователя на токене.

Вводить PUK-код или PIN-код администратора можно одним из способов (см. Способы ввода PIN-кода):

  • передав напрямую (аргументы pukCode или adminPin );
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).

Работает при состоянии аутентификации JCWebClient2.Vars.AuthState.notBinded.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Пример в разделе Разблокировка PIN-кода пользователя.

Аргументы:

tokenID
Тип: Integer
Идентификатор токена. Получается с помощью команды getAllSlots.

Значение идентификатора не постоянно, но в рамках сессии не меняется.

pukCode (Необязательный)
Тип: String
PUK-код.

Если указан, то аргументы adminPin и response игнорируются.

adminPin (Необязательный)
Тип: String
PIN-код администратора.

Только для версии токена 2.5.13 и выше.

Определение версии токена описано здесь:  Версии токена GOST 2

Если указан, то аргумент response игнорируется.

response (Необязательный)

Тип: Array
Последовательность администратора в ответ на запрос на разблокировку.

useUI (По умолчанию: false)
Тип: Boolean
Признак использования графического интерфейса приложения JC-WebClient.

Если равен true, то аргументы pukCode и response игнорируются.

antifraud [устаревшее] (Обязательный - для смарт-карты в Антифрод-терминале, в остальных случаях - Необязательный)
Тип: PlainObject
Параметры для ввода PIN с Антифрод-терминала.

Если указан, то аргументы useUI, pukCode и response игнорируются.

Параметры:

deviceID (Необязательный)
Тип: Integer
Идентификатор Антифрод-терминала, работающего без смарт-карты. Получаются с помощью команды getAllSlots.

Идентификатор игнорируется, если в tokenID передали идентификатор смарт-карты, подключенной к Антифрод-терминалу.

Значения идентификатора не постоянно, но в рамках сессии не меняется.

langID (По умолчанию: JCWebClient2.defaults().antifraud.langID)
Тип: Integer
Допустимые значения: JCWebClient2.Vars.AftLang
Идентификатор языка, используемого для отображения сообщений.

timeout (По умолчанию: JCWebClient2.defaults().antifraud.timeout)
Тип: Integer
Тайм-аут ожидания ввода от пользователя до отмены операции, в секундах.

setSignaturePIN

Установка PIN-кода подписи.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Пример в разделе Установка PIN-кода подписи.

Аргументы:

useUI (По умолчанию: false)
Тип: Boolean
Признак использования графического интерфейса приложения JC-WebClient.

Если равен true, то аргумент pin игнорируется.

pin (Необязательный)
Тип: String
PIN-код подписи.

changeSignaturePIN

Смена PIN-кода подписи.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Пример в разделе Смена PIN-кода подписи.

Аргументы:

useUI (По умолчанию: false)
Тип: Boolean
Признак использования графического интерфейса приложения JC-WebClient.

Если равен true, то аргументы oldPin и newPin игнорируется.

oldPin (Необязательный)
Тип: String
Старый PIN-код подписи.

newPin (Необязательный)
Тип: String
Новый PIN-код подписи.

createUnblockChallenge

Создать запрос на разблокировку PIN-кода пользователя в рамках алгоритма “запрос-ответ” (challenge-response).
Смена PIN-кода подписи.

Работает при любом состоянии аутентификации.

Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Аргументы:

tokenID
Тип: Integer
Идентификатор на токене. Получается с помощью команды getAllSlots

Значение идентификатора не постоянно, но в рамках сессии не меняется.

Результат:

PlainObject – объект с параметрами:

serialNumber
Тип: String
Серийный номер токена.

unlockCount
Тип: String
Кол-во успешных разблокировок в шестнадцатеричном формате.