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

bindToken

bindToken(int tokenDesc, string pin)

Предъявить PIN-код. После успешного выполнения состояние аутентификации переходит в STATE_TOKEN_BINDED (1). Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

bindTokenUI

bindTokenUI(int tokenDesc)

Предъявить PIN-код с использованием графического интерфейса плагина. После успешного выполнения состояние аутентификации переходит в STATE_TOKEN_BINDED (1). Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

Результат:

bool – false, если пользователь отменил ввод PIN-кода.

unbindToken

unbindToken()

Разорвать защищенный канал, если он установлен, и/или отменить предъявление PIN-кода. Необходимо вызывать при завершении сеанса работы с плагином. После успешного выполнения данного метода состояние аутентификации переходит в STATE_NOT_BINDED (0). Работает при состоянии аутентификации выше, чем STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

changePIN

changePIN(int tokenDesc, string userType, string oldPin, string newPin)

Изменить PIN-код пользователя или администратора электронного ключа. Работает при любом состоянии аутентификации для PIN-кода пользователя и STATE_NOT_BINDED (0) для PIN-кода администратора. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• userType –

  тип пользователя:

  • user – для смены PIN-кода пользователя.
  • admin – для смены PIN-кода администратора.
• oldPin – старый PIN-код.
• newPin – новый PIN-код.

changePINasync

changePINasync(int tokenDesc, string userType, string oldPin, string newPin, JSObjectPtr callback)

Изменить PIN-код пользователя или администратора электронного ключа, используя асинхронный механизм. Работает при любом состоянии аутентификации для PIN-кода пользователя и STATE_NOT_BINDED (0) для PIN-кода администратора. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• userType –

  тип пользователя:

  • user – для смены PIN-кода пользователя.
  • admin – для смены PIN-кода администратора.
• oldPin – старый PIN-код.
• newPin – новый PIN-код.
• callback – callback-функция JavaScript, которая будет выполнена после завершения работы метода.

changePINUI

changePINUI(int tokenDesc, string userType)

Изменить PIN-код пользователя или администратора электронного ключа с использованием графического интерфейса плагина. Работает при любом состоянии аутентификации для PIN-кода пользователя и STATE_NOT_BINDED (0) для PIN-кода администратора. Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

• tokenDesc – идентификатор электронного ключа. Получается с помощью метода getAllTokens(). Значение идентификатора электронного ключа не постоянно, но в рамках сессии не меняется.
• userType –

  тип пользователя:

  • user – для смены PIN-кода пользователя.
  • admin – для смены PIN-кода администратора.

Результат:

bool – false, если пользователь отменил смену PIN-кода.

initUserPIN

initUserPIN(int tokenDesc, string adminPin, string userPin)

Инициализировать PIN-код пользователя электронного ключа. Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

initUserPINUI

initUserPINUI(int tokenDesc)

Инициализировать PIN-код пользователя электронного ключа с использованием графического интерфейса плагина. Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

Результат:

bool – false, если пользователь отменил инициализацию PIN-кода.

unblockUserPIN

unblockUserPIN(int tokenDesc, string adminPin)

Разблокировать PIN-код пользователя электронного ключа. Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

unblockUserPINUI

unblockUserPINUI(int tokenDesc)

Разблокировать PIN-код пользователя электронного ключа с использованием графического интерфейса плагина. Работает только при состоянии аутентификации STATE_NOT_BINDED (0). Текущее состояние аутентификации получается с помощью метода getLoggedInState().

Аргументы:

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

Результат:

bool – false, если пользователь отменил разблокирование PIN-кода.