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

getAllTokens

getAllTokens()

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

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

getTokenInfo

getTokenInfo(int tokenDesc)

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

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

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-кода пользователя и его подтверждения.