Служебные

USB-токены и смарт-карты JaCartaAPI и SDKUSB-токены и смарт-карты JaCarta

getAllSlots

Получить идентификаторы всех слотов с дополнительной информацией об объектах, расположенных на них.

В качестве объектов могут выступать:

• токены (криптографические приложения), загруженные в устройства (USB-токены, смарт-карты);
• Антифрод-терминал без подключенной смарт-карты.

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

Результат: Array — массив из объектов с параметрами:

id

• Тип: Integer
• Описание: Идентификатор слота.

tokenExists

• Тип: Boolean
• Описание: Признак наличия токена на слоте.

device

• Тип: PlainObject
• Описание: Объект с информацией об устройстве.

Параметры:

name

• Тип: String
• Описание: Наименование устройства.

model

• Тип: String
• Описание: Модель устройства.

serialNumber

• Тип: String
• Описание: Серийный номер устройства.

formFactor

• Тип: String
• Допустимые значения: JCWebClient2.Vars.FormFactor
• Описание: Форм-фактор.

modelFriendlyName

• Тип: String
• Описание: Модель устройства (коммерческое название).

manufactureDate

• Тип: Integer
• Описание: Дата производства устройства (в секундах начиная с 01.01.1970).

reader (Необязательный)

• Тип: PlainObject
• Описание: Объект с информацией о ридере. Возвращается только если на слоте обнаружена смарт-карта в ридере (в том числе в Антифрод-терминале) или Антифрод-терминал без вставленной смарт-карты.

Параметры:

type

• Тип: String
• Допустимые значения: JCWebClient2.Vars.ReaderType
• Описание: Тип ридера.

cardlessSupported (Необязательный) [устаревшее]

• Тип: Boolean
• Описание: Признак поддержки ридером бескарточного режима. Параметр существует только для Антифрод-терминала.

getSlotInfo

Получить информацию об объекте, расположенном на указанном слоте.

В качестве объекта могут выступать:

• токены (криптографические приложения), загруженные в устройства (USB-токены, смарт-карты);
• Антифрод-терминал без подключенной смарт-карты.

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

Аргументы:

slotID

• Тип: Integer
• Описание: Идентификатор слота. Получается с помощью команды getAllSlots. Значение идентификатора не постоянно, но в рамках сессии не меняется.

Результат: PlainObject — объект с параметрами:

tokenExists

• Тип: Boolean
• Описание: Признак наличия токена на слоте.

device

• Тип: PlainObject
• Описание: Объект с информацией об устройстве.

Параметры:

name

• Тип: String
• Описание: Наименование устройства.

model

• Тип: String
• Описание: Модель устройства.

serialNumber

• Тип: String
• Описание: Серийный номер устройства.

formFactor

• Тип: String
• Допустимые значения: JCWebClient2.Vars.FormFactor
• Описание: Форм-фактор.

modelFriendlyName

• Тип: String
• Описание: Модель устройства (коммерческое название).

manufactureDate

• Тип: Integer
• Описание: Дата производства устройства (в секундах начиная с 01.01.1970).

reader (Необязательный)

• Тип: PlainObject
• Описание: Объект с информацией о ридере. Возвращается только если на слоте обнаружена смарт-карта в ридере (в том числе в Антифрод-терминале) или Антифрод-терминал без вставленной смарт-карты.

Параметры:

type

• Тип: String
• Допустимые значения: JCWebClient2.Vars.ReaderType
• Описание: Тип ридера.

cardlessSupported (Необязательный) [устаревшее]

• Тип: Boolean
• Описание: Признак поддержки ридером бескарточного режима. Параметр существует только для Антифрод-терминала.

getTokenInfo

Для GOST2, PKI, STORAGE.

Получить информацию о токене.

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

Аргументы:

tokenID

• Тип: Integer
• Описание: Идентификатор токена. Получается с помощью команды getAllSlots. Значение идентификатора не постоянно, но в рамках сессии не меняется.

Результат: PlainObject — объект с параметрами:

serialNumber

• Тип: String
• Описание: Серийный номер токена.

flags

• Тип: PlainObject
• Описание: Установленные флаги на токене. Структура объекта: Флаги токена.

label

• Тип: String
• Описание: Метка токена.

type

• Тип: String
• Допустимые значения: JCWebClient2.Vars.TokenType
• Описание: Тип токена.

totalMemory

• Тип: Integer
• Описание: Общий размер памяти. Если недоступно — 0.

freeMemory

• Тип: Integer
• Описание: Размер свободной памяти. Если недоступно — 0.

getLoggedInState

Получить состояние аутентификации.

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

Результат: PlainObject — объект с параметрами:

state

• Тип: Integer
• Допустимые значения: JCWebClient2.Vars.AuthState
• Описание: Состояние аутентификации.

connectionID

• Тип: Integer
• Описание: Идентификатор подключения или 0, если не установлено соединение.

tokenID

• Тип: Integer
• Описание: Идентификатор токена.

getJCWebClientVersion

Получить версию приложения.

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

Результат: String — версия в виде Х.Х.Х.XXXХ.

initToken

Для PKI, STORAGE.

Инициализировать токен с возможностью установки PIN-кода пользователя.

clearToken

Для GOST 2.

Удалить все объекты с токена.