Работа с PIN-кодами

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

bindToken

GOST
PRO
PKI
STORAGE
bindToken

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

Вводить PIN-код можно одним из способов (см. Способы ввода PIN-кода):
  • передав напрямую (аргумент pin);
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).
Работает при состоянии аутентификации JCWebClient2.Vars.AuthState.notBinded.
Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.
Примеры в разделе Предъявление PIN-кода.
Аргументы:
tokenID
Тип: Integer
Идентификатор токена. Получается с помощью команды getAllSlots.

Примечание

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

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
Тайм-аут ожидания ввода от пользователя до отмены операции, в секундах.

unbindToken

GOST
PRO
GOST 2
PKI
STORAGE
unbindToken
Разорвать защищенный канал, если он установлен, и/или отменить предъявление PIN-кода. После успешного выполнения данной команды состояние аутентификации переходит в JCWebClient2.Vars.AuthState.notBinded.
Необходимо вызывать при завершении сеанса работы с приложением JC-WebClient.
Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded.
Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

changePIN

GOST
PRO
PKI
STORAGE
changePIN
Изменить PIN-код пользователя или администратора на токене.
Вводить PIN-коды можно одним из способов (см. Способы ввода PIN-кода):
  • передав напрямую (аргументы oldPin и newPin);
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).
Работает при любом состоянии аутентификации для PIN-кода пользователя и JCWebClient2.Vars.AuthState.notBinded для PIN-кода администратора.
Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.
Аргументы:
tokenID
Тип: Integer
Идентификатор токена. Получается с помощью команды getAllSlots.

Примечание

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

userType (По-умолчанию: JCWebClient2.Vars.UserType.user)
Тип: String
Допустимые значения: JCWebClient2.Vars.UserType
Тип пользователя.
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-кода для подтверждения.

initUserPIN

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

unblockUserPIN

GOST
PRO
PKI
STORAGE
unblockUserPIN

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

Вводить PIN-код администратора можно одним из способов (см. Способы ввода PIN-кода):
  • передав напрямую (аргументы adminPin);
  • используя графический интерфейс приложения JC-WebClient (аргумент useUI);
  • используя Антифрод-терминал (аргумент antifraud).
Работает при состоянии аутентификации JCWebClient2.Vars.AuthState.notBinded.
Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.
Аргументы:
tokenID
Тип: Integer
Идентификатор на токене. Получается с помощью команды getAllSlots.

Примечание

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

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

Примечание

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

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

Примечание

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

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

Примечание

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

Примечание

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

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