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

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()

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

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

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().

Результат:

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

initTokenWithoutUserPIN

initTokenWithoutUserPIN(int tokenDesc, string adminPin, string label)

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

Аргументы:

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