Служебные функции

initialize

initialize()

Функция служит для инициализации работы с JC-WebClient. Необходимо вызывать её первой.

getAllTokens

getAllTokens()

Получить идентификаторы подключенных электронных ключей. Работает при любом состоянии аутентификации.

Результат:array – массив с идентификаторами.

getTokenInfo

getTokenInfo(int tokenDesc)

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

Аргументы:
  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens().
Результат:

array – массив со следующей структурой: первый элемент – серийный номер электронного ключа, второй – флаги электронного ключа, третий – метка электронного ключа.

getAllSlots

getAllSlots()

Получить идентификаторы всех слотов для работы с электронными ключами. Идентификаторы слотов заменяют идентификаторы токенов при вызове методов, поддерживающих работу с Антифрод-терминалом без вставленной смарт-карты. В других случаях, методы будут возращать ошибку CKR_TOKEN_NOT_PRESENT (к слоту не подключен электронный ключ) или работать как при использовании идентификатора токена (к слоту подключен электронный ключ). Работает при любом состоянии аутентификации.

Результат:array – массив с идентификаторами слотов.

getSlotInfo

getSlotInfo(int SlotId)

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

Аргументы:
  • SlotId – идентификатор слота. Получается с помощью метода getAllSlots().
Результат:

array – массив со следующей структурой:

  • первый элемент – серийный номер электронного ключа,
  • второй – флаги электронного ключа,
  • третий – метка электронного ключа.

getLoggedInState

getLoggedInState()

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

Результат:array – массив, где первый элемент – состояние аутентификации, второй – идентификатор подключения или ноль, если не установлено соединения, третий – идентификатор электронного ключа.

Состояния аутентификации

  • STATE_NOT_BINDED (0) – пользователь не предъявил PIN-код.
  • STATE_TOKEN_BINDED (1) – пользователь предъявил PIN-код.
  • STATE_SECURE_CHANNEL_CONNECTION_IN_PROGRESS (2) – начата установка защищенного канала.
  • STATE_SECURE_CHANNEL_ESTABLISHED (3) – защищенный канал установлен.
  • UNILATERAL_AUTHENTICATION_IN_PROGRESS (4) – начат процесс односторонней аутентификации.
  • UNILATERAL_AUTHENTICATION_COMPLETE (5) – односторонняя аутентификация успешно завершена.

getPluginVersion

getPluginVersion()

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

Результат:string – версия плагина в виде Х.Х.Х.Х.

checkWebBrowserVersion

checkWebBrowserVersion()

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

Результат:boolfalse если данная версия браузера не поддерживается.

initToken

initToken(int tokenDesc, string adminPin, string userPin, string label)

Инициализировать электронный ключ и установать PIN-код пользователя.

Аргументы:
  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens().
  • adminPin – текущий PIN-код администратора.
  • userPin – новый PIN-код пользователя.
  • label – новая метка изделия. Для сохранения текущей метки необходимо передать пустую строку.

initTokenUI

initTokenUI(int tokenDesc)

Инициализировать электронный ключ и установать PIN-код пользователя с использованием графического интерфейса плагина.

Примечание

Обратите внимание, что все поля в графической форме являются обязательными к заполнению.

Аргументы:
  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens().
Результат:

booltrue в случае успешного завершения операции, false в случае отмены операции или несовпадения PIN-кода пользователя и его подтверждения.

initTokenWithoutUserPIN

initTokenWithoutUserPIN(int tokenDesc, string adminPin, string label)

Инициализировать электронный ключ без установки PIN-кода пользователя.

Аргументы:
  • tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
  • adminPin – текущий PIN-код администратора.
  • label – новая метка изделия. Для сохранения текущей метки необходимо передать пустую строку.